REST API wrapper for IDLIX movie/series downloader. Download movies from IDLIX with subtitle embedding support.
Permission granted by original author sandrocods
| Feature | Description |
|---|---|
| 🎬 Featured Movies | Get list of featured movies from homepage |
| 📺 Video Info | Get video metadata (title, poster, ID) |
| 🔗 Streaming URL | Get M3U8 streaming URL with quality options |
| 📥 Download | Download video with auto subtitle embedding |
| 🔐 API Key Auth | Secure endpoints with API key authentication |
| 🔄 Auto URL Detection | Automatically detect active IDLIX domain |
git clone https://github.com/dewhush/Idlix-Downloader cd Idlix-Downloaderpip install -r requirements.txt# Copy example config cp .env.example .env # Edit .env and set your API_KEY.env configuration:
APP_NAME=Idlix-Downloader-API APP_ENV=development API_KEY=your-secret-api-keyWindows: Download from ffmpeg.org and add to PATH.
Linux:
sudo apt install ffmpegrun_api.batpython -m uvicorn api:app --host 0.0.0.0 --port 8000 --reloadThe API will be available at http://localhost:8000
- Swagger UI: http://localhost:8000/docs
- ReDoc: http://localhost:8000/redoc
All endpoints (except /health) require API key authentication.
Header:
X-API-Key: your-api-key GET /health No authentication required.
Response:
{ "status": "healthy", "timestamp": "2025-01-17T01:45:00" }GET /status Headers: X-API-Key: your-api-key
Response:
{ "app_name": "Idlix-Downloader-API", "environment": "development", "uptime_seconds": 3600.5, "active_idlix_url": "https://tv12.idlixku.com/", "version": "1.0.0" }GET /v1/featured Headers: X-API-Key: your-api-key
Response:
{ "status": true, "count": 10, "movies": [ { "url": "https://tv12.idlixku.com/movie/example/", "title": "Example Movie", "year": "2024", "type": "movie", "poster": "https://..." } ] }POST /v1/video-info Headers: X-API-Key: your-api-key
Request Body:
{ "url": "https://tv12.idlixku.com/movie/example/" }Response:
{ "status": true, "video_id": "12345", "video_name": "Example Movie", "poster": "https://..." }POST /v1/get-stream Headers: X-API-Key: your-api-key
Request Body:
{ "url": "https://tv12.idlixku.com/movie/example/", "quality_id": "0" }Response:
{ "status": true, "m3u8_url": "https://jeniusplay.com/.../master.m3u8", "qualities": [ {"id": "0", "resolution": "1920x1080", "bandwidth": 5000000}, {"id": "1", "resolution": "1280x720", "bandwidth": 2500000} ], "has_multiple_qualities": true, "subtitle_url": "https://..." }POST /v1/download Headers: X-API-Key: your-api-key
Request Body:
{ "url": "https://tv12.idlixku.com/movie/example/", "quality_id": "0", "embed_subtitle": true }Response:
{ "status": true, "file_path": "/path/to/Example Movie.mp4", "file_name": "Example Movie.mp4", "message": "Download completed successfully" }Idlix-Downloader/ ├── api.py # FastAPI app & routes ├── idlix_service.py # Core scraping logic ├── src/ │ └── CryptoJsAesHelper.py ├── requirements.txt ├── .env.example ├── run_api.bat ├── .gitignore └── README.md This project is created for educational purposes only. Any misuse is the user's responsibility.
Created by: dewhush
Original Author: sandrocods
Created by dewhush