YTSage v5.6.0

YTSage v5.6.0

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 ytsage

Upgrade to the latest version:

pip install --upgrade ytsage 

Downloads

Platform	File	Notes
	YTSage-v5.6.0-ffmpeg-Setup.exe	With FFmpeg bundled
	YTSage-v5.6.0-Setup.exe	Standard installer
	YTSage-v5.6.0-ffmpeg-portable.zip	Portable with FFmpeg, zipped
	YTSage-v5.6.0-portable.zip	Portable version, no installation required
	YTSage-v5.6.0-amd64.deb	Debian package
	YTSage-v5.6.0-x86_64.AppImage	AppImage, portable
	YTSage-v5.6.0-x86_64.flatpak	Flatpak Bundle
	YTSage-v5.6.0-x86_64.rpm	RPM package
	YTSage-v5.6.0-arm64.dmg	Disk image installer for Apple Silicon
	YTSage-v5.6.0-arm64.app.zip	Zipped application for Apple Silicon
	ytsage-5.6.0-py3-none-any.whl	Python Wheel
	ytsage-5.6.0.tar.gz	Source Distribution

✨ Features

• Docker Support: You can now run YTSage inside a Docker container and access the full desktop application directly from any web browser without needing to install Python, Qt, or FFmpeg on your host machine (#3, Thanks to (@ohhai-kthxbai))

  • Browser Access: Stream the desktop GUI in high-frame-rate HTML5/WebRTC via KasmVNC at http://localhost:3000 (or HTTPS on port 3001).
  • Batteries Included: Pre-configured with bundled dependencies including FFmpeg, yt-dlp, and Deno.
  • Persistent Volumes: Save media to host ./downloads and application data/history to ./config.

• Settings Export & Import: You can now export your YTSage settings to a JSON file and import them later, making it easy to transfer your configuration between installations or share with others (Download Settings → File)

• Download queue: Configure multiple downloads and run them together. New "Add to queue" and "Queue" buttons let you stage jobs instead of downloading immediately.

  • Queued downloads run sequentially, each using the exact settings selected when it was added.
  • The queue is saved between application launches.
  • Failed or cancelled jobs stay in the queue and can be retried.
  • The queue dialog supports reviewing, removing, and clearing finished jobs.
  • See the Usage section in the README for details (#107, thanks @avtandil33).

• Audio format conversion for video downloads: Audio format conversion now applies to videos, not just audio-only downloads. The selected video stream is copied without re-encoding while the audio track is converted to your preferred format (AAC, MP3, FLAC, WAV, Opus, Vorbis, M4A) (#145, thanks @AmandaClarke65).

• Reverse order for playlists: Added the option to list playlists in reverse order (#155, thanks @christubuntu).

🔧 Improvements

• Firefox as Default: Firefox is now the default recommended browser for extracting login cookies, improving success rates for private videos.
• Red glow effect and custom styling added to the main Download button.
• The queue's Start queue button now shares the same glow styling.
• Secondary buttons (custom options, about, history, time range, settings, and queue) are now disabled and hidden while a video is processing, preventing conflicting actions and making the UI cleaner during downloads.
• i18n: Added missing translation keys, including reset_all, to all supported language files.
• Added a note in the cookies dialog if Chrome/Brave cookies extraction doesn't work (#104, thanks to @Seryi3).

🐛 Bug Fixes

• Deno Versioning: Replace static GitHub "latest" release URLs with versioned build URLs from the official Deno release CDN (#154, Thanks to (@LuckCircles))
• Fixed an unnecessary horizontal scrollbar at the bottom of the playlist selection dialog.
• History: Fixed potential thread crash on history dialog close with robust loader thread interruption
• Downloads: Fixed race condition in download thread initialization that prevented proper control state management during download start

📖 Documentation

• Added Docker setup and lifecycle documentation in docker/README.md and main project instructions
• Updated configuration documentation covering the new settings import/export features
• Added a Download Queue usage guide to the README.
• Clarified the audio format conversion docs to reflect that it applies to both audio-only and video downloads.
• Documentation: Updated README translations with new features, improved language labels, added Korean and Persian language support (now 16 languages), added Telegram channel link, Docker setup guide, and macOS Apple Silicon notes

⚙️ CI/CD Improvements

• PyPI Build: Hardened and refactored PyPI build workflow with improved validation
• macOS DMG Build: Pinned GitHub Actions to specific commit hashes and simplified build process
• Workflow Security: Added semantic version validation to CI workflows
• Windows Build: Hardened build workflow with version validation, pinned Actions versions, and improved FFmpeg setup detection