MediaFetch 1.1.0
MediaFetch 1.1.0 significantly improves the yt-dlp download workflow, especially for playlists and long-running media downloads.
Highlights
Improved yt-dlp playlist handling
Completed playlist items are now imported into Nextcloud immediately after yt-dlp finishes post-processing them.
This means that MediaFetch no longer needs to wait for an entire playlist to finish before already completed tracks become available in Nextcloud.
The download flow is now roughly:
Download → ffmpeg/post-processing → Adding to Nextcloud… → ✅
Completed items are moved to the existing Complete Downloads history, while failed items appear under Failed Downloads.
Better download status and history
yt-dlp downloads are now integrated more consistently with the existing aria2 download views.
- completed yt-dlp items appear under Complete Downloads
- failed playlist items appear under Failed Downloads
- extractor errors are retained where possible
- completed items briefly show a ✅ state before leaving the live queue
- the yt-dlp Downloads view now focuses on active/importing jobs
Cancel and reset controls
MediaFetch now provides additional controls for managing stuck or unwanted downloads.
- running yt-dlp downloads can be cancelled
- active aria2/HTTP/magnet downloads can be cancelled in addition to being paused
- a new Stop all downloads & reset action stops the current user's active download queue
- failed download history can be cleared by the reset action
- completed history is preserved
The reset handling also supports privileged VPN wrapper setups where yt-dlp enters another network namespace before dropping back to the www-data user.
Safer Nextcloud imports
yt-dlp downloads now use a private staging directory before being imported through Nextcloud's public Files API.
The default workspace is:
/var/tmp/mediafetch
Administrators can override this using the mediafetch app setting work_directory.
Already existing destination filenames are skipped instead of creating duplicate files such as (1), (2), (3) and so on.
Additional fixes
- removed the deprecated yt-dlp
--prefer-ffmpegoption - fixed playlist entries getting stuck at “Adding to Nextcloud…”
- improved matching between completed files and their playlist entries
- preserved successfully imported tracks when later playlist entries fail
- corrected a remaining legacy
ncdownloaderaria2 route - improved handling of completed and failed download counters
Compatibility
- Nextcloud 32–34
- PHP 8.2–8.4
- yt-dlp
- aria2
- ffmpeg recommended for audio/video post-processing
MediaFetch is based on the original NCDownloader project and continues its AGPL-licensed codebase.
Thanks to everyone testing MediaFetch and reporting issues.