Troubleshooting - beqare/RustTube GitHub Wiki

Troubleshooting

This page lists common RustTube issues and how to fix them.

Installer Does Not Start

Possible causes:

  • SmartScreen warning
  • damaged download
  • blocked file from the browser

Things to try:

  • download the installer again
  • right-click the installer, open Properties, and check whether Windows shows an Unblock option
  • run the installer again

Tool Download Fails

If RustTube cannot download yt-dlp, ffmpeg, or deno:

  • check your internet connection
  • make sure GitHub and the FFmpeg download source are reachable
  • try again later
  • check the log output inside RustTube

You can also use the tool sidebar to retry downloads manually.

Download Buttons Stay Disabled

Possible reasons:

  • required tools are still missing
  • a tool download is currently running
  • no valid target folder is selected
  • no URL is entered

Check:

  • the tool sidebar
  • the selected target folder
  • the URL field
  • the current app status message

Preview Does Not Load

Possible causes:

  • unsupported URL
  • network issue
  • missing required tool support
  • website-side changes

Things to try:

  • check whether the link works in a browser
  • try a different supported URL
  • make sure required tools are installed
  • check the app log for errors

MP3 or Video Conversion Fails

Possible causes:

  • ffmpeg is missing
  • ffprobe is missing
  • download source changed behavior
  • post-processing failed

Fixes:

  • make sure the ffmpeg tool entry is installed
  • retry the download
  • check the output log for specific error messages

Cancel Does Not Work As Expected

RustTube tries to stop the active download process and its related child processes.

If cancel feels delayed:

  • wait a moment after clicking Cancel
  • check the log and status text
  • make sure the process is not already in a final stage

App Shows Path or Access Errors

This usually means one of these:

  • the selected target folder is invalid
  • the app cannot write to the selected location
  • a file is locked by another process

Fixes:

  • choose a different target folder
  • make sure you have write access
  • close applications that may be using the same file

GitHub Release Upload Fails

Possible causes:

  • GitHub CLI is not installed
  • GitHub CLI is not logged in
  • repository permissions are missing
  • internet connection issue

Check this first:

  • run build option 0 to check GitHub CLI
  • run gh auth status
  • verify that you are authenticated to the correct account

Inno Setup Compiler Not Found

If installer builds fail because Inno Setup is missing:

  • install Inno Setup 6
  • make sure ISCC.exe exists
  • rerun the build script

RustTube tries to detect common Inno Setup install paths automatically.

Version Bump Fails

If the build script cannot update the version in Cargo.toml:

  • make sure the version uses normal semantic versioning
  • example: 1.2.3
  • check that the version = "..." entry exists in the [package] section

Log Is the Best Source of Details

If something fails and the cause is unclear, always check the live output log inside RustTube first.

That is usually the fastest way to understand:

  • tool download errors
  • yt-dlp extraction problems
  • ffmpeg conversion issues
  • unsupported URLs