Social Saver Logo
Documentation

Solving Download Problems

If Social Saver isn't working as expected, check these common solutions. If you still need help, please look for answers or ask on the GitHub Issues page .

Problem: Download Failed / Shows Error

This is common. Try these steps first:

  1. Check the Link: Copy the full web address (URL) again carefully. Does it work in your browser's private/incognito mode? If login is needed, see the Cookies Guide.
  2. Check Internet: Can you browse other websites?
  3. Update Engine (Very Important!): Websites change, breaking downloaders. Go to Settings → Binaries in Social Saver, click "Check for Updates", then click "Update to Stable" if available. Try downloading again. (See Updating Guide).
    Updating the download engine in Social Saver Settings
    Update the engine in Settings → Binaries.
  4. Try Different Quality: The specific format you chose might be broken on the site. Try selecting a different resolution or file type.
  5. Check Logs (If Comfortable): For complex errors, turn on "Verbose Logging" in Settings → Advanced, retry the download, then check the app's log files for detailed error messages from `yt-dlp`. Remember to turn verbose logging OFF afterward.

Problem: Can't Download from a Specific Site

  1. Update Engine First! (See step 3 above). This fixes most site issues.
  2. Need to Log In? Use the Cookies Guide.
  3. Is Site Supported? Check the yt-dlp supported sites list .
  4. Report It: If you updated and it should work, report the problem on GitHub . Include the website link!

Problem: Downloaded Video Has No Sound

  • Check Download Type: Did you choose "Audio Only" or mute the audio (🔇 icon) with "Video + Audio"? Try again using "Combined" or ensure the speaker icon (🔊) is active for "Video + Audio".
  • Video-Only Format Issue?: Some high-res formats (like 4K on YouTube) are video-only streams. You *must* use the "Video + Audio" download type for these, so Social Saver can merge the separate audio.
  • Try VLC Player: Play the file in VLC Media Player. If sound works there, your file is likely okay, but your default player might need updating.

Problem: Installing or Starting the App

  • Windows: Did you download from the official site? Try "Run as administrator". Check antivirus.
  • macOS: Drag to Applications? Right-click → Open first time? Check Security settings?
  • Linux: AppImage executable (`chmod +x`)? Deb dependencies (`sudo apt --fix-broken install`)?

Problem: App is Slow or Unresponsive

  • High CPU Use: Downloading/merging takes computer power. Lower `Max Concurrent Downloads` in "Settings → Downloads". Close other heavy apps.
  • Large Playlists: Loading thousands of items takes time. Be patient.
  • Restart: Close Social Saver completely and reopen it.

Still Need Help?