Skip to content

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 More -> Settings -> Updating 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:

  1. Update yt-dlp.
  2. Use cookies from a logged in account.
  3. Change the player client or set up PO tokens.
  4. Install a JS runtime from Packages.
  5. Change your network, or turn off your VPN.

The download is stuck in the queue and doesn't start ​

  • If Download over metered networks is off and you are on mobile data, the download waits for an unmetered connection.
  • If Download on schedule is on, it will wait for the allowed time.
  • If Download delay is set, there is a wait between downloads.
  • Check that the number of Concurrent downloads is 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 More -> Settings -> General. 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 first in More -> Settings -> Folders.
  • Enable Restrict filenames if 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 More -> Settings -> Processing.

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 fragments in More -> Settings -> Downloads.
  • Try aria2c as the downloader.
  • Check that Limit rate isn'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 More -> Settings -> Downloads, or tap Continue anyway.

App ​

Change the Data fetching extractor (YouTube) to yt-dlp in More -> Settings -> General.

Enable Display over apps in More -> Settings -> General. 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 header in More -> Settings -> Advanced.
  • 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 More -> Settings -> Folders ➔ Temporary files to see how much space is used and clear it. Also enable Clean-up leftover downloads in More -> Settings -> Downloads.

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.