YTSage v5.0.10b

YTSage 5.0.10b - Beta Release

Please report any issues you encounter on the GitHub Issues page.

Downloads

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

✨ Features

• Enhanced "Save Playlist As" functionality: Exported .txt and .csv files now include the video index and duration (e.g., 1. Video Name [05:20]), matching the Select Videos UI. #97 thanks to (@avtandil33)

🔧 Improvements

• Smart Filename Templates: The app now automatically cleans up playlist-specific variables (like %(playlist_index)s) from filenames when downloading single videos, preventing "NA" prefixes. #96 thanks to (@avtandil33)

🐛 Bug Fixes

• Fixed Subtitle Selection logic: The app now only downloads auto-generated subtitles if they are explicitly selected, preventing unwanted caption files.
• Fixed a UI issue where the selected subtitle counter would incorrectly reset to "0" after an analysis despite default languages being auto-selected. #95 thanks to (@avtandil33)

YTSage v5.0.9b

YTSage 5.0.9b - Beta Release

Please report any issues you encounter on the GitHub Issues page.

Downloads

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

✨ Features

• Added "Remember cookie settings on next startup" option in Custom Options > Login with Cookies to persist login cookies across sessions. #93 thanks to (@avtandil33)

🔧 Improvements

• Handled private video edge cases gracefully by showing a user-friendly error dialog directing them to use the Custom Options cookie settings instead of raw yt-dlp technical errors.

🐛 Bug Fixes

• Fixed an issue in playlist mode where selecting the highest quality often caused subsequent videos to fail or download in low quality. The application now dynamically determines the best available format for each individual video in the playlist up to the specified resolution. #86 thanks to (@j1aaar)

YTSage v5.0.7b

YTSage 5.0.7b - Beta Release

Please report any issues you encounter on the GitHub Issues page.

Downloads

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

✨ Features

• Export Playlists: Added a "Save Playlist As" button to export playlist contents to .txt, .csv, .m3u, or .json.
• Default Preferences: Added new options in Download Settings to set a "Default Video Resolution" and "Default Subtitle Languages".
• Filename Variables: Added support for %(playlist_index)s in the output filename format.

🔧 Improvements

• Auto-Selection: The application now automatically checks the correct video quality and subtitles in the format table based on your configured default settings.

• Localization: Added missing localization keys to prevent console warnings and ensure all UI text is properly translated.

🐛 Bug Fixes

• Fixed a bug where saving the download path could erase other user settings.

• Fixed a rendering crash that prevented the Download History dialog from opening if previous downloads were missing file size information.

• Fixed missing localization keys that caused console warnings and missing UI text.

• Fixed playlist download overwrites: Updated the default filename format to include a unique video ID: %(title)s_%(resolution)s_[%(id)s].%(ext)s. This ensures every downloaded video gets a unique filename, preventing accidental overwrites and data loss when downloading playlists with identical titles #90 thankks to [@j1aaar] for reporting the issue.

💡 Note for current users: You can apply this fix immediately by going to Settings and clicking "Reset" next to the filename format, or by manually adding [%(id)s] to your custom template.

credits to #89 [@avtandil33] for feature suggestions and bug reports

YTSage v5.0.5b

YTSage 5.0.5b - Beta Release

Please report any issues you encounter on the GitHub Issues page.

Downloads

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

🔧 Improvements

fix(ui): clarify maximum quality constraint for playlists

• Added '≤' prefix to quality and resolution labels in playlist mode
  to indicate it acts as a ceiling rather than an exact match for all videos.
• Fixed resolution string extraction logic from the format table
  during download initialization (resolves hardcoded 'default' value).

Resolves #86, thanks to (@j1aaar).

🐛 Bug Fixes

• Fixed an issue where the application assigned a wrong quality label to the vertical videos.

YTSage v5.0.4b

YTSage 5.0.4b - Beta Release

Please report any issues you encounter on the GitHub Issues page.

Install via PyPI:

pip install ytsage

Upgrade to the latest version:

pip install --upgrade ytsage

Downloads

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

🚀 New Features

• Concurrent Connections: Boost download speeds by downloading multiple video fragments concurrently (resolves #87) thanks to (@iShoaibMughal) Configurable via Download Settings.

🔧 Improvements

• Implemented safe defaults for concurrent connections (default: 1) to prevent HTTP 429 Too Many Requests errors or IP blocks across platforms.
• Added full UI localization for the new Concurrent Connections setup across all 14 supported languages.
• Updated main and translated README files to detail the new multithreaded download feature.

🐛 Bug Fixes

• Fixed an issue where the user interface remained locked and grayed out after cancelling a download due to missing signals.

YTSage v5.0.3

YTSage 5.0.3

Install via PyPI:

pip install ytsage

Upgrade to the latest version:

pip install --upgrade ytsage

Downloads

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

🚀 New Features

• Added Generic Mode to support downloads from non-YouTube sites supported by yt-dlp #78 thanks to (@WoodyBABL)
• Added a new Download Settings toggle for Generic Mode.
• Added sponsor visibility in the app and docs to make project support easier.
• Audio Normalization (EBU R128): Added a new feature to standardize the volume of audio-only downloads using FFmpeg's loudnorm filter.
• In-App Update Checking: Added a new Check for YTSage updates setting natively into the UI.

🔧 Improvements

• Added README documentation for using Generic Mode with non-YouTube URLs.
• Reorganized the README usage documentation by splitting the former Advanced Options section into separate sections for media/download, output settings, access/network, and maintenance tools.
• Added localized Generic Mode strings across all shipped language files.
• Updated the URL placeholder text dynamically based on the selected validation mode.
• Refactor Download settings dialog into tabs and restyle.
• Added intuitive smart-toggling to the Download Settings UI (enabling audio normalization now intelligently forces an audio re-encode).
• Added comprehensive documentation and translated feature strings for the new Audio Normalization feature across all 13 supported languages.
• Added updated usage docs and strictly fixed the markdown table alignments in translated READMEs.
• Various layout fixes and localization key updates for seamless update-checking settings.

🐛 Bug Fixes

• Fixed a crash in the format table when third-party extractors returned null values such as format_note.
• Hardened format table handling for nullable metadata like bitrate, resolution, extension, and codec fields.
• Applied Generic Mode validation consistently to both analysis and download flows.

YTSage v5.0.2b

YTSage 5.0.2b - Beta Release

Please report any issues you encounter on the GitHub Issues page.

Downloads

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

🚀 New Features

• Audio Normalization (EBU R128): Added a new feature to standardize the volume of audio-only downloads using FFmpeg's loudnorm filter.
• In-App Update Checking: Added a new Check for YTSage updates setting natively into the UI.

🔧 Improvements

• Refactor Download settings dialog into tabs and restyle.
• Added intuitive smart-toggling to the Download Settings UI (enabling audio normalization now intelligently forces an audio re-encode).
• Added comprehensive documentation and translated feature strings for the new Audio Normalization feature across all 13 supported languages.
• Added updated usage docs and strictly fixed the markdown table alignments in translated READMEs.
• Various layout fixes and localization key updates for seamless update-checking settings.

YTSage v5.0.1b

YTSage 5.0.1b - Beta Release

Please report any issues you encounter on the GitHub Issues page.

Downloads

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

🚀 New Features

• Added Generic Mode to support downloads from non-YouTube sites supported by yt-dlp #78 thanks to (@WoodyBABL)
• Added a new Download Settings toggle for Generic Mode.
• Added sponsor visibility in the app and docs to make project support easier.

🔧 Improvements

• Added README documentation for using Generic Mode with non-YouTube URLs.
• Reorganized the README usage documentation by splitting the former Advanced Options section into separate sections for media/download, output settings, access/network, and maintenance tools.
• Added localized Generic Mode strings across all shipped language files.
• Updated the URL placeholder text dynamically based on the selected validation mode.

🐛 Bug Fixes

• Fixed a crash in the format table when third-party extractors returned null values such as format_note.
• Hardened format table handling for nullable metadata like bitrate, resolution, extension, and codec fields.
• Applied Generic Mode validation consistently to both analysis and download flows.

YTSage v5.0.0

YTSage 5.0.0 - Major Release

Install via PyPI:

pip install ytsage

Upgrade to the latest version:

pip install --upgrade ytsage

Downloads

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

💖 Sponsor

Finally, a GitHub sponsor on repositories is a great way to support the project and help fund future development.
Added a sponsor link to the About dialog. If you like the project and want to support development, consider sponsoring!

🚀 New Features

• Linux Flatpak Support: Added a .flatpak bundle for broader Linux compatibility (Fedora, Steam Deck, etc.) (#4, thanks to @imbev).
• Sandbox Compatibility: YTSage now respects YTDLP_APP_BIN_PATH and DENO_APP_BIN_PATH environment variables on Linux, allowing dependencies to update correctly in read-only environments.
• Searchable Playlist Selection: Added a search bar and duration display to the playlist selection dialog, making it much easier to find specific videos in large playlists.
• Background History Loading: The history dialog now loads entries and thumbnails in the background, ensuring instant UI responsiveness even with hundreds of downloaded items.
• Language Synchronization: The windows installer now automatically sets the application's language based on the language selected during setup. The preference is saved directly to ytsage_config.json in the local app data folder.
• Automated Release Script: Added build_release.py to automate production builds (cleanup, wheel build, README handling) and standardize the release flow.
• Modern Packaging: Migrated dependency and build configuration to pyproject.toml, removed requirements.txt, and added MANIFEST.in to ensure assets and language files are packaged.
• Package Layout Consolidation: Renamed the top-level package from src to ytsage and moved main.py into ytsage/, simplifying module imports and enabling python -m ytsage.main usage.
• Background History & Thumbnails: Introduced a virtualized history view with an SQLite backend, persistent DB connection, and asynchronous thumbnail downloads to keep the UI responsive on large histories.
• Animated UI Enhancements:
  • Window Blurring: Implemented a sophisticated modal dialog flow using blurred screenshots as overlays, providing a better focus on dialogs like "About," "History," and "Settings."
  • Smooth Transitions: Added SmoothTabWidget with fade-in/fade-out transitions between tabs and cross-fade animations for status messages and control buttons.
  • Dynamic Elements: Introduced a "shake" animation for invalid input validation and smooth fade-in effects for video thumbnails and the format table.
• Deno Integration Detection: Added a background system information thread to detect yt-dlp's Deno integration. The About Dialog now displays a "+ yt-dlp" indicator when integration is active.
• Real-time Deno Updates: Rewrote the Deno upgrade process to stream stdout in real-time to a dedicated GUI progress window.
• Improved Analysis Feedback: Added progress signals and a simulated progress timer to provide smoother visual feedback during long-running URL extractions.
• Automated Windows Installers: The build process now automatically generates Setup installers (.exe) alongside portable ZIPs.
• Beta Update System: Introduced an opt-in beta update feature. Users can now receive notifications for preview releases by enabling the "Receive Beta Updates" option in the updater settings.
• Log Management: Added a new "Logs" button in the About dialog to quickly open the application logs folder.
• Expanded Localization: Initial support for Chinese (Simplified), Hindi, and Indonesian in the Windows installer and application metadata.
• Sponsor Link: Added a Sponsor link to the About dialog.

🔧 Improvements

• Release Triggers: Moved to manual release triggers (workflow_dispatch) for better version control.
• CI Orchestration: Added release-all workflow to orchestrate multi-platform builds.
• Faster Playlist Analysis: Refactored the analysis engine to use flat-playlist extraction, significantly reducing the time required to load large playlists. Only the first video is fully analyzed initially to populate the UI immediately.
• Localization: Added translations for the new "Analyzing... Fetching formats for first video" status message across all 14 supported languages.
• Build Workflows & CI: Updated Windows, macOS and Linux CI workflows to install from pyproject.toml (PEP 517), adjusted cx_Freeze entry points and asset paths, and clarified artifact naming.
• README & Docs: Refreshed documentation and CI/CD notes to show the new layout, packaging steps, and how to run via python -m ytsage.main.
• Assets & Localization: Reorganized branding and asset folders (branding/, ytsage/assets) and moved language JSON files to ytsage/languages for packaging and discoverability.
• Localization Coverage: Added and expanded translation keys (multiple languages) and localized dialogs, log messages, and FFmpeg/yt-dlp setup strings.
• Update Checks: Sped up update checks using parallel network requests and non-blocking background threads, plus improved fallbacks and timeouts.
• Format Table & UI Performance: Built the format table once and used visibility toggles for filtering; centralized file-extension constants to reduce duplication.
• Audio Playback: Replaced pyglet with PySide6.QtMultimedia for notification playback and updated build steps accordingly.
• Progress Feedback: Added smooth QPropertyAnimation for progress updates and increased progress precision to 0.01% (range 0–10000) for finer progress reporting.
• Standardized UI Status Messages: Cleaned up and simplified status messages across all 14 supported languages, removing progress percentages in favor of concise action-oriented text.
• Aggressive Build Optimization:
  • Cross-Platform Distributions: Significantly reduced bundle sizes by pruning unused Qt modules (Web, Pdf, Qml, Quick), PDB debug files, and extra translations for Windows, Linux, and macOS.
  • Optimized Bytecode: Switched to python -OO for all builds to ensure faster startup and execution.
• Revamped CI & Packaging:
  • Windows: Improved PowerShell cleanup scripts to handle duplicate Qt DLLs robustly.
  • Linux: Shifted to a manual AppImage build process to ensure a cleaner layout and fix "encodings" mo...

YTSage v5.0.0b5

YTSage 5.0.0b5 - Beta Release

Please report any issues you encounter on the GitHub Issues page.

Downloads

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

🚀 New Features

• Beta Update System: Introduced an opt-in beta update feature. Users can now receive notifications for preview releases by enabling the "Receive Beta Updates" option in the updater settings.
• Log Management: Added a new "Logs" button in the About dialog to quickly open the application logs folder.
• Expanded Localization: Initial support for Chinese (Simplified), Hindi, and Indonesian in the Windows installer and application metadata.

🐛 Bug Fixes

• UI Rendering: Removed the 🔄 emoji from the System Info loading message to resolve potential rendering issues on certain systems.

🔧 Improvements

• About/System Info:
  • Refined the "System Info" loading text style (updated color to #888888 and removed italics for better readability).
  • Updated version refresh icons and localized "Open Logs" tooltips across all 14 supported languages.
• Diagnostics & Reporting:
  • Simplified the GitHub Bug Report template to leverage the new one-click log access.
• Workflow:
  • Implemented a automated PyPI build workflow (build-pypi.yml) to generate Python Wheel and Source distributions.
  • Integrated PyPI artifact generation into the master release pipeline.
• Update Logic: Optimised the update thread to prioritize GitHub Beta releases when opted-in, preventing version conflicts with PyPI releases.