A powerful Google Colab-based tool for downloading media from multiple sources directly to Google Drive with automatic Plex-friendly organization.
- Multi-Source Downloads: Gofile, Pixeldrain, Mega.nz, YouTube, Twitch, Vimeo, and more
- 35+ Premium Hosts via Real-Debrid: MediaFire, 1fichier, Rapidgator, Nitroflare, etc.
- Parallel Downloads: Download up to 5 files concurrently for Gofile, Pixeldrain, Real-Debrid, and direct HTTP links
- Session Resume: Automatically resume interrupted downloads after runtime restart
- Queue Management: Preview, reorder, sort (A-Z/Z-A), and select which files to download
- Download History: Persistent log of completed downloads for debugging
- Real-Debrid Integration: Unrestrict premium links and process magnet links
- Magnet File Selection: Preview individual torrent files and choose which to download
- Smart Media Sorting: Automatically organises into Plex-compatible folder structures
- TV Shows:
Show Name/Season XX/Show Name - S01E01.mkv - Movies:
Movie Name/Movie Name.mkv
- TV Shows:
- Archive Extraction: Handles RAR, ZIP, 7Z with sequential extraction to save Colab disk space
- Subtitle Preservation: Keeps
.srt,.ass,.sub,.vttfiles regardless of size - Duplicate Prevention: Skips already-downloaded files across sessions
- Progress Tracking: Real-time progress bar with speed display
Google Colab is a free cloud-based Python environment that runs in your browser β no installation needed.
- Go to colab.research.google.com
- Click New Notebook (or File β New notebook)
- Paste this one-liner into a cell:
import requests; exec(requests.get("https://raw.githubusercontent.com/xersbtt/ultimate-downloader-colab/main/ultimate_downloader.py").text)Run the cell and the UI will appear automatically.
Want to review the code first? Open
ultimate_downloader.py, copy the entire contents, and paste directly into a Colab cell.
Option A: Manual Entry
Click βοΈ Settings and enter your Gofile/Real-Debrid tokens in the API Key fields.
Option B: Colab Secrets (Recommended)
Store your keys securely in Colab Secrets:
- Click the π key icon in Colab's left sidebar
- Add secrets named
GOFILE_TOKENandRD_TOKEN - Keys will auto-populate on each run
Enter your download links in the text area (one per line):
https://gofile.io/d/abc123
https://pixeldrain.com/u/xyz789
magnet:?xt=urn:btih:...
https://www.youtube.com/playlist?list=...
Option A: Resolve Links (Recommended for playlists or batches)
- Click Resolve Links to preview the queue
- Review detected files, adjust naming/organisation if needed
- Click Start Download to begin
Option B: Quick Download (Fastest for single videos)
- Click Quick Download to start immediately
- Skips the queue preview β downloads begin right away
- Enable subtitles via βοΈ Settings β "Include subtitles in quick downloads"
Files are automatically organised and saved to your Google Drive.
| Field | Description |
|---|---|
| Auto-organise | Toggle automatic file renaming and organisation (uncheck to save with original filenames to Downloads) |
| Name | Override auto-detected name for folder/filename (works for both TV shows and movies) |
| Year | Append (YYYY) to folder name for movies and TV shows (file name unchanged) |
| Movies/TV | Anime | Toggle between regular folders (Movies, TV Shows) and anime folders (Anime Movies, Anime Series) |
| Category | Force Movie or Series classification (Auto: detect from filename) |
| Parallel DLs | Number of concurrent downloads (1-5, applies to Gofile/Pixeldrain/RD/HTTP) |
Default locations (customizable via βοΈ Settings):
My Drive/TV Shows/- Files with detected episode patterns (S01E01, Ep 1, 第5ι, etc.)My Drive/Movies/- Files without episode patternsMy Drive/YouTube/- YouTube downloads without episode patternsMy Drive/Anime Series/- TV shows when Anime mode is enabledMy Drive/Anime Movies/- Movies when Anime mode is enabledMy Drive/Downloads/- All files when Auto-organise is disabled (original filenames)My Drive/Ultimate Downloader/- Config files (session.json, history.json, settings.json)
API Keys: Gofile and Real-Debrid tokens are configured in βοΈ Settings. For security, use Colab Secrets (see Quick Start).
Quick Download Subtitles: Enable "Include subtitles in quick downloads" in βοΈ Settings to automatically fetch subtitles when using the Quick Download button.
Customizing Download Directories:
- Click βοΈ Settings in the main UI
- Edit the path fields for TV Shows, Movies, or YouTube (paths relative to Drive root)
- Or click π to browse your Drive folders with the folder picker:
- Navigate with β¬οΈ Up and π Open
- Create new folders with β Create
- Select with β Select
- Settings auto-save and persist across sessions
| Source | Features | Download Mode |
|---|---|---|
| Gofile | Public/private folders, cookie auth | Parallel |
| Pixeldrain | Direct file downloads | Parallel |
| Real-Debrid | Link unrestricting, file selection from magnets | Parallel (cached) / Sequential (uncached) |
| Direct HTTP | Any direct download URL | Parallel |
| Mega.nz | Full download support | Sequential |
| YouTube | Videos, playlists, subtitles | Sequential |
| Twitch | VODs and clips | Sequential |
| Vimeo | Video downloads | Sequential |
| Archive.org | Videos, audio, documents (no DRM) | Sequential |
| TikTok | Video downloads | Sequential |
| Dailymotion | Video downloads | Sequential |
| SoundCloud | Audio downloads | Sequential |
The downloader recognises these naming patterns:
| Pattern | Example | Result |
|---|---|---|
| Standard | Show.Name.S01E05.mkv |
Season 01, Episode 05 |
| Asian Drama | Drama EP01.mkv |
Season 01, Episode 01 |
| Chinese | η΅θ§ε§ 第5ι.mkv |
Season 01, Episode 05 |
| Japanese | γ’γ㑠第10θ©±.mkv |
Season 01, Episode 10 |
| Vietnamese | Phim TαΊp 3.mkv |
Season 01, Episode 03 |
| Korean | λλΌλ§ 5ν.mkv |
Season 01, Episode 05 |
| German | Serie Folge 2.mkv |
Season 01, Episode 02 |
| Spanish | Serie Capitulo 4.mkv |
Season 01, Episode 04 |
| Portuguese | Serie Episodio 8.mkv |
Season 01, Episode 08 |
| Fansub Bracket | [Group] Show - 01 [1080p].mkv |
Season 01, Episode 01 |
| Underscore-Dash | Show_Name_-_03_(480p).mkv |
Season 01, Episode 03 |
| High Episode | One Piece - 1042 [1080p].mkv |
Season 01, Episode 1042 |
| Pipe/Dash | Show Name | 7.mkv |
Season 01, Episode 07 |
| Asian Multi-Part | Movie δΈη―.mkv |
Adds -pt1 suffix |
Tip: When using "Show Name" override with playlists, the playlist position (1, 2, 3...) will be used as the episode number if no pattern matches.
The auto-organise feature works well for ~95% of standard naming conventions, but some edge cases require manual overrides:
| Edge Case | Issue | Workaround |
|---|---|---|
| Numbers in movie title | 21 Jump Street detected as Episode 21 |
Set Category to "Movie" |
| "Part X" in movie title | Movie Part 2 may detect as Episode 2 |
Set Category to "Movie" |
| No episode pattern | Random_Video_Name.mkv detected as Movie |
Set Category to "Series" + use Name field |
| Unusual separator | Show.Name.01.Title.mkv (no dash) |
Use Name field to set show name |
| Decimal episodes | Show - 01.5 [OVA].mkv |
Detected as Episode 1 (decimal ignored) |
| Season in title | Show Season 2 - 01.mkv |
Season not extracted; files go to Season 01 |
Best Practices:
- For consistent batch naming (e.g., fansub releases), auto-detect is very accurate
- For mixed or unusual filenames, use Name + Category overrides before downloading
- For movies with sequel numbers (
Toy Story 3), auto-detect works if year is present (2010) - If unsure about a filename, set the Name and Category fields to guarantee correct organization
β οΈ Warning: Cookie authentication is experimental and may cause issues.
For Premium quality or members-only content:
- Export
cookies.txtfrom your browser (using a cookies.txt extension) - Click βοΈ Settings β π€ Upload Cookies
- Select your cookies file
Known Issues:
- Cookies may trigger "Requested format is not available" errors
- Session expiry or IP mismatch can cause authentication failures
- Fix: Click ποΈ Clear Cookies in Settings to remove problematic cookies
When YouTube videos are detected in the Queue Preview, you can select which subtitle languages to download:
- Default: English + Vietnamese
- Available: 12 languages (en, vi, zh, ja, ko, th, id, es, fr, de, pt, ru)
- Works for both video downloads and subtitles-only mode
Playlist Range: Also appears in Queue Preview when a YouTube playlist is detected. Use 1,3,5-10 syntax to select specific videos.
| Button | Action |
|---|---|
| Resolve Links | Parse links and show Queue Preview for review |
| Quick Download | Download immediately without queue preview (respects auto-organise settings) |
| Start Download | (In Queue) Download videos and organise to Drive |
| Download Subtitles | (In Queue) Fetch subtitles from YouTube/streaming sources only. Non-streaming links (Gofile, Mega, etc.) in mixed batches will still download normally. |
| Resume Previous Session | Resume interrupted session (appears when session exists) |
| π Restart Runtime | Restart Colab runtime (appears after failures for easy resume) |
| π (History) | View last 10 downloads from history log |
| βοΈ (Settings) | Configure download directories, manage cookies, Quick Download subtitle options, clear data files |
| Issue | Solution |
|---|---|
| "Gofile Error: error-notFound" | Link expired or requires authentication |
| "RD Timeout" | Torrent not cached, try a different magnet |
| "Mega Error" | Link invalid or requires login |
| Files not detected as TV | Use "Show Name" override field |
| YouTube videos skipping | Clear YT archive via βοΈ Settings |
| "Requested format is not available" | yt-dlp auto-updates on each run. If persists, clear cookies via βοΈ Settings |
Why use this instead of local download tools?
Colab provides free cloud compute with high-speed bandwidth, so downloads go directly to Google Drive without using your local internet or storage. Great for large files, slow connections, or when you want files ready on Drive for streaming to other devices.
I already have Real-Debrid β why not just use Stremio?
Stremio is for streaming; this is for downloading. Use this when you want to:
- Build a permanent media library on Drive
- Download for offline access or archival
- Grab YouTube playlists, Mega links, or other sources Stremio doesn't support
- Organise downloads into Plex-friendly folder structures automatically
Isn't this just a wrapper for yt-dlp/aria2?
Yes and no. It orchestrates multiple tools (yt-dlp, aria2, megatools, unrar) under one UI, but adds significant value:
- Unified interface for 35+ sources including premium hosts via Real-Debrid
- Automatic Plex-compatible organization (Show/Season/Episode structure)
- Parallel downloads with session resume across Colab restarts
- Queue management with preview, reordering, and selective downloads
- Persistent history and duplicate prevention across sessions
Is it safe to run code from a URL?
The code is fully open-source β you can review it on GitHub or paste it directly into Colab instead of using the one-liner. Nothing is hidden.
Why did my downloads stop after a few hours?
Colab has a ~12 hour runtime limit (less if idle). If interrupted, just run the script again and click Resume Previous Session β your progress is saved to Drive.
Is there a storage limit?
Colab's temp disk is ~100GB, but downloads transfer directly to Google Drive, so you're only limited by your Drive quota (15GB free, more with Google One).
Do I need a Google account?
Yes β Google Colab and Google Drive both require a Google account.
Is Real-Debrid required?
No. Many sources work without it: YouTube, Mega.nz, Gofile, Pixeldrain, Vimeo, Twitch, and direct HTTP links. Real-Debrid unlocks 35+ premium file hosts.
How do I get API tokens?
- Gofile: Log in at gofile.io, go to My Profile β Account Token
- Real-Debrid: Log in at real-debrid.com, go to My Devices
Can I run this locally instead of Colab?
Not directly β the UI uses Colab-specific widgets (ipywidgets for Colab). However, the underlying tools (yt-dlp, aria2) work locally if you want to adapt it.
Can I use this on mobile?
Yes! Colab works in mobile browsers. The UI is functional on phones/tablets, though a larger screen is more comfortable.
Ultimate Downloader/
βββ ultimate_downloader.py # Latest version (always current)
βββ ultimate_downloader_v5.2.py # Current versioned snapshot
βββ Ultimate_Downloader.ipynb # Jupyter notebook launcher
βββ Ultimate Downloader.url # Windows shortcut to Colab
βββ CHANGELOG.md # Version history
βββ README.md # This file
βββ LICENSE # MIT Licence
βββ banner_2x1.png # GitHub banner image
βββ .gitignore # Git ignore rules
βββ archive/ # Previous versions (v4.34 and earlier)
This project is licensed under the MIT License.
- β Free to use, modify, and distribute
- β Commercial use allowed
- β Just include the copyright notice
Built with: