YTSage v5.5.6
If you want to support the project, please consider sponsoring on GitHub Sponsors or buying a coffee on Buy Me a Coffee, or for direct bank transfer / SWIFT: Contact me via email at oop7_support@proton.me
Install via PyPI:
pip install ytsageUpgrade to the latest version:
pip install --upgrade ytsage
Downloads
| Platform | File | Notes |
|---|---|---|
| YTSage-v5.5.6-ffmpeg-Setup.exe | With FFmpeg bundled | |
| YTSage-v5.5.6-Setup.exe | Standard installer | |
| YTSage-v5.5.6-ffmpeg-portable.zip | Portable with FFmpeg, zipped | |
| YTSage-v5.5.6-portable.zip | Portable version, no installation required | |
| YTSage-v5.5.6-amd64.deb | Debian package | |
| YTSage-v5.5.6-x86_64.AppImage | AppImage, portable | |
| YTSage-v5.5.6-x86_64.flatpak | Flatpak Bundle | |
| YTSage-v5.5.6-x86_64.rpm | RPM package | |
| YTSage-v5.5.6-arm64.dmg | Disk image installer for Apple Silicon | |
| YTSage-v5.5.6-arm64.app.zip | Zipped application for Apple Silicon | |
| ytsage-5.5.6-py3-none-any.whl | Python Wheel | |
| ytsage-5.5.6.tar.gz | Source Distribution |
Special thanks to @bastik-1001 and @dj23me for being the first and major donors supporting this project ❤️
✨ Features
-
Preferred Subtitle Format: Users can now set their preferred subtitle format (e.g., SRT, VTT) in the settings. YTSage will automatically download subtitles in that format when available. You can find this in the download settings under the format tab. (#102 - Thanks to @avtandil33)
-
Reset All Settings: A button has been added to Download Settings. One click restores every YTSage setting back to its default value, with a confirmation prompt so you don't reset by accident
-
Download History Toggle: You can now choose whether YTSage keeps a record of your past downloads. Head to Download Settings → General → Download History to enable or disable history tracking. When disabled, no download entries are saved
( #152, Thanks to (@AlphaDeFcOn4))
🔧 Improvements
-
Installer Localization: Added Persian and Korean language support to the setup wizard.
-
Windows Installer Upgrades: Improved the installers so upgrades work flawlessly:
- Installed the app as a stable
YTSage.exe - Installed FFmpeg builds as a stable
YTSage-ffmpeg.exe - Ignored extra
.exefiles in the build folder - Old versioned executables are now automatically deleted during upgrades
- Installed the app as a stable
-
Sponsor Button: Changed the action of the "Sponsor" button in the About dialog to open the README file on the Sponsor page instead of the GitHub Sponsors page.
-
Private Video Errors: Added a clearer error message when attempting to analyze a private video without providing the correct cookies file or when using a blocked proxy/VPN.
-
Faster FFmpeg Downloads: FFmpeg component downloads now use parallel byte-range requests (up to 16 simultaneous connections)
-
Windows Installer (Clean Upgrades): Upgrading between versions on Windows now properly removes stale executables (YTSage.exe, ffmpeg.exe, ffprobe.exe, old FFmpeg bundles) so leftover files no longer cause conflicts
🐛 Bug Fixes
- Audio Track Languages: Resolved an issue where the application would incorrectly tag all audio tracks as English, even when they were in different languages. (#146 - Thanks to @bastik-1001)
- Dailymotion Formatting: Fixed a bug where the application would incorrectly report "No format available" for certain Dailymotion videos. (#148 - Thanks to @AlphaDeFcOn4)
- NoneType Error: Resolved an issue where the application would throw an
argument of type 'NoneType' is not iterableerror. (#109 - Thanks to @jasonleejc2011-afk) - Bilibili Analysis Hang: Fixed an issue where the application would freeze indefinitely at "Updating format table" while analyzing Bilibili videos. (#151 - Thanks to @imagebuilder1837)
- yt-dlp Meta Table Error: Resolved a failure resulting in a
no such table: metaerror when processing Bilibili videos. (#127 - Thanks to @2008hsx) - handle unavailable videos when fetching playlist formats: Previously, if a playlist contained videos that were unavailable (e.g., deleted or private), YTSage would fail to fetch the formats for the entire playlist. This has been fixed so that unavailable videos are skipped, and available videos are processed normally (#92, Thanks to (@oflodac))
📖 Documentation & README
- Interactive demo video added to the README and all 16 translated READMEs
- Installation section restructured to put the easiest method (pre-built app download) front and center, with Python/PyPI and source-code instructions clearly separated for advanced users
- Apple Silicon note added for macOS users, clarifying that installers are built natively for M1/M2/M3/M4 and Intel Macs should use the pip method
- FFmpeg auto-setup tip highlighted for Windows pip installs.
- Sponsor section updated, now includes Buy Me a Coffee and direct bank transfer / SWIFT options alongside GitHub Sponsors
- "Back to Top" navigation links added throughout the README for easier browsing
- Usage instructions refreshed across all translations to reflect the latest UI labels and the new multi-audio workflow