Download fails or URL is not supported
- Confirm the link works in your browser and the site is supported by yt-dlp.
- Update ROSI to the latest release; yt-dlp is bundled and updated with the app.
- Try a different format or quality preset if one option errors out.
- Check the in-app log or error message for a yt-dlp exit code.
Site requires sign-in or age verification
Some sites need cookies from your browser. Enable Hook into Web Browser in Settings, pick a supported browser, and follow the Browser Cookies guide.
Download is slow or stuck
- Large files and live streams can take time; watch the queue for progress.
- Pause other heavy network activity on your connection.
- Restart the download if it has been idle with no progress for several minutes.
YouTube downloads need Deno
On Windows, macOS, and Linux AppImage builds, ROSI uses Deno for full YouTube support. If ROSI shows a Deno prompt, install Deno from the official instructions. On Windows and macOS, ROSI can also install it with winget or Homebrew when available. On Linux, use your package manager or the official instructions. The Flatpak build includes its own JavaScript runtime and does not need Deno.
Updating from ROSI 4
ROSI 4.4.0 and later offer an in-app upgrade to ROSI 5. If the upgrade does not finish, ROSI 4 stays installed and your settings are unchanged. ROSI explains what happened the next time it opens. To try again, choose Settings > Check for Updates. To install ROSI 5 without the in-app upgrade, download it from the downloads page or GitHub releases, then launch it once to import your ROSI 4 settings, queue, lifetime stats, and download activity. Your ROSI 4 data folder is kept.
Updates
ROSI 5 checks GitHub for updates and can install them in the app. Open Settings and use the Channel control to choose Auto, Stable, or Beta. Microsoft Store builds update through the Store. Flatpak builds check for updates but cannot install them in the app; download the latest bundle from the release page and reinstall it.
If an in-app update fails, download the latest installer from the downloads page or GitHub releases.
Linux users who installed ROSI 4 from a DEB or RPM package need to switch to the AppImage or Flatpak. DEB and RPM packages are no longer published for ROSI 5, and Linux ARM64 is not supported in version 5.
Still stuck?
See the ROSI FAQ, Getting Started guide, or contact support with your ROSI version, platform, and the URL you tried (if you can share it).