Common issues
Facing issues with a source or the app? Here's how to tackle common challenges.
Downloads
Every download fails with an extractor error / "Unable to extract"
yt-dlp is outdated. Go to -> -> and update yt-dlp. If it is still failing, switch the channel to Nightly or Master. In some countries yt-dlp doesn't update automatically, so do it manually.
"Sign in to confirm you're not a bot" or HTTP 403 on YouTube
YouTube blocked the request. Try, in this order:
- Update yt-dlp.
- Use cookies from a logged in account.
- Change the player client or set up PO tokens.
- Install a JS runtime from Packages.
- Change your network, or turn off your VPN.
The download is stuck in the queue and doesn't start
- If
Download over metered networksis off and you are on mobile data, the download waits for an unmetered connection. - If
Download on scheduleis on, it will wait for the allowed time. - If
Download delayis set, there is a wait between downloads. - Check that the number of
Concurrent downloadsis not taken by other items.
Downloads stop when I close the app or turn the screen off
Disable battery optimization for the app, using Ignore battery optimization in -> -> . Some manufacturers (Xiaomi, Huawei, Samsung, OnePlus and others) have extra aggressive background restrictions. Look for your device on dontkillmyapp.com to see how to allow the app to stay running.
The download fails at the end, or the file is missing
- The app might not be able to write to the chosen folder. Choose another folder, or enable
Cache downloads firstin -> -> . - Enable
Restrict filenamesif the title has strange characters. - Check there is enough free space on the device.
"ffmpeg" errors, merging or converting fails
Try the other FFmpeg version in Packages. Very new versions might not run on some devices, and very old ones don't support some codecs.
The video downloaded has no audio, or the audio is in the wrong language
Select the audio format yourself in the format sheet of the Download Card. Check that Remove audio is off, and set Preferred audio language in -> -> .
Subtitles are not embedded
Embedding automatic subtitles needs Save automatic subtitles and Embed subtitles together. Also check that the languages you chose actually exist for the video. See Subtitle Languages.
I can't get more than 128kbps audio on YouTube Music
You need a YouTube Premium account with cookies. See the FAQ.
Cutting / cropping is greyed out or doesn't work
The item has to have its data fetched first. If you used Don't fetch data tap the update button in the card. Cutting is not available for all kinds of items such as some live streams. Cropping VP9 and AV1 needs FFmpeg 7.1.1 or higher from Packages.
The download is too slow
- Increase
Concurrent fragmentsin -> -> . - Try
aria2cas the downloader. - Check that
Limit rateisn't set. - Some websites throttle downloads. Update yt-dlp, it often has fixes for that.
Duplicate warnings for something I want to download again
Change or disable Prevent duplicate downloads in -> -> , or tap Continue anyway.
App
The app crashes when I search
Change the Data fetching extractor (YouTube) to yt-dlp in -> -> .
The download card doesn't show up when sharing a link
Enable Display over apps in -> -> . Also check that Show download card is enabled.
The share sheet doesn't list YTDLnis
Some apps only share text, some share links as files. Copy the link and paste it in the app, or use the clipboard button in Home.
Notifications are not showing
Allow notifications for the app in the Android settings. On some devices you also have to allow the app in the battery manager.
Observe sources don't run at the right time
See Making it reliable.
Cookies don't work
- Turn on
Use cookies. - Create the cookie again, and enable
User-Agent headerin -> -> . - On YouTube, accounts logged in from a browser rotate their cookies. Log in with a secondary account if it keeps expiring.
I lost my history / settings after reinstalling
Backups are not automatic unless you enabled Automatic backup. Restore your last one in the settings. See Backups.
The app takes a lot of storage
Open -> -> ➔ Temporary files to see how much space is used and clear it. Also enable Clean-up leftover downloads in -> -> .
I installed an update and now the app doesn't open
Reinstalling the app might help. Only do it after you have made a backup, as uninstalling removes the app data. Install the new version over the existing one and don't uninstall it first, as long as the signature is the same.