docs: add antivirus false positive warning to troubleshooting

This commit is contained in:
Mohamed
2025-08-19 20:30:54 +03:00
committed by GitHub
parent 248fe30346
commit 6652d7f00f
+18
View File
@@ -207,6 +207,24 @@ python main.py
--- ---
#### 🛡️ Windows Defender / Antivirus Warning
Some antivirus software may flag the `.exe` files as false positives. This is a **known limitation** of PyInstaller-packaged applications.
**Why this happens:**
- PyInstaller bundles Python runtime and libraries together
- Antivirus heuristics can misidentify packed executables as suspicious
- This affects many legitimate Python applications built with PyInstaller
**Safe alternatives:**
-**Use pip installation:** `pip install ytsage` (recommended)
-**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 cant be opened" #### 🍎 macOS: "App is damaged and cant be opened"
If you see this error on macOS Sonoma or newer, you need to remove the quarantine attribute. If you see this error on macOS Sonoma or newer, you need to remove the quarantine attribute.