Skip to documentation

Type to search guides and sections.

    Press Ctrl/Cmd + K to search · Esc to close

    User documentation

    Downloads and offline viewing

    Save video or audio, manage the queue, and find your downloaded files.

    The download comparison covers FreeTube and OpenTubeX.

    Set up downloads

    1. Open Settings → Downloads and turn on Enable Downloads if needed.
    2. Choose a Download Folder you can write to and that has enough free space.
    3. On desktop, allow time for any required managed tools to download. OpenTubeX uses yt-dlp and FFmpeg for download tasks; tool options depend on your platform.
    Downloads settings showing Enable Downloads, Download Folder, concurrent downloads, and bandwidth limit.

    Select the folder icon in Download Folder to choose where files are saved.

    The mobile apps use their own storage pickers and download implementations. Grant access to your chosen folder when prompted; desktop executable paths and the choice of system-installed tools do not apply there.

    Download a video or audio

    1. Open a video or its menu and select Download Video.
    2. In the download dialog, choose the offered format and quality, or an audio-only option when you want sound without video.
    3. Confirm the download.
    4. Open Downloads from the top bar or profile menu to see progress and queued items.

    Downloads need a working connection until they finish. Higher-quality video usually uses more storage. Subtitles can be downloaded when offered for the selected video.

    Download from another site

    1. Open Downloads and select Add download. If downloads are unavailable, check Settings → Downloads → Enable Downloads.
    2. Paste the full media page URL into URL and select Next.
    3. Choose the video or audio download options, confirm, and follow progress in Downloads.
    Add download dialog with a Vimeo media URL entered and a Next button.

    Paste the media page URL in Downloads → Add download, then select Next.

    You can also open the link in the player first and select Download Video below it.

    Available formats depend on the site and yt-dlp. A supported playback link does not guarantee every download format will work. On iOS, compatible external-site downloads offer Play download inside OpenTubeX. On desktop, open the saved file with a compatible media player; use Show in Folder to find it.

    Play a completed download

    1. Open Downloads and find a completed item.
    2. Choose Play download to watch the saved media.
    3. On desktop, use Show in Folder to locate the file in your file manager.

    Keep the file in its saved location if you want OpenTubeX to find it again. Clearing an entry from the list and permanently deleting its file are different actions; read the confirmation before removing media.

    Download a playlist

    Open a playlist’s menu and choose Download Playlist when available. Review the download options before starting: a large playlist can use significant space. The Downloads panel shows the queued work.

    Manage a failed download

    1. Open Downloads and read the item’s error.
    2. Check your connection, free space, and access to the download folder.
    3. On desktop, check managed tool updates under Settings → Advanced → External Software if the error mentions yt-dlp or FFmpeg.
    4. Use Retry download after fixing the cause.

    If the video itself will not play, start with playback troubleshooting. Include the download error and platform when reporting a bug.

    Next: SponsorBlock and other add-ons →