From edb06e8e032cfbf0bf9e6e1b7f2b1e5cc834d805 Mon Sep 17 00:00:00 2001 From: Your Name Date: Thu, 28 Aug 2025 19:56:03 +0300 Subject: [PATCH] Update README with executable details and cookie guide Expanded the pre-built executables section to list all available Windows, Linux, and macOS package formats with descriptions. Improved instructions for logging in with cookies, highlighting the built-in extraction feature and clarifying manual steps. Removed outdated antivirus issue note for clarity. --- README.md | 28 +++++++++++++++++----------- 1 file changed, 17 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 79b5ef2..d780b97 100644 --- a/README.md +++ b/README.md @@ -71,9 +71,17 @@ ytsage ### πŸ“¦ Pre-built Executables -- πŸͺŸ **Windows:** YTSage-v<version>.exe / YTSage-v<version>-ffmpeg.exe (with FFmpeg) -- 🐧 **Linux:** YTSage-v<version>-amd64.deb / YTSage-v<version>-x86_64.AppImage -- 🍎 **macOS:** YTSage-v<version>-macOS.zip / YTSage-v<version>.dmg +- πŸͺŸ **Windows:** + - YTSage-v<version>.exe (Standard installer) + - YTSage-v<version>-ffmpeg.exe (With FFmpeg bundled) + - YTSage-v<version>-portable (Portable version, no installation required) + - YTSage-v<version>-ffmpeg-portable.zip (Portable with FFmpeg, zipped) +- 🐧 **Linux:** + - YTSage-v<version>-amd64.deb (Debian package) + - YTSage-v<version>-x86_64.AppImage (AppImage, portable) +- 🍎 **macOS:** + - YTSage-v<version>-macOS.zip (Zipped application) + - YTSage-v<version>.dmg (Disk image installer) > [πŸ‘‰ Download Latest Release](https://github.com/oop7/YTSage/releases/latest) @@ -183,10 +191,12 @@ python main.py - **Speed Limiter:** Limit the download speed - **Login with Cookies:** Login to YouTube using cookies to access private content How to use it: - 1. Extract cookies from your browser using an extension like [cookie-editor](https://github.com/moustachauve/cookie-editor?tab=readme-ov-file) - 2. Copy the cookies in Netscape format - 3. Create a file named `cookies.txt` and paste the cookies into it - 4. Select the `cookies.txt` file in the app + 1. **Recommended:** Use the built-in "Extract cookies from browser" option in the app. Select your browser (Chrome, Firefox, etc.) and then select Profile (optional). + 2. Alternatively, extract cookies manually: + a. Extract cookies from your browser using an extension like [cookie-editor](https://github.com/moustachauve/cookie-editor?tab=readme-ov-file) + b. Copy the cookies in Netscape format + c. Create a file named `cookies.txt` and paste the cookies into it + d. Select the `cookies.txt` file in the app - **Save Download Path:** Save the download path - **Update yt-dlp:** Update yt-dlp - **FFmpeg/yt-dlp Detection:** Automatically detect FFmpeg/yt-dlp @@ -219,10 +229,6 @@ Some antivirus software may flag the `.exe` files as false positives. This is a - βœ… **Build from source** - βœ… **Whitelist the application** in your antivirus software -> πŸ“‹ **Related Issues:** [#33](https://github.com/oop7/YTSage/issues/33) - This is a known PyInstaller limitation, not a security issue with YTSage itself. - ---- - #### 🍎 macOS: "App is damaged and can’t be opened" If you see this error on macOS Sonoma or newer, you need to remove the quarantine attribute.