From c4c3e18b1b6e4bf2265548b7f2f9d589f3e2c8e3 Mon Sep 17 00:00:00 2001 From: oop7 <110548351+oop7@users.noreply.github.com> Date: Thu, 12 Mar 2026 15:53:16 +0200 Subject: [PATCH] Document Generic Mode and add Sponsor section Update README to document the new Optional Generic Mode: add a feature note, usage steps, troubleshooting notes (yt-dlp dependency, cookies/proxies), and a mention in Advanced Options and the features table. Also add a Sponsor anchor, nav link, and badge to the top navigation and About references. (Documentation-only changes) --- README.md | 38 ++++++++++++++++++++++++++++++++++++-- 1 file changed, 36 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 8998cc6..df0b62c 100644 --- a/README.md +++ b/README.md @@ -21,6 +21,7 @@ Download videos in any quality, extract audio, fetch subtitles, and more. Usage • Screenshots • Troubleshooting • + Sponsor • Contributing

@@ -36,6 +37,7 @@ YTSage is designed for users who want a **simple yet powerful YouTube downloader - A clean, modern PySide6 interface - One-click downloads for video, audio, and subtitles - Advanced features like SponsorBlock, subtitle merging, and playlist selection +- Optional Generic Mode for yt-dlp-supported sites beyond YouTube - Cross-platform support and easy installation @@ -46,13 +48,13 @@ YTSage is designed for users who want a **simple yet powerful YouTube downloader | Core Features | Advanced Features | Extra Features | |-----------------------------------|-----------------------------------------|------------------------------------| | 🎥 Format Table | 🚫 SponsorBlock Integration | 🎞️ FPS/HDR Display | -| 🎵 Audio Extraction | 📝 Multi-Subtitle Select & Merge | 🔄 Auto-Update yt-dlp | +| 🎵 Audio Extraction | 📝 Multi-Subtitle Select & Merge | 🔄 Auto-Update yt-dlp | | ✨ Simple UI | 💾 Save Description & Thumbnail | 🛠️ FFmpeg/yt-dlp/Deno Detection | | 📋 Playlist Support & Selector | 🚀 Speed Limiter | ⚙️ Custom Commands | | 📑 Embed Chapters | ✂️ Trim Video Sections | 🍪 Login with Cookies | | 📜 Download History | 🔄 Release Channel Selection | 🌐 Proxy Support | | 🎚️ Audio Format Conversion | 🎬 Video Format Settings | 🆙 Built-in Updater Tab | - +| 🌍 Generic Mode || 🌍 Localization in 14 Languages | | @@ -247,6 +249,27 @@ python -m ytsage.main +
+🌍 Generic Mode for non-YouTube sites + +Use Generic Mode when you want YTSage to accept URLs from sites supported by yt-dlp, such as Dailymotion, CBC Gem, TikTok, and others. + +How to use it: + +1. Open `Download Settings`. +2. Enable `Generic Mode`. +3. Paste a supported non-YouTube video or playlist URL. +4. Click `Analyze`. +5. Choose a format and download as usual. + +Notes: + +- Generic Mode only changes URL validation inside YTSage. The target site must still be supported by your installed yt-dlp version. +- Some sites require cookies, a login session, a proxy, or extra yt-dlp arguments depending on the extractor. +- If a site fails, update yt-dlp first from the built-in updater tab before reporting the issue. + +
+
🧰 Advanced Options @@ -277,6 +300,7 @@ python -m ytsage.main - **Proxy Support:** Use a proxy server for downloads (e.g., `http://:`) - **Force Output Format:** Force video downloads in a specific container format (e.g., `mp4`, `webm`, `mkv`). Available in **Download Settings → Output Format Settings**. - **Audio Format Conversion:** Convert audio-only downloads to preferred formats (`AAC`, `MP3`, `FLAC`, `WAV`, `Opus`, `M4A`, `Vorbis`, or `Best`). Ideal for video editing software like DaVinci Resolve. Available in **Download Settings → Audio Format Settings**. +- **Generic Mode:** Allow YTSage to analyze and download from non-YouTube sites supported by yt-dlp. Enable it from **Download Settings → Generic Mode**. - **Download History:** View past downloads with thumbnails and statuses. You can use this option by clicking on the **History** button.
@@ -358,6 +382,16 @@ If you see this error on macOS Sonoma or newer, you need to remove the quarantin + +## 💖 Sponsor + +If YTSage saves you time, consider sponsoring the project. Sponsorship helps cover development time, testing across platforms, and future improvements. + +- GitHub Sponsors: https://github.com/sponsors/oop7 +- The sponsor link is also available directly inside the app from the About dialog. + +[![Sponsor YTSage](https://img.shields.io/badge/Sponsor-YTSage-EA4AAA?style=for-the-badge&logo=github&logoColor=white)](https://github.com/sponsors/oop7) + ## 👥 Contributing