🛠️ Installationsschritte
@@ -136,7 +137,7 @@ ytsage - **DEB (`.deb`)**: ```bash sudo dpkg -i ytsage_*.deb - sudo apt-get install -f # Fix missing dependencies if any + sudo apt-get install -f # Repariert fehlende Abhängigkeiten, falls nötig ``` - **RPM (`.rpm`)**: ```bash @@ -147,7 +148,7 @@ ytsage chmod +x YTSage-*.AppImage ./YTSage-*.AppImage ``` -- **Flatpak**: Folgen Sie den Anweisungen auf Flathub oder führen Sie Folgendes aus: +- **Flatpak**: Folgen Sie den Anweisungen auf Flathub oder führen Sie aus: ```bash flatpak install flathub io.github.oop7.ytsage ``` @@ -155,26 +156,26 @@ ytsage #### 🍎 macOS -| Formatieren | Beschreibung | +| Format | Beschreibung | |--------|-------------| -|  | Gezippte Anwendung für Apple Silicon | -|  | Disk-Image-Installationsprogramm für Apple Silicon | +|  | Gepackte App für Apple Silicon | +|  | Disk Image Installer für Apple Silicon |🛠️ Installationsschritte
-- **DMG-Installationsprogramm (`.dmg`)**: Doppelklicken Sie zum Mounten und ziehen Sie dann `YTSage.app` in Ihren Anwendungsordner. -- **App-Archiv (`.zip`)**: Extrahieren Sie die ZIP-Datei und verschieben Sie `YTSage.app` in Ihren Anwendungsordner. +- **DMG-Installer (`.dmg`)**: Doppelklick zum Mounten, dann `YTSage.app` in den Programme-Ordner ziehen. +- **App-Archiv (`.zip`)**: Zip entpacken und `YTSage.app` in den Programme-Ordner verschieben. -*Hinweis: Wenn Sie auf den Fehler „App ist beschädigt“ stoßen, sehen Sie sich das [macOS troubleshooting section](#troubleshooting) unten an.* +*Hinweis: Wenn Sie die Fehlermeldung "App ist beschädigt" erhalten, lesen Sie bitte den Abschnitt zur Fehlerbehebung für macOS weiter unten.*
-
-
+
-## 📖 Verwendung
+
+## 📖 Bedienung
💻 Manuelle Installation von der Quelle
+💻 Manuelle Installation aus dem Quellcode
-### 1. Klonen Sie das Repository +### 1. Repository klonen ```bash git clone https://github.com/oop7/YTSage.git @@ -183,19 +184,19 @@ cd YTSage ### 2. Abhängigkeiten installieren -#### ⚡ Mit UV +#### ⚡ Mit uv ```bash uv pip install . ``` -#### 📦 Oder mit Standard-Pip +#### 📦 Oder mit Standard-pip ```bash pip install . ``` -### 3. Führen Sie die Anwendung aus +### 3. Anwendung starten ```bash python -m ytsage.main @@ -209,46 +210,47 @@ python -m ytsage.main |
-  |
+ |
+ |
| Download-Einstellungen | Playlist-Download | ||
 |
-  |
+ |
+ |
| Audioformat | Benutzerdefinierte Optionen |
-
@@ -256,94 +258,97 @@ python -m ytsage.main
🎯 Grundlegende Verwendung
+🎯 Grundlegende Bedienung
1. **YTSage starten** -2. **YouTube-URL einfügen** (oder verwenden Sie die Schaltfläche „URL einfügen“) -3. **Klicken Sie auf „Analysieren“** +2. **YouTube-URL einfügen** (oder die Schaltfläche "Paste URL" verwenden) +3. **Auf "Analyze" klicken** 4. **Format auswählen:** - `Video` für Video-Downloads - - `Audio Only` zur Audioextraktion + - `Audio Only` für Audio-Extraktion 5. **Optionen wählen:** - - Untertitel aktivieren und Sprache auswählen - - Untertitelzusammenführung aktivieren - - Miniaturansicht speichern - - Entfernen Sie Sponsorsegmente + - Untertitel aktivieren & Sprache auswählen + - Untertitel-Merging aktivieren + - Thumbnail speichern + - Sponsoren-Segmente entfernen - Beschreibung speichern - - Kapitel einbetten -6. **Ausgabeverzeichnis auswählen** -7. **Klicken Sie auf „Herunterladen“** + - Kapitel integrieren +6. **Ausgabeverzeichnis wählen** +7. **Auf "Download" klicken** -> 💡 Das Standard-Download-Verzeichnis ist der Ordner „Downloads“ des Benutzers. +> 💡 Das Standard-Download-Verzeichnis ist der "Downloads"-Ordner des Benutzers.📋 Playlist-Download
1. **Playlist-URL einfügen** -2. **Klicken Sie auf „Analysieren“** -3. **Wählen Sie Videos aus der Playlist-Auswahl aus (optional, standardmäßig alle)** -4. **Wählen Sie das gewünschte Format/die gewünschte Qualität** -5. **Klicken Sie auf „Herunterladen“** +2. **Auf "Analyze" klicken** +3. **Videos aus dem Playlist-Selector auswählen (optional, standardmäßig alle)** +4. **Gewünschtes Format/Qualität wählen** +5. **Auf "Download" klicken** -> 💡 Die Anwendung verwaltet die Download-Warteschlange automatisch +> 💡 Die Anwendung verwaltet die Download-Warteschlange automatisch, und Sie können Playlist-Einträge als `.txt`, `.csv`, `.m3u` oder `.json` exportieren.
-
🌍 Allgemeiner Modus für Nicht-YouTube-Websites
+🌍 Generischer Modus für Nicht-YouTube-Seiten
-Verwenden Sie den generischen Modus, wenn Sie möchten, dass YTSage URLs von Websites akzeptiert, die von yt-dlp unterstützt werden, wie z. B. Dailymotion, CBC Gem, TikTok und andere. +Verwenden Sie den generischen Modus (Generic Mode), wenn YTSage URLs von anderen von yt-dlp unterstützten Seiten wie Dailymotion, CBC Gem, TikTok und anderen akzeptieren soll. -So verwenden Sie es: +So verwenden Sie ihn: 1. Öffnen Sie `Download Settings`. 2. Aktivieren Sie `Generic Mode`. -3. Fügen Sie eine unterstützte Nicht-YouTube-Video- oder Playlist-URL ein. +3. Fügen Sie eine unterstützte Video- oder Playlist-URL ein, die nicht von YouTube stammt. 4. Klicken Sie auf `Analyze`. 5. Wählen Sie ein Format und laden Sie es wie gewohnt herunter. Hinweise: -- Der generische Modus ändert nur die URL-Validierung innerhalb von YTSage. Die Zielsite muss weiterhin von Ihrer installierten yt-dlp-Version unterstützt werden. -- Einige Websites erfordern je nach Extraktor Cookies, eine Anmeldesitzung, einen Proxy oder zusätzliche YT-DLP-Argumente. -- Wenn eine Site ausfällt, aktualisieren Sie yt-dlp zunächst über die Registerkarte des integrierten Updaters, bevor Sie das Problem melden. +- Der generische Modus ändert nur die URL-Validierung innerhalb von YTSage. Die Zielseite muss weiterhin von Ihrer installierten yt-dlp-Version unterstützt werden. +- Einige Seiten erfordern Cookies, Login, Proxy oder zusätzliche yt-dlp-Argumente je nach Extractor. +- Wenn eine Seite fehlschlägt, aktualisieren Sie zuerst yt-dlp über den integrierten Update-Tab, bevor Sie das Problem melden.
-
🧰 Medien- und Download-Optionen
+🧰 Medien- & Download-Optionen
-- **Untertiteloptionen:** Sprachen filtern und Untertitel in die Videodatei einbetten -- **Untertitel zusammenführen:** Untertitel für fest codierte Untertitel in die Videodatei einbinden -- **Beschreibung speichern:** Speichern Sie die Videobeschreibung als Textdatei -- **Miniaturansicht speichern:** Speichern Sie die Miniaturansicht des Videos als Bilddatei -- **Kapitel einbetten:** Betten Sie Kapitelmarkierungen als Metadaten für kompatible Videoplayer ein -- **Sponsorensegmente entfernen:** Entfernen Sie Sponsorsegmente aus dem Video mit SponsorBlock -- **Video zuschneiden:** Laden Sie nur bestimmte Teile eines Videos herunter, indem Sie Zeitbereiche im Format `HH:MM:SS` angeben +- **Untertitel-Optionen:** Sprachen filtern und Untertitel in die Videodatei einbetten. +- **Untertitel-Merging:** Mergt Untertitel in die Videodatei für fest eingebrannte (hardcoded) Untertitel. +- **Beschreibung speichern:** Speichert die Videobeschreibung als Textdatei. +- **Thumbnail speichern:** Speichert das Video-Thumbnail als Bilddatei. +- **Kapitel integrieren:** Bettet Kapitelmarken als Metadaten für kompatible Videoplayer ein. +- **Sponsoren-Segmente entfernen:** Entfernt gesponserte Abschnitte aus dem Video mithilfe von SponsorBlock. +- **Video zuschneiden:** Laden Sie nur bestimmte Teile eines Videos herunter, indem Sie Zeitbereiche im Format `HH:MM:SS` angeben.
-
⚙️ Ausgabe- und Dateieinstellungen
+⚙️ Ausgabe- & Dateieinstellungen
+ +- **Geschwindigkeitsbegrenzer:** Begrenzt die Download-Geschwindigkeit, z. B. `500K` für 500 KB/s. +- **Download-Pfad speichern:** Speichert den Standard-Download-Pfad für zukünftige Downloads. Verfügbar unter **Download Settings → Download Path**. +- **Standard-Videoauflösung:** Legen Sie Ihre bevorzugte Videoauflösung für die automatische Auswahl fest (z. B. 1080p, 720p). Verfügbar unter **Download Settings → Default Video Resolution**. +- **Standard-Untertitelsprachen:** Legen Sie Standard-Untertitelsprachen für die automatische Auswahl fest (kommagetrennt, z. B. `de,en`). Verfügbar unter **Download Settings → Default Subtitle Languages**. +- **Dateinamen-Format:** Passen Sie das Format des Ausgabedateinamen mit Variablen wie `%(title)s`, `%(uploader)s`, `%(playlist_index)s` und `%(resolution)s` an. Verfügbar unter **Download Settings → Filename Format**. +- **Ausgabeformat erzwingen:** Erzwingt Video-Downloads in ein bestimmtes Containerformat wie `mp4`, `webm` oder `mkv`. Verfügbar unter **Download Settings → Output Format Settings**. +- **Audioformat-Konvertierung:** Konvertiert reine Audio-Downloads in bevorzugte Formate wie `AAC`, `MP3`, `FLAC`, `WAV`, `Opus`, `M4A`, `Vorbis` oder `Best`. Verfügbar unter **Download Settings → Audio Format Settings**. +- **Audio-Normalisierung:** Standardisiert die Lautstärke für reine Audio-Downloads unter Verwendung von EBU R128. +- **Gleichzeitige Verbindungen:** Erhöhen Sie die Download-Geschwindigkeit erheblich, indem Sie Dateien in mehreren Fragmenten gleichzeitig herunterladen. Verfügbar unter **Download Settings → General → Concurrent Connections** (Standardmäßig 1, maximal 8-10 empfohlen, um IP-Sperren zu vermeiden). -- **Geschwindigkeitsbegrenzer:** Begrenzen Sie die Download-Geschwindigkeit, zum Beispiel `500K` auf 500 KB/s -- **Download-Pfad speichern:** Speichern Sie den Standard-Download-Pfad für zukünftige Downloads. Verfügbar unter **Download-Einstellungen → Download-Pfad**. -- **Format des Ausgabedateinamens:** Passen Sie das Format des Ausgabedateinamens mithilfe von Variablen wie `%(title)s`, `%(uploader)s` und `%(resolution)s` an. Verfügbar unter **Download-Einstellungen → Dateinamenformat**. -- **Ausgabeformat erzwingen:** Video-Downloads in ein bestimmtes Containerformat wie `mp4`, `webm` oder `mkv` erzwingen. Verfügbar unter **Download-Einstellungen → Ausgabeformat-Einstellungen**. -- **Audioformatkonvertierung:** Konvertieren Sie reine Audio-Downloads in bevorzugte Formate wie `AAC`, `MP3`, `FLAC`, `WAV`, `Opus`, `M4A`, `Vorbis` oder `Best`. Verfügbar unter **Download-Einstellungen → Audioformat-Einstellungen**. -- **Audio-Normalisierung:** Standardisieren Sie die Lautstärke für reine Audio-Downloads mit EBU R128. -- **Gleichzeitige Verbindungen:** Erhöhen Sie die Download-Geschwindigkeit drastisch, indem Sie Dateien gleichzeitig in mehreren Fragmenten herunterladen. Verfügbar in **Download-Einstellungen → Allgemein → Gleichzeitige Verbindungen** (Standard ist 1, empfohlenes Maximum ist 8-10, um IP-Einschränkungen zu vermeiden).\n
-:`
-- **Generischer Modus:** Ermöglicht YTSage die Analyse und den Download von Nicht-YouTube-Websites, die von yt-dlp unterstützt werden. Aktivieren Sie es über **Download-Einstellungen → Allgemeiner Modus**.
+ c. Erstellen Sie eine Datei namens `cookies.txt` und fügen Sie die Cookies ein
+ d. Wählen Sie die Datei `cookies.txt` in der App aus
+- **Proxy-Support:** Verwenden Sie einen Proxy-Server für Downloads, z. B. `http://:`
+- **Generischer Modus:** Ermöglicht YTSage das Analysieren und Herunterladen von anderen von yt-dlp unterstützten Seiten. Aktivieren Sie dies unter **Download Settings → Generic Mode**.
🌐 Zugang und Netzwerk
+🌐 Zugriff & Netzwerk
-- **Mit Cookies anmelden:** Melden Sie sich mit Cookies bei YouTube an, um auf private Inhalte zuzugreifen. - So verwenden Sie es: - 1. **Empfohlen:** Verwenden Sie die integrierte Option „Extract cookies from browser“ in der App und wählen Sie dann Ihren Browser und optional ein Profil aus. - 2. Alternativ können Sie Cookies auch manuell extrahieren: +- **Cookie-Login:** Loggen Sie sich mit Cookies bei YouTube ein, um auf private Inhalte zuzugreifen. + Verwendung: + 1. **Empfohlen:** Verwenden Sie die integrierte Option `Extract cookies from browser` in der App, wählen Sie dann Ihren Browser und optional ein Profil. + 2. Alternativ können Sie Cookies manuell extrahieren: a. Exportieren Sie Cookies aus Ihrem Browser mit einer Erweiterung wie [cookie-editor](https://github.com/moustachauve/cookie-editor?tab=readme-ov-file) b. Kopieren Sie die Cookies im Netscape-Format - c. Erstellen Sie eine Datei mit dem Namen `cookies.txt` und fügen Sie die Cookies darin ein - d. Wählen Sie in der App die Datei „cookies.txt“ aus -- **Proxy-Unterstützung:** Verwenden Sie einen Proxy-Server für Downloads, zum Beispiel `http://
-
🛠️ Werkzeuge und Wartung
+🛠️ Tools & Wartung
-- **Benutzerdefinierte Befehle:** Greifen Sie über Befehlszeilenargumente auf erweiterte yt-dlp-Funktionen zu -- **Registerkarte „Updater“:** Integrierte Update-Tools von einem Ort aus in den benutzerdefinierten Optionen verwalten: - - **yt-dlp-Updates:** Suchen Sie nach Updates und wechseln Sie zwischen den Veröffentlichungskanälen Stable und Nightly - - **FFmpeg-Versionsprüfer:** Überprüfen Sie Ihre FFmpeg-Version und öffnen Sie die Installationsanleitungen - - **Deno-Updates:** Überprüfen und aktualisieren Sie die Deno-Laufzeitumgebung -- **FFmpeg/yt-dlp/Deno-Erkennung:** Erkennt automatisch FFmpeg-, yt-dlp- und Deno-Pfade und -Versionen im Info-Dialog. -- **Download-Verlauf:** Zeigen Sie frühere Downloads mit Miniaturansichten und Status über die Schaltfläche **Verlauf** an. +- **Benutzerdefinierte Befehle:** Greifen Sie auf erweiterte yt-dlp-Funktionen über Befehlszeilenargumente zu. +- **Update-Tab:** Verwalten Sie integrierte Update-Tools an einem Ort in den benutzerdefinierten Optionen: + - **yt-dlp Updates:** Suchen Sie nach Updates und wechseln Sie zwischen Stable- und Nightly-Release-Kanälen. + - **FFmpeg-Versionsprüfung:** Überprüfen Sie Ihre FFmpeg-Version und öffnen Sie Installationsanleitungen. + - **Deno-Updates:** Überprüfen und aktualisieren Sie die Deno-Laufzeitumgebung. +- **FFmpeg/yt-dlp/Deno Erkennung:** Erkennt Pfade und Versionen von FFmpeg, yt-dlp und Deno automatisch aus dem About-Dialog. +- **Download-Historie:** Zeigt vergangene Downloads mit Thumbnails und Status über die Schaltfläche **History** an.🌍 Lokalisierung
-YTSage unterstützt **14 Sprachen** für weltweite Zugänglichkeit. Wählen Sie Ihre bevorzugte Sprache unter **Benutzerdefinierte Optionen → Sprache** aus. +YTSage unterstützt **14 Sprachen** für globale Barrierefreiheit. Wählen Sie Ihre bevorzugte Sprache unter **Custom Options → Language**. ### Unterstützte Sprachen @@ -361,7 +366,7 @@ YTSage unterstützt **14 Sprachen** für weltweite Zugänglichkeit. Wählen Sie | Sprache | Datei | Sprache | Datei | |----------|------|----------|------| -| 🇺🇸 Englisch | [README.md](../README.md) | 🇪🇸 Spanisch | [README.es.md](README.es.md) +| 🇺🇸 Englisch | [README.md](README.md) | 🇪🇸 Spanisch | [README.es.md](README.es.md) | | 🇸🇦 Arabisch | [README.ar.md](README.ar.md) | 🇫🇷 Französisch | [README.fr.md](README.fr.md) | | 🇩🇪 Deutsch | [README.de.md](README.de.md) | 🇮🇳 Hindi | [README.hi.md](README.hi.md) | | 🇮🇩 Indonesisch | [README.id.md](README.id.md) | 🇮🇹 Italienisch | [README.it.md](README.it.md) | @@ -369,7 +374,7 @@ YTSage unterstützt **14 Sprachen** für weltweite Zugänglichkeit. Wählen Sie | 🇧🇷 Portugiesisch | [README.pt.md](README.pt.md) | 🇷🇺 Russisch | [README.ru.md](README.ru.md) | | 🇹🇷 Türkisch | [README.tr.md](README.tr.md) | 🇨🇳 Chinesisch | [README.zh.md](README.zh.md) | -> 💡 **Möchten Sie eine Übersetzung beisteuern?** Schauen Sie sich den Abschnitt [Contributing](#contributing) an, um uns beim Hinzufügen weiterer Sprachen zu helfen! +> 💡 **Möchten Sie bei einer Übersetzung helfen?** Schauen Sie in den Abschnitt [Mitwirken](#contributing), um uns zu helfen, weitere Sprachen hinzuzufügen!Klicken Sie hier, um häufige Probleme und Lösungen anzuzeigen
-- **Formattabelle wird nicht angezeigt:** Aktualisieren Sie yt-dlp auf die neueste Version und wechseln Sie jede Nacht zu yt-dlp. +- **Formattabelle wird nicht angezeigt:** Aktualisieren Sie yt-dlp auf die neueste Version und wechseln Sie zu yt-dlp nightly. - **Download schlägt fehl:** Überprüfen Sie Ihre Internetverbindung und stellen Sie sicher, dass das Video verfügbar ist. -- **Spezifische Downloadfehler:** - - **Private Videos:** Verwenden Sie die Cookie-Authentifizierung, um auf private Inhalte zuzugreifen. - - **Inhalte mit Altersbeschränkung:** Melden Sie sich bei Ihrem YouTube-Konto an, um Videos mit Altersbeschränkung anzusehen. - - **Geoblockierte Videos:** Erwägen Sie die Verwendung eines VPN, um regionale Beschränkungen zu umgehen. - - **Entfernte/gelöschte Videos:** Das Video ist nicht mehr auf YouTube verfügbar. - - **Live-Streams:** Live-Streams können nicht heruntergeladen werden; Warten Sie, bis der Stream beendet ist. +- **Spezifische Download-Fehler:** + - **Private Videos:** Verwenden Sie Cookie-Authentifizierung, um auf private Inhalte zuzugreifen. + - **Videos mit Altersbeschränkung:** Loggen Sie sich in Ihr YouTube-Konto ein, um altersbeschränkte Videos anzusehen. + - **Geoblockierte Videos:** Erwägen Sie die Verwendung eines VPN, um regionale Einschränkungen zu umgehen. + - **Gelöschte Videos:** Das Video ist auf YouTube nicht mehr verfügbar. + - **Livestreams:** Livestreams können während der Übertragung nicht heruntergeladen werden; warten Sie, bis der Stream beendet ist. - **Netzwerkfehler:** Überprüfen Sie Ihre Internetverbindung und versuchen Sie es erneut. - **Ungültige URLs:** Stellen Sie sicher, dass die URL korrekt ist und von einer unterstützten Plattform stammt. - - **Premium-Inhalte:** Erfordert eine YouTube Premium-Mitgliedschaft. - - **Urheberrechtliche Sperren:** Der Inhalt ist aufgrund von Urheberrechtsbeschränkungen gesperrt. -- **Video- und Audiodateien nach dem Download trennen:** Dies passiert, wenn FFmpeg fehlt oder nicht erkannt wird. YTSage benötigt FFmpeg, um hochwertige Video- und Audiostreams zusammenzuführen. - - **Lösung:** Stellen Sie sicher, dass FFmpeg im PATH Ihres Systems installiert und zugänglich ist. Für Windows-Benutzer ist es am einfachsten, die Datei „YTSage-v.json` bearbeiten
-- Wenn Ihre Sprache fehlt, beginnen Sie mit `README.md` und erstellen Sie `README..md`
+- Aktualisieren Sie die entsprechende lokalisierte README-Datei (z. B. `readme-translations/README.de.md`)
+- Halten Sie die App-Strings synchron, indem Sie `ytsage/languages/.json` bearbeiten
+- Wenn Ihre Sprache fehlt, beginnen Sie mit der `README.md` und erstellen Sie `README..md`
📂 Projektstruktur
-## YTSage – Projektstruktur
+## YTSage - Projektstruktur
Dieses Dokument beschreibt die organisierte Ordnerstruktur von YTSage.
@@ -476,58 +481,58 @@ Dieses Dokument beschreibt die organisierte Ordnerstruktur von YTSage.
```
YTSage/
-├── 📁 .github/ # GitHub configuration
-│ ├── 📁 ISSUE_TEMPLATE/ # Issue templates
-│ │ └── 🐛-bug-report.md # Bug report template
-│ ├─── 📁 workflows/ # GitHub Actions workflows
-│ │ ├── build-linux.yml # Linux build workflow
-│ │ ├── build-macos.yml # macOS build workflow
-│ │ │── build-windows.yml # Windows build workflow
-| | └── release-all.yml # Master release workflow
-│ └── 📄 CI_CD_README.md # CI/CD documentation
-├── 📁 branding/ # Branding assets (Screenshots, SVGs)
-│ ├── 📁 icons/ # Application icons
-│ ├── 📁 screenshots/ # Screenshots for documentation
-│ └── 📁 svg/ # SVG assets
-├── 📄 LICENSE # License file
-├── 📄 pyproject.toml # Project metadata and dependencies
-├── 📄 README.md # Project documentation
-├── 📄 requirements.txt # Python dependencies (dev)
-└── 📁 ytsage/ # Source package
- ├── 📁 assets/ # Runtime assets
- │ ├── 📁 Icon/ # Application icons
- │ └── 📁 sound/ # Audio files
- ├── 📁 languages/ # Localization files
- │ ├── 📄 ar.json # Arabic translation
- │ ├── 📄 de.json # German translation
- │ ├── 📄 en.json # English translation
- │ └── ... # Other languages
- ├── 📁 core/ # Core business logic
- │ ├── 📄 __init__.py # Core package init
- │ ├── 📄 ytsage_deno.py # Deno integration
- │ ├── 📄 ytsage_downloader.py # Download functionality
- │ ├── 📄 ytsage_ffmpeg.py # FFmpeg integration
- │ ├── 📄 ytsage_utils.py # Utility functions
- │ └── 📄 ytsage_yt_dlp.py # yt-dlp integration
- ├── 📁 gui/ # User interface components
- │ ├── 📄 __init__.py # GUI package init
- │ ├── 📄 ytsage_gui_main.py # Main application window
- │ └── 📁 ytsage_gui_dialogs/ # Dialog classes
- ├── 📁 utils/ # Utility modules
- │ ├── 📄 __init__.py # Utils package init
- │ ├── 📄 ytsage_config_manager.py # Configuration management
- │ └── 📄 ytsage_logger.py # Logging utilities
- ├── 📄 __init__.py # Package entry point
- └── 📄 main.py # Main execution script
+├── 📁 .github/ # GitHub-Konfiguration
+│ ├── 📁 ISSUE_TEMPLATE/ # Ticket-Vorlagen
+│ │ └── 🐛-bug-report.md # Bug-Report-Vorlage
+│ ├─── 📁 workflows/ # GitHub Actions Workflows
+│ │ ├── build-linux.yml # Linux Build Workflow
+│ │ ├── build-macos.yml # macOS Build Workflow
+│ │ │── build-windows.yml # Windows Build Workflow
+| | └── release-all.yml # Master Release Workflow
+│ └── 📄 CI_CD_README.md # CI/CD-Dokumentation
+├── 📁 branding/ # Branding-Assets (Screenshots, SVGs)
+│ ├── 📁 icons/ # App-Icons
+│ ├── 📁 screenshots/ # Screenshots für die Dokumentation
+│ └── 📁 svg/ # SVG-Assets
+├── 📄 LICENSE # Lizenzdatei
+├── 📄 pyproject.toml # Projekt-Metadaten und Abhängigkeiten
+├── 📄 README.md # Projekt-Dokumentation
+├── 📄 requirements.txt # Python-Abhängigkeiten (dev)
+└── 📁 ytsage/ # Quellcode-Paket
+ ├── 📁 assets/ # Laufzeit-Assets
+ │ ├── 📁 Icon/ # App-Icons
+ │ └── 📁 sound/ # Audiodateien
+ ├── 📁 languages/ # Lokalisierungsdateien
+ │ ├── 📄 ar.json # Arabische Übersetzung
+ │ ├── 📄 de.json # Deutsche Übersetzung
+ │ ├── 📄 en.json # Englische Übersetzung
+ │ └── ... # Weitere Sprachen
+ ├── 📁 core/ # Hauptgeschäftslogik
+ │ ├── 📄 __init__.py # Core-Paket-Initialisierung
+ │ ├── 📄 ytsage_deno.py # Deno-Integration
+ │ ├── 📄 ytsage_downloader.py # Download-Funktionalität
+ │ ├── 📄 ytsage_ffmpeg.py # FFmpeg-Integration
+ │ ├── 📄 ytsage_utils.py # Hilfsfunktionen
+ │ └── 📄 ytsage_yt_dlp.py # yt-dlp-Integration
+ ├── 📁 gui/ # Benutzeroberflächen-Komponenten
+ │ ├── 📄 __init__.py # GUI-Paket-Initialisierung
+ │ ├── 📄 ytsage_gui_main.py # Hauptfenster der App
+ │ └── 📁 ytsage_gui_dialogs/ # Dialog-Klassen
+ ├── 📁 utils/ # Hilfsmodule
+ │ ├── 📄 __init__.py # Utils-Paket-Initialisierung
+ │ ├── 📄 ytsage_config_manager.py # Konfigurationsverwaltung
+ │ └── 📄 ytsage_logger.py # Logging-Tool
+ ├── 📄 __init__.py # Paket-Einstiegspunkt
+ └── 📄 main.py # Hauptskript zur Ausführung
```
-## ⭐️ Sterngeschichte
+## ⭐️ Star History
-## Sterngeschichte
+## Star History
@@ -541,7 +546,7 @@ YTSage/
## 📜 Lizenz
-Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei „LICENSE“.
+Dieses Projekt steht unter der MIT-Lizenz – weitere Details finden Sie in der Datei [LICENSE](LICENSE).
## 🙏 Danksagungen
@@ -550,13 +555,13 @@ Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie i
-Ein herzliches Dankeschön an alle, die zu diesem Projekt beigetragen haben, indem sie ein Problem geöffnet haben, um eine Verbesserung vorzuschlagen oder einen Fehler zu melden.
+Ein großes Dankeschön an alle, die zu diesem Projekt beigetragen haben, indem sie Tickets für Verbesserungsvorschläge oder Bug-Reports geöffnet haben.
Kernkomponenten
yt-dlp
- Download Engine
+ Download-Engine
FFmpeg
@@ -564,40 +569,41 @@ Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie i
Deno
- Laufzeit für die Integration mit yt-dlp
+ Runtime für yt-dlp Integration
- Bibliotheken und Frameworks Bibliotheken & Frameworks
PySide6
GUI-Framework
- Kissen
+ Pillow
Bildverarbeitung
- Anfragen
+
+ requests
HTTP-Anfragen
- Verpackung
- Versions- und Pakethandhabung
+ packaging
+ Versionsverwaltung & Packaging
- Abschlag
+ markdown
Markdown-Rendering
loguru
- Protokollierung
+ Logging
- Vermögenswerte und Mitwirkende Assets & Mitwirkende
- Neue Benachrichtigung 09 von Universfield
+ New Notification 09 by Universfield
Benachrichtigungston
viru185
- Code-Mitwirkender
+ Code-Contributor
@@ -607,12 +613,12 @@ Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie i
## ⚠️ Haftungsausschluss
-Dieses Tool ist nur für den persönlichen Gebrauch bestimmt. Bitte respektieren Sie die Nutzungsbedingungen und die Rechte der Inhaltsersteller von YouTube.
+Dieses Tool ist nur für den persönlichen Gebrauch bestimmt. Bitte respektieren Sie die Nutzungsbedingungen von YouTube und die Rechte der Content-Ersteller.
---
-Hergestellt mit ❤️ von [oop7](https://github.com/oop7)
+Erstellt mit ❤️ von [oop7](https://github.com/oop7)
diff --git a/readme-translations/README.it.md b/readme-translations/README.it.md
index 66a4ac2..3201b59 100644
--- a/readme-translations/README.it.md
+++ b/readme-translations/README.it.md
@@ -12,81 +12,82 @@
[](https://pypi.org/project/ytsage/)
[](https://github.com/sponsors/oop7)
-**Un moderno downloader da YouTube con un'interfaccia PySide6 pulita.**
-Scarica video di qualsiasi qualità, estrai audio, recupera sottotitoli e altro ancora.
+**Un downloader YouTube moderno con un'interfaccia PySide6 pulita.**
+Scarica video in qualsiasi qualità, estrai audio, ottieni sottotitoli e molto altro.
-### 🌍 README Lingue
+### 🌍 Lingue del README
Inglese: [EN](../README.md)
-| Indirizzo: [AR](README.ar.md)
+| Arabo: [AR](README.ar.md)
| Tedesco: [DE](README.de.md)
-| Español: [ES](README.es.md)
+| Spagnolo: [ES](README.es.md)
| Francese: [FR](README.fr.md)
-| Nome: [HI](README.hi.md)
-| Bahasa Indonesia: [ID](README.id.md)
+| Hindi: [HI](README.hi.md)
+| Indonesiano: [ID](README.id.md)
| Italiano: [IT](README.it.md)
-| 日本語: [JA](README.ja.md)
+| Giapponese: [JA](README.ja.md)
| Polacco: [PL](README.pl.md)
| Portoghese: [PT](README.pt.md)
| Russo: [RU](README.ru.md)
-| Turchia: [TR](README.tr.md)
-| Nome: [ZH](README.zh.md)
+| Turco: [TR](README.tr.md)
+| Cinese: [ZH](README.zh.md)
- Installazione •
- Caratteristiche •
- Utilizzo •
- Screenshot •
- Risoluzione dei problemi •
+ Installazione •
+ Caratteristiche •
+ Utilizzo •
+ Screenshot •
+ Risoluzione dei problemi •
Sponsor •
- Contribuendo
+ Contribuire
---
-
-## ❓Perché YTSage?
+
+## ❓ Perché YTSage?
YTSage è progettato per gli utenti che desiderano un **downloader YouTube semplice ma potente**. A differenza di altri strumenti, offre:
-- Un'interfaccia PySide6 pulita e moderna
-- Download con un clic per video, audio e sottotitoli
-- Funzionalità avanzate come SponsorBlock, fusione dei sottotitoli e selezione della playlist
-- Modalità generica opzionale per i siti supportati da yt-dlp oltre YouTube
-- Supporto multipiattaforma e facilità di installazione
+- Un'interfaccia PySide6 moderna e pulita
+- Download di video, audio e sottotitoli con un solo clic
+- Funzioni avanzate come SponsorBlock, fusione dei sottotitoli e selezione della playlist
+- Modalità Generica opzionale per siti diversi da YouTube supportati da yt-dlp
+- Supporto multipiattaforma e installazione semplice
-
-## ✨Caratteristiche
+
+## ✨ Caratteristiche
-| Caratteristiche principali | Funzionalità avanzate | Funzionalità extra |
-|------------------------------------|----------------------------------------------|------------------------------------|
-| 🎥 Tabella dei formati | 🚫Integrazione SponsorBlock | 🎞️ Visualizzazione FPS/HDR |
-| 🎵Estrazione audio | 📝 Seleziona e unisci più sottotitoli | 🔄 Aggiornamento automatico yt-dlp |
-| ✨Interfaccia utente semplice | 💾 Salva descrizione e miniatura | 🛠️ Rilevamento FFmpeg/yt-dlp/Deno |
-| 📋 Supporto e selettore playlist | 🚀Limitatore di velocità | ⚙️ Comandi personalizzati |
-| 📑 Incorpora capitoli | ✂️ Taglia le sezioni video | 🍪 Accedi con i cookie |
-| 📜 Scarica Cronologia | 🔄 Rilascio Selezione canale | 🌐Supporto proxy |
-| 🎚️ Conversione del formato audio | 🎬 Impostazioni formato video | 🆙 Scheda Aggiornamento integrata |
-| 🌍 Modalità generica | 🔊 Normalizzazione audio (EBU R128) | 🌍 Localizzazione in 14 lingue |
+| Funzioni Base | Funzioni Avanzate | Funzioni Extra |
+|-----------------------------------|-----------------------------------------|------------------------------------|
+| 🎥 Tabella Formati | 🚫 Integrazione SponsorBlock | 🎞️ Visualizzazione FPS/HDR |
+| 🎵 Estrazione Audio | 📝 Selezione e Fusione Sottotitoli | 🔄 Aggiornamento automatico yt-dlp |
+| ✨ Interfaccia Utente Semplice | 💾 Salva Descrizione e Anteprima | 🛠️ Rilevamento FFmpeg/yt-dlp/Deno |
+| 📋 Supporto e Selettore Playlist | 🚀 Limitatore di Velocità | ⚙️ Comandi Personalizzati |
+| 📑 Integrazione Capitoli | ✂️ Ritaglio Sezioni Video | 🍪 Login tramite Cookie |
+| 📜 Cronologia Download | 🔄 Scelta del Canale di Rilascio | 🌐 Supporto Proxy |
+| 🎚️ Conversione Formato Audio | 🎬 Impostazioni Formato Video | 🆙 Tab Aggiornamento Integrato |
+| 🌍 Modalità Generica | 🔊 Normalizzazione Audio (EBU R128) | 🌍 Localizzazione in 14 lingue |
+| 💾 Esportazione Playlist | ⚙️ Qualità e Sottotitoli Predefiniti | |
-
+
## 🚀 Installazione
-### ⚡ Installazione rapida (consigliata)
+### ⚡ Installazione Rapida (Consigliata)
-Installa YTSage da PyPI:
+Installa YTSage tramite PyPI:
```bash
pip install ytsage
```
-🔄 Aggiorna un'installazione esistente
+🔄 Aggiornare un'installazione esistente
```bash
pip install --upgrade ytsage
@@ -94,51 +95,51 @@ pip install --upgrade ytsage
-Quindi avvia l'app:
+Quindi esegui l'applicazione:
```bash
ytsage
```
-### 📦 Eseguibili predefiniti
+### 📦 Eseguibili Pre-compilati (Executable)
-> [👉 Download Latest Release](https://github.com/oop7/YTSage/releases/latest)
+> [👉 Scarica l'ultima versione](https://github.com/oop7/YTSage/releases/latest)
-#### 🪟 Finestre
+#### 🪟 Windows
| Formato | Descrizione |
|--------|-------------|
-|  | Programma di installazione standard |
-|  | Con FFmpeg in bundle |
-|  | Versione portatile, nessuna installazione richiesta |
-|  | Portatile con FFmpeg, zippato |
+|  | Installer Standard |
+|  | Include FFmpeg |
+|  | Versione Portable, nessuna installazione richiesta |
+|  | Portable con FFmpeg, compresso (ZIP) |
-🛠️ Passaggi di installazione
+🛠️ Passaggi per l'installazione
-1. **Programma di installazione EXE (`.exe`)**: fare doppio clic sul file e seguire la procedura guidata di installazione.
-2. **Versione portatile (`.zip`)**: estrai l'archivio nella posizione desiderata ed esegui `ytsage.exe`.
-3. **FFmpeg in bundle**: scegli le versioni in bundle di FFmpeg se non hai FFmpeg installato sul tuo sistema.
+1. **Installer EXE (`.exe`)**: Fare doppio clic sul file e seguire la procedura guidata.
+2. **Versione Portable (`.zip`)**: Estrarre l'archivio nella posizione desiderata ed eseguire `ytsage.exe`.
+3. **FFmpeg integrato**: Se non hai FFmpeg sul tuo sistema, scegli le versioni con FFmpeg integrato.
-#### 🐧Linux
+#### 🐧 Linux
| Formato | Descrizione |
|--------|-------------|
|  | Pacchetto Debian |
-|  | AppImage, portatile |
+|  | AppImage, Portable |
|  | Pacchetto RPM |
-|  | Pacchetto Flatpack |
+|  | Bundle Flatpak |
-🛠️ Passaggi di installazione
+🛠️ Passaggi per l'installazione
- **DEB (`.deb`)**:
```bash
sudo dpkg -i ytsage_*.deb
- sudo apt-get install -f # Fix missing dependencies if any
+ sudo apt-get install -f # Se necessario per correggere le dipendenze mancanti
```
-- **Giri/min (`.rpm`)**:
+- **RPM (`.rpm`)**:
```bash
sudo rpm -i ytsage-*.rpm
```
@@ -147,7 +148,7 @@ ytsage
chmod +x YTSage-*.AppImage
./YTSage-*.AppImage
```
-- **Flatpak**: segui le istruzioni su Flathub o esegui:
+- **Flatpak**: Seguire le istruzioni su Flathub o eseguire:
```bash
flatpak install flathub io.github.oop7.ytsage
```
@@ -157,22 +158,22 @@ ytsage
| Formato | Descrizione |
|--------|-------------|
-|  | Applicazione zippata per Apple Silicon |
-|  | Programma di installazione dell'immagine disco per Apple Silicon |
+|  | App ZIP per Apple Silicon |
+|  | Installer Disk Image per Apple Silicon |
-🛠️ Passaggi di installazione
+🛠️ Passaggi per l'installazione
-- **DMG Installer (`.dmg`)**: fai doppio clic per montare, quindi trascina `YTSage.app` nella cartella Applicazioni.
-- **Archivio app (`.zip`)**: estrai il file zip e sposta `YTSage.app` nella cartella Applicazioni.
+- **Installer DMG (`.dmg`)**: Fare doppio clic per montare, quindi trascinare `YTSage.app` nella cartella Applicazioni.
+- **Archivio App (`.zip`)**: Estrarre lo ZIP e spostare `YTSage.app` nella cartella Applicazioni.
-*Nota: se riscontri l'errore "L'app è danneggiata", consulta [macOS troubleshooting section](#troubleshooting) di seguito.*
+*Nota: Se ricevi l'errore "L'app è danneggiata", consulta la sezione Risoluzione dei problemi macOS di seguito.*
---
-💻 Installazione manuale dalla fonte
+💻 Installazione manuale dai sorgenti
### 1. Clonare il repository
@@ -181,7 +182,7 @@ git clone https://github.com/oop7/YTSage.git
cd YTSage
```
-### 2. Installa le dipendenze
+### 2. Installare le dipendenze
#### ⚡ Con uv
@@ -189,7 +190,7 @@ cd YTSage
uv pip install .
```
-#### 📦 Oppure con pip standard
+#### 📦 O con pip standard
```bash
pip install .
@@ -203,226 +204,230 @@ python -m ytsage.main
-
-## 📸 Schermate
+
+## 📸 Screenshot
-
- Scarica impostazioni
- Scarica playlist
+ Impostazioni Download
+ Download Playlist
-
- Formato audio
- Opzioni personalizzate
+ Formato Audio
+ Opzioni Personalizzate
-
+
+
## 📖 Utilizzo
-🎯 Utilizzo di base
+🎯 Utilizzo Base
1. **Avvia YTSage**
-2. **Incolla l'URL di YouTube** (o utilizza il pulsante "Incolla URL")
-3. **Fai clic su "Analizza"**
-4. **Seleziona formato:**
- - `Video` per i download di video
- - `Audio Only` per l'estrazione audio
-5. **Scegli le opzioni:**
- - Abilita i sottotitoli e seleziona la lingua
- - Abilita l'unione dei sottotitoli
- - Salva miniatura
- - Rimuovere i segmenti dello sponsor
- - Salva descrizione
- - Incorpora capitoli
-6. **Seleziona directory di output**
-7. **Fai clic su "Scarica"**
+2. **Incolla un URL di YouTube** (o usa il pulsante "Incolla URL")
+3. **Clicca su "Analizza"**
+4. **Scegli il formato:**
+ - `Video` per il download del video
+ - `Solo Audio` per l'estrazione dell'audio
+5. **Seleziona le opzioni:**
+ - Abilita i sottotitoli e scegli la lingua
+ - Abilita la fusione dei sottotitoli
+ - Salva l'anteprima (thumbnail)
+ - Rimuovi sezioni sponsor
+ - Salva la descrizione
+ - Incorpora i capitoli
+6. **Scegli la directory di destinazione**
+7. **Clicca su "Download"**
> 💡 La directory di download predefinita è la cartella "Download" dell'utente.
-📋 Download della playlist
+📋 Download Playlist
1. **Incolla l'URL della playlist**
-2. **Fai clic su "Analizza"**
-3. **Seleziona i video dal selettore della playlist (facoltativo, l'impostazione predefinita è tutti)**
-4. **Scegli il formato/la qualità desiderata**
-5. **Fai clic su "Scarica"**
+2. **Clicca su "Analizza"**
+3. **Seleziona i video dal selettore (opzionale, tutti per impostazione predefinita)**
+4. **Scegli il formato/qualità desiderati**
+5. **Clicca su "Download"**
-> 💡 L'applicazione gestisce automaticamente la coda di download
+> 💡 L'applicazione gestisce automaticamente la coda di download e puoi esportare le voci della playlist come file `.txt`, `.csv`, `.m3u` o `.json`.
-🌍 Modalità generica per siti non YouTube
+🌍 Modalità Generica per siti non YouTube
-Utilizza la modalità generica quando desideri che YTSage accetti URL da siti supportati da yt-dlp, come Dailymotion, CBC Gem, TikTok e altri.
+Usa la Modalità Generica quando vuoi che YTSage accetti URL da siti supportati da yt-dlp come Dailymotion, CBC Gem, TikTok e altri.
-Come usarlo:
+Come usarla:
-1. Apri `Download Settings`.
-2. Abilita `Generic Mode`.
-3. Incolla un video o un URL di playlist non YouTube supportato.
-4. Fare clic su `Analyze`.
-5. Scegli un formato e scarica come al solito.
+1. Apri `Impostazioni Download`.
+2. Abilita `Modalità Generica`.
+3. Incolla un URL di un video o di una playlist supportata che non sia YouTube.
+4. Clicca su `Analizza`.
+5. Scegli un formato e scarica normalmente.
Note:
-- La modalità generica modifica solo la convalida dell'URL all'interno di YTSage. Il sito di destinazione deve essere ancora supportato dalla versione yt-dlp installata.
-- Alcuni siti richiedono cookie, una sessione di accesso, un proxy o argomenti yt-dlp aggiuntivi a seconda dell'estrattore.
-- Se un sito non funziona, aggiorna prima yt-dlp dalla scheda di aggiornamento integrata prima di segnalare il problema.
+- La Modalità Generica cambia solo la validazione dell'URL all'interno di YTSage. Il sito di destinazione deve essere comunque supportato dalla versione di yt-dlp installata.
+- Alcuni siti richiedono cookie, login, proxy o argomenti yt-dlp aggiuntivi a seconda dell'estrattore.
+- Se un sito fallisce, aggiorna yt-dlp dal tab di aggiornamento integrato prima di segnalare il problema.
-🧰 Opzioni multimediali e di download
+🧰 Opzioni Media e Download
-- **Opzioni sottotitoli:** Filtra le lingue e incorpora i sottotitoli nel file video
-- **Unione sottotitoli:** unisci i sottotitoli nel file video per i sottotitoli hardcoded
-- **Salva descrizione:** salva la descrizione del video come file di testo
-- **Salva miniatura:** salva la miniatura del video come file immagine
-- **Incorpora capitoli:** incorpora indicatori di capitolo come metadati per lettori video compatibili
-- **Rimuovi segmenti di sponsor:** rimuovi i segmenti di sponsor dal video utilizzando SponsorBlock
-- **Taglia video:** scarica solo parti specifiche di un video specificando gli intervalli di tempo nel formato `HH:MM:SS`
+- **Opzioni Sottotitoli:** Filtra le lingue e incorpora i sottotitoli nel file video.
+- **Fusione Sottotitoli:** Fonde i sottotitoli nel file video per sottotitoli permanenti (hardcoded).
+- **Salva Descrizione:** Salva la descrizione del video come file di testo.
+- **Salva Anteprima:** Salva l'anteprima (thumbnail) del video come file immagine.
+- **Incorpora Capitoli:** Include i segnaposti dei capitoli come metadati per i lettori video compatibili.
+- **Rimuovi Sezioni Sponsor:** Usa SponsorBlock per rimuovere i segmenti sponsorizzati dal video.
+- **Ritaglia Video:** Scarica solo parti specifiche del video specificando un intervallo di tempo nel formato `HH:MM:SS`.
-⚙️ Impostazioni file e output
+⚙️ Impostazioni Output e File
+
+- **Limitatore di Velocità:** Limita la velocità di download, ad esempio `500K` per 500 KB/s.
+- **Salva Percorso Download:** Salva il percorso di download predefinito per i download futuri. Disponibile in **Impostazioni Download → Percorso Download**.
+- **Risoluzione Video Predefinita:** Imposta la risoluzione video preferita per la selezione automatica (es. 1080p, 720p). Disponibile in **Impostazioni Download → Risoluzione Video Predefinita**.
+- **Lingue Sottotitoli Predefinite:** Imposta le lingue dei sottotitoli predefinite per la selezione automatica (separate da virgola, es. `it,en`). Disponibile in **Impostazioni Download → Lingue Sottotitoli Predefinite**.
+- **Formato Nome File:** Personalizza il formato del nome del file di output utilizzando variabili come `%(title)s`, `%(uploader)s`, `%(playlist_index)s` e `%(resolution)s`. Disponibile in **Impostazioni Download → Formato Nome File**.
+- **Forza Formato Output:** Forza il download del video in un formato contenitore specifico come `mp4`, `webm` o `mkv`. Disponibile in **Impostazioni Download → Impostazioni Formato Output**.
+- **Conversione Formato Audio:** Converte i download di solo audio nel formato preferito come `AAC`, `MP3`, `FLAC`, `WAV`, `Opus`, `M4A`, `Vorbis`, o `Best`. Disponibile in **Impostazioni Download → Impostazioni Formato Audio**.
+- **Normalizzazione Audio:** Standardizza il volume per i download di solo audio utilizzando EBU R128.
+- **Connessioni Simultanee:** Aumenta significativamente la velocità di download scaricando i file in più parti contemporaneamente. Disponibile in **Impostazioni Download → Generali → Connessioni Simultanee** (predefinito 1, massimo 8-10 consigliato per evitare blocchi IP).
-- **Limitatore di velocità:** Limita la velocità di download, ad esempio `500K` per 500 KB/s
-- **Salva percorso di download:** salva il percorso di download predefinito per download futuri. Disponibile in **Impostazioni di download → Percorso di download**.
-- **Formato nome file di output:** Personalizza il formato del nome file di output utilizzando variabili come `%(title)s`, `%(uploader)s` e `%(resolution)s`. Disponibile in **Impostazioni download → Formato nome file**.
-- **Forza formato output:** forza i download dei video in un formato contenitore specifico come `mp4`, `webm` o `mkv`. Disponibile in **Impostazioni download → Impostazioni formato output**.
-- **Conversione del formato audio:** Converti i download solo audio nei formati preferiti come `AAC`, `MP3`, `FLAC`, `WAV`, `Opus`, `M4A`, `Vorbis`, o `Best`. Disponibile in **Impostazioni download → Impostazioni formato audio**.
-- **Normalizzazione audio:** Standardizza il volume per i download solo audio utilizzando EBU R128.
-- **Connessioni Simultanee:** Aumenta drasticamente la velocità di download scaricando file in frammenti multipli contemporaneamente. Disponibile in **Impostazioni di Download → Generale → Connessioni Simultanee** (Predefinito 1, massimo consigliato 8-10 per evitare limitazioni IP).\n
🌐 Accesso e Rete
-- **Accedi con i cookie:** Accedi a YouTube utilizzando i cookie per accedere ai contenuti privati.
- Come usarlo:
- 1. **Consigliato:** utilizza l'opzione `Extract cookies from browser` integrata nell'app, quindi seleziona il browser e, facoltativamente, un profilo.
- 2. In alternativa, estrarre manualmente i cookie:
- un. Esporta i cookie dal tuo browser utilizzando un'estensione come [cookie-editor](https://github.com/moustachauve/cookie-editor?tab=readme-ov-file)
- b. Copia i cookie in formato Netscape
- c. Crea un file denominato `cookies.txt` e incollaci i cookie
+- **Login tramite Cookie:** Accedi a YouTube utilizzando i cookie per accedere ai contenuti privati.
+ Utilizzo:
+ 1. **Consigliato:** Usa l'opzione integrata nell'app `Estrai cookie dal browser`, quindi scegli il browser e opzionalmente il profilo.
+ 2. In alternativa, estrai i cookie manualmente:
+ a. Esporta i cookie dal tuo browser utilizzando un'estensione come [cookie-editor](https://github.com/moustachauve/cookie-editor?tab=readme-ov-file)
+ b. Copia i cookie nel formato Netscape
+ c. Crea un file chiamato `cookies.txt` e incolla i cookie
d. Seleziona il file `cookies.txt` nell'app
-- **Supporto proxy:** utilizza un server proxy per i download, ad esempio `http://:`
-- **Modalità generica:** consente a YTSage di analizzare e scaricare da siti non YouTube supportati da yt-dlp. Abilitalo da **Impostazioni download → Modalità generica**.
+- **Supporto Proxy:** Usa un server proxy per i download, ad esempio `http://:`
+- **Modalità Generica:** Consente a YTSage di analizzare e scaricare da siti non YouTube supportati da yt-dlp. Abilitalo da **Impostazioni Download → Modalità Generica**.
-🛠️ Attrezzi e Manutenzione
+🛠️ Strumenti e Manutenzione
-- **Comandi personalizzati:** accedi alle funzionalità avanzate di yt-dlp tramite argomenti della riga di comando
-- **Scheda Aggiornamento:** gestisci gli strumenti di aggiornamento integrati da un'unica posizione in Opzioni personalizzate:
- - **Aggiornamenti yt-dlp:** controlla gli aggiornamenti e passa tra i canali di rilascio stabile e notturno
- - **Controllo versione FFmpeg:** controlla la tua versione di FFmpeg e apri le guide di installazione
- - **Aggiornamenti Deno:** controlla e aggiorna il runtime Deno
-- **Rilevamento FFmpeg/yt-dlp/Deno:** rileva automaticamente i percorsi e le versioni di FFmpeg, yt-dlp e Deno dalla finestra di dialogo Informazioni.
-- **Cronologia download:** visualizza i download precedenti con miniature e stati dal pulsante **Cronologia**.
+- **Comandi Personalizzati:** Accedi alle funzioni avanzate di yt-dlp tramite argomenti della riga di comando.
+- **Tab Aggiornamento:** Gestisci gli strumenti di aggiornamento integrati da un unico posto nelle Opzioni Personalizzate:
+ - **Aggiornamento yt-dlp:** Controlla gli aggiornamenti e passa tra i canali di rilascio Stabile e Nightly.
+ - **Controllo Versione FFmpeg:** Verifica la tua versione di FFmpeg e apri le guide all'installazione.
+ - **Aggiornamento Deno:** Controlla e aggiorna il runtime Deno.
+- **Rilevamento FFmpeg/yt-dlp/Deno:** Rileva automaticamente i percorsi e le versioni di FFmpeg, yt-dlp e Deno dal dialogo Informazioni.
+- **Cronologia Download:** Visualizza i download passati con anteprime e stati dal pulsante **Cronologia**.
🌍 Localizzazione
-YTSage supporta **14 lingue** per l'accessibilità in tutto il mondo. Seleziona la tua lingua preferita da **Opzioni personalizzate → Lingua**.
+YTSage supporta **14 lingue** per una portata globale. Scegli la tua lingua preferita in **Opzioni Personalizzate → Lingua**.
-### Lingue supportate
+### Lingue Supportate
| Lingua | Codice | Lingua | Codice |
|----------|------|----------|------|
-| 🇺🇸 Inglese | `en` | 🇪🇸Spagnolo | `es` |
+| 🇺🇸 Inglese | `en` | 🇪🇸 Spagnolo | `es` |
| 🇸🇦 Arabo | `ar` | 🇫🇷 Francese | `fr` |
| 🇩🇪 Tedesco | `de` | 🇮🇳 Hindi | `hi` |
-| 🇮🇩 Indonesiano | `id` | 🇮🇹Italiano | `it` |
-| 🇯🇵Giapponese | `ja` | 🇵🇱 Polacco | `pl` |
+| 🇮🇩 Indonesiano | `id` | 🇮🇹 Italiano | `it` |
+| 🇯🇵 Giapponese | `ja` | 🇵🇱 Polacco | `pl` |
| 🇧🇷 Portoghese | `pt` | 🇷🇺 Russo | `ru` |
-| 🇹🇷 Turco | `tr` | 🇨🇳Cinese | `zh` |
+| 🇹🇷 Turco | `tr` | 🇨🇳 Cinese | `zh` |
-### Traduzioni README
+### Traduzioni del README
| Lingua | File | Lingua | File |
|----------|------|----------|------|
-| 🇺🇸 Inglese | [README.md](../README.md) | 🇪🇸Spagnolo | [README.es.md](README.es.md)
+| 🇺🇸 Inglese | [README.md](README.md) | 🇪🇸 Spagnolo | [README.es.md](README.es.md) |
| 🇸🇦 Arabo | [README.ar.md](README.ar.md) | 🇫🇷 Francese | [README.fr.md](README.fr.md) |
| 🇩🇪 Tedesco | [README.de.md](README.de.md) | 🇮🇳 Hindi | [README.hi.md](README.hi.md) |
-| 🇮🇩 Indonesiano | [README.id.md](README.id.md) | 🇮🇹Italiano | [README.it.md](README.it.md) |
-| 🇯🇵Giapponese | [README.ja.md](README.ja.md) | 🇵🇱 Polacco | [README.pl.md](README.pl.md) |
+| 🇮🇩 Indonesiano | [README.id.md](README.id.md) | 🇮🇹 Italiano | [README.it.md](README.it.md) |
+| 🇯🇵 Giapponese | [README.ja.md](README.ja.md) | 🇵🇱 Polacco | [README.pl.md](README.pl.md) |
| 🇧🇷 Portoghese | [README.pt.md](README.pt.md) | 🇷🇺 Russo | [README.ru.md](README.ru.md) |
-| 🇹🇷 Turco | [README.tr.md](README.tr.md) | 🇨🇳Cinese | [README.zh.md](README.zh.md) |
+| 🇹🇷 Turco | [README.tr.md](README.tr.md) | Cinese | [README.zh.md](README.zh.md) |
-> 💡 **Vuoi contribuire con una traduzione?** Dai un'occhiata alla sezione [Contributing](#contributing) per aiutarci ad aggiungere altre lingue!
+> 💡 **Vuoi aiutare con la traduzione?** Consulta la sezione [Contribuire](#contribuire) per aiutarci ad aggiungere altre lingue!
-
+
## 🛠️ Risoluzione dei problemi
-Fai clic per visualizzare problemi e soluzioni comuni
+Clicca per visualizzare i problemi comuni e le soluzioni
-- **La tabella di formato non viene visualizzata:** Aggiorna yt-dlp alla versione più recente e passa a yt-dlp ogni notte.
-- **Download non riuscito:** controlla la tua connessione Internet e assicurati che il video sia disponibile.
+- **La tabella dei formati non appare:** Aggiorna yt-dlp all'ultima versione e prova a passare a yt-dlp Nightly.
+- **Download fallito:** Controlla la tua connessione internet e assicurati che il video sia disponibile.
- **Errori di download specifici:**
- - **Video privati:** utilizza l'autenticazione tramite cookie per accedere ai contenuti privati.
- - **Contenuti soggetti a limiti di età:** accedi all'account YouTube per visualizzare video soggetti a limiti di età.
- - **Video geo-bloccati:** valuta la possibilità di utilizzare una VPN per aggirare le restrizioni regionali.
- - **Video rimossi/eliminati:** il video non è più disponibile su YouTube.
- - **Streaming live:** Gli streaming live non possono essere scaricati; attendere la fine dello streaming.
- - **Errori di rete:** controlla la connessione Internet e riprova.
- - **URL non validi:** assicurati che l'URL sia corretto e provenga da una piattaforma supportata.
- - **Contenuti premium:** richiede l'abbonamento a YouTube Premium.
- - **Blocchi dovuti al copyright:** Il contenuto è bloccato a causa di restrizioni sul copyright.
-- **Separare i file video e audio dopo il download:** Ciò accade quando FFmpeg manca o non viene rilevato. YTSage richiede FFmpeg per unire flussi video e audio di alta qualità.
- - **Soluzione:** assicurati che FFmpeg sia installato e accessibile nel PATH del tuo sistema. Per gli utenti Windows, l'opzione più semplice è scaricare il file `YTSage-v-ffmpeg.exe`, fornito in bundle con FFmpeg.
+ - **Video Privati:** Usa l'autenticazione tramite cookie per accedere ai contenuti privati.
+ - **Contenuti con limiti di età:** Accedi al tuo account YouTube per visualizzare i video con limiti di età.
+ - **Video bloccati geograficamente:** Considera l'uso di una VPN per aggirare le restrizioni regionali.
+ - **Video rimosso:** Il video non è più disponibile su YouTube.
+ - **Live Stream:** I live stream non possono essere scaricati durante la trasmissione; attendi la fine dello stream.
+ - **Errori di rete:** Controlla la tua connessione internet e riprova.
+ - **URL non valido:** Assicurati che l'URL sia corretto e provenga da una piattaforma supportata.
+ - **Contenuti Premium:** Richiede un abbonamento YouTube Premium.
+ - **Blocco Copyright:** Il contenuto è bloccato a causa di restrizioni sul copyright.
+- **I file video e audio sono separati dopo il download:** Questo accade quando FFmpeg manca o non viene rilevato. YTSage richiede FFmpeg per unire i flussi video e audio di alta qualità.
+ - **Soluzione:** Assicurati che FFmpeg sia installato e accessibile nel PATH del tuo sistema. Per gli utenti Windows, l'opzione più semplice è scaricare il file `YTSage-v-ffmpeg.exe`, che include FFmpeg.
---
-#### 🛡️ Avviso Windows Defender/Antivirus
+#### 🛡️ Avviso Windows Defender / Antivirus
-Alcuni software antivirus potrebbero contrassegnare i file `.exe` come falsi positivi. Questa è una **limitazione nota** delle applicazioni in pacchetto.
+Alcuni software antivirus potrebbero contrassegnare i file `.exe` come falsi positivi. Questa è una **limitazione nota** delle applicazioni pacchettizzate.
-**Perché ciò accade:**
-- L'euristica dell'antivirus può identificare erroneamente gli eseguibili compressi come sospetti
+**Perché succede:**
+- Le euristiche dell'antivirus potrebbero identificare erroneamente gli eseguibili pacchettizzati come sospetti.
-**Alternative sicure:**
-- ✅ **Utilizza installazione pip:** `pip install ytsage` (consigliato)
-- ✅ **Crea dal codice sorgente**: seguendo questo [guide](../.github/CI_CD_README.md)
-- ✅ **Autorizza l'applicazione** nel tuo software antivirus
+**Opzioni sicure:**
+- ✅ **Usa l'installazione tramite pip:** `pip install ytsage` (consigliato)
+- ✅ **Compila dai sorgenti**: Seguendo questa [guida](.github/CI_CD_README.md)
+- ✅ **Aggiungi l'applicazione alla whitelist** nel tuo software antivirus.
-#### 🍎 macOS: "L'app è danneggiata e non può essere aperta"
-Se visualizzi questo errore su macOS Sonoma o versioni successive, devi rimuovere l'attributo quarantena.
+#### 🍎 macOS: "L’app è danneggiata e non può essere aperta"
+Se visualizzi questo errore su macOS Sonoma o versioni successive, devi rimuovere l'attributo di quarantena.
-1. **Apri Terminale** (puoi trovarlo utilizzando Spotlight).
-2. **Digita il seguente comando** ma **non** premere ancora Invio. Assicurati di includere lo spazio alla fine:
+1. **Apri il Terminale** (puoi trovarlo usando Spotlight).
+2. **Digita il seguente comando** ma **NON** premere ancora Invio. Assicurati di includere lo spazio alla fine:
```bash
xattr -d com.apple.quarantine
```
-3. **Trascina il file `YTSage.app`** dalla finestra del Finder e rilascialo direttamente nella finestra Terminale. Questo incollerà automaticamente il percorso file corretto.
-4. **Premere Invio** per eseguire il comando.
-5. **Prova ad aprire nuovamente YTSage.app.** Ora dovrebbe avviarsi correttamente.
+3. **Trascina il file `YTSage.app` dalla finestra del Finder** e rilascialo direttamente nella finestra del Terminale. Questo incollerà automaticamente il percorso corretto del file.
+4. **Premi Invio** per eseguire il comando.
+5. **Prova a riaprire YTSage.app.** Ora dovrebbe avviarsi correttamente.
---
-#### **Posizioni di configurazione (avanzate)**
+#### **Percorsi di configurazione (Avanzato)**
- **Windows:** `%LOCALAPPDATA%\YTSage`
- **macOS:** `~/Library/Application Support/YTSage`
- **Linux:** `~/.local/share/YTSage`
@@ -432,102 +437,102 @@ Se visualizzi questo errore su macOS Sonoma o versioni successive, devi rimuover
## 💖 Sponsor
-Se YTSage ti fa risparmiare tempo, valuta la possibilità di sponsorizzare il progetto. La sponsorizzazione aiuta a coprire i tempi di sviluppo, i test su tutte le piattaforme e i miglioramenti futuri.
+Se YTSage ti fa risparmiare tempo, considera di sponsorizzare il progetto. Le sponsorizzazioni aiutano a coprire il tempo di sviluppo, i test su tutte le piattaforme e i miglioramenti futuri.
-- Sponsor GitHub: https://github.com/sponsors/oop7
-- Il collegamento allo sponsor è disponibile anche direttamente all'interno dell'app dalla finestra di dialogo Informazioni.
+- GitHub Sponsors: https://github.com/sponsors/oop7
+- Il link per la sponsorizzazione è disponibile direttamente tramite il dialogo Informazioni all'interno dell'app.
[](https://github.com/sponsors/oop7)
-
+
## 👥 Contribuire
-Diamo il benvenuto ai contributi! Ecco come puoi aiutare:
+I contributi sono benvenuti! Ecco come puoi aiutare:
-1. 🍴 Effettua il fork del repository
-2. 🌿 Crea il tuo ramo di funzionalità:
+1. 🍴 Fork del repository
+2. 🌿 Crea il tuo ramo per la funzione:
```bash
- git checkout -b feature/AmazingFeature
+ git checkout -b feature/FunzioneIncredibile
```
-3. 💾 Applica le tue modifiche:
+3. 💾 Fai il commit delle tue modifiche:
```bash
- git commit -m 'Add some AmazingFeature'
+ git commit -m 'Aggiungi FunzioneIncredibile'
```
-4. 📤 Spingere verso il ramo:
+4. 📤 Fai il push sul ramo:
```bash
- git push origin feature/AmazingFeature
+ git push origin feature/FunzioneIncredibile
```
-5. 🔄 Apri una richiesta di pull
+5. 🔄 Apri una Pull Request
### 🌍 Contribuire alle traduzioni
-- Aggiorna il file README localizzato corrispondente (ad esempio `README.es.md`)
+- Aggiorna il file README localizzato pertinente (es. `readme-translations/README.it.md`)
- Mantieni sincronizzate le stringhe dell'app modificando `ytsage/languages/.json`
-- Se manca la tua lingua, inizia da `README.md` e crea `README..md`
+- Se la tua lingua manca, parti da `README.md` e crea `README..md`
-📂 Struttura del progetto
+📂 Struttura del Progetto
-## YTSage - Struttura del progetto
+## YTSage - Struttura del Progetto
-Questo documento descrive la struttura di cartelle organizzata di YTSage.
+Questo documento descrive la struttura organizzata delle cartelle di YTSage.
-### 📁 Struttura del progetto
+### 📁 Struttura del Progetto
```
YTSage/
-├── 📁 .github/ # GitHub configuration
-│ ├── 📁 ISSUE_TEMPLATE/ # Issue templates
-│ │ └── 🐛-bug-report.md # Bug report template
-│ ├─── 📁 workflows/ # GitHub Actions workflows
-│ │ ├── build-linux.yml # Linux build workflow
-│ │ ├── build-macos.yml # macOS build workflow
-│ │ │── build-windows.yml # Windows build workflow
-| | └── release-all.yml # Master release workflow
-│ └── 📄 CI_CD_README.md # CI/CD documentation
-├── 📁 branding/ # Branding assets (Screenshots, SVGs)
-│ ├── 📁 icons/ # Application icons
-│ ├── 📁 screenshots/ # Screenshots for documentation
-│ └── 📁 svg/ # SVG assets
-├── 📄 LICENSE # License file
-├── 📄 pyproject.toml # Project metadata and dependencies
-├── 📄 README.md # Project documentation
-├── 📄 requirements.txt # Python dependencies (dev)
-└── 📁 ytsage/ # Source package
- ├── 📁 assets/ # Runtime assets
- │ ├── 📁 Icon/ # Application icons
- │ └── 📁 sound/ # Audio files
- ├── 📁 languages/ # Localization files
- │ ├── 📄 ar.json # Arabic translation
- │ ├── 📄 de.json # German translation
- │ ├── 📄 en.json # English translation
- │ └── ... # Other languages
- ├── 📁 core/ # Core business logic
- │ ├── 📄 __init__.py # Core package init
- │ ├── 📄 ytsage_deno.py # Deno integration
- │ ├── 📄 ytsage_downloader.py # Download functionality
- │ ├── 📄 ytsage_ffmpeg.py # FFmpeg integration
- │ ├── 📄 ytsage_utils.py # Utility functions
- │ └── 📄 ytsage_yt_dlp.py # yt-dlp integration
- ├── 📁 gui/ # User interface components
- │ ├── 📄 __init__.py # GUI package init
- │ ├── 📄 ytsage_gui_main.py # Main application window
- │ └── 📁 ytsage_gui_dialogs/ # Dialog classes
- ├── 📁 utils/ # Utility modules
- │ ├── 📄 __init__.py # Utils package init
- │ ├── 📄 ytsage_config_manager.py # Configuration management
- │ └── 📄 ytsage_logger.py # Logging utilities
- ├── 📄 __init__.py # Package entry point
- └── 📄 main.py # Main execution script
+├── 📁 .github/ # Configurazioni GitHub
+│ ├── 📁 ISSUE_TEMPLATE/ # Modelli per segnalazioni
+│ │ └── 🐛-bug-report.md # Modello per segnalazione bug
+│ ├─── 📁 workflows/ # Workflow GitHub Actions
+│ │ ├── build-linux.yml # Workflow build Linux
+│ │ ├── build-macos.yml # Workflow build macOS
+│ │ │── build-windows.yml # Workflow build Windows
+| | └── release-all.yml # Workflow release master
+│ └── 📄 CI_CD_README.md # Documentazione CI/CD
+├── 📁 branding/ # Asset di branding (screenshot, SVG)
+│ ├── 📁 icons/ # Icone dell'app
+│ ├── 📁 screenshots/ # Screenshot per la documentazione
+│ └── 📁 svg/ # Asset SVG
+├── 📄 LICENSE # File della licenza
+├── 📄 pyproject.toml # Metadati del progetto e dipendenze
+├── 📄 README.md # Documentazione del progetto
+├── 📄 requirements.txt # Dipendenze Python (dev)
+└── 📁 ytsage/ # Pacchetto del codice sorgente
+ ├── 📁 assets/ # Asset runtime
+ │ ├── 📁 Icon/ # Icone dell'app
+ │ └── 📁 sound/ # File audio
+ ├── 📁 languages/ # File di localizzazione
+ │ ├── 📄 ar.json # Traduzione araba
+ │ ├── 📄 de.json # Traduzione tedesca
+ │ ├── 📄 en.json # Traduzione inglese
+ │ └── ... # Altre lingue
+ ├── 📁 core/ # Logica di business principale
+ │ ├── 📄 __init__.py
+ │ ├── 📄 ytsage_deno.py # Integrazione Deno
+ │ ├── 📄 ytsage_downloader.py # Funzionalità di download
+ │ ├── 📄 ytsage_ffmpeg.py # Integrazione FFmpeg
+ │ ├── 📄 ytsage_utils.py # Funzioni di utilità
+ │ └── 📄 ytsage_yt_dlp.py # Integrazione yt-dlp
+ ├── 📁 gui/ # Componenti dell'interfaccia utente
+ │ ├── 📄 __init__.py
+ │ ├── 📄 ytsage_gui_main.py # Finestra principale dell'app
+ │ └── 📁 ytsage_gui_dialogs/ # Classi per i dialoghi
+ ├── 📁 utils/ # Moduli di utilità
+ │ ├── 📄 __init__.py
+ │ ├── 📄 ytsage_config_manager.py # Gestione configurazione
+ │ └── 📄 ytsage_logger.py # Strumenti di logging
+ ├── 📄 __init__.py # Punto di ingresso del pacchetto
+ └── 📄 main.py # Script di esecuzione principale
```
-## ⭐️ Storia delle stelle
+## ⭐️ Cronologia Stelle
-## Storia delle stelle
+## Star History
@@ -541,63 +546,64 @@ YTSage/
## 📜 Licenza
-Questo progetto è concesso in licenza con la licenza MIT: per i dettagli vedere il file [LICENSE](../LICENSE).
+Questo progetto è rilasciato sotto Licenza MIT - vedi il file [LICENSE](LICENSE) per i dettagli.
-## 🙏Ringraziamenti
+## 🙏 Ringraziamenti
Mostra Ringraziamenti
-Un sentito ringraziamento a tutti coloro che hanno contribuito a questo progetto aprendo un issue per suggerire un miglioramento o segnalare un bug.
+Un grande ringraziamento a tutti coloro che hanno contribuito a questo progetto aprendo segnalazioni per suggerire miglioramenti o segnalare bug.
- Componenti principali Componenti Principali
yt-dlp
- Scarica motore
+ Motore di Download
FFmpeg
- Elaborazione multimediale
+ Elaborazione Media
Deno
- Runtime per integrazione con yt-dlp
+ Runtime per l'integrazione di yt-dlp
- Librerie e framework Librerie e Framework
PySide6
Framework GUI
- Cuscino
- Elaborazione immagini
+ Pillow
+ Elaborazione Immagini
- richieste
+
+ requests
Richieste HTTP
- imballaggio
- Gestione versioni e pacchetti
+ packaging
+ Gestione Versioni e Packaging
- ribasso
- Rendering riduzione
+ markdown
+ Rendering Markdown
loguru
- Registrazione
+ Logging
- Risorse e contributori Asset e Collaboratori
- Nuova notifica 09 di Universfield
- Suono di notifica
+ New Notification 09 di Universfield
+ Suono di Notifica
viru185
- Codice Contributore
+ Collaboratore al Codice
@@ -607,12 +613,12 @@ Questo progetto è concesso in licenza con la licenza MIT: per i dettagli vedere
## ⚠️ Disclaimer
-Questo strumento è solo per uso personale. Rispetta i termini di servizio di YouTube e i diritti dei creatori di contenuti.
+Questo strumento è solo per uso personale. Rispettate i Termini di Servizio di YouTube e i diritti dei produttori di contenuti.
---
-Realizzato con ❤️ da [oop7](https://github.com/oop7)
+Creato con ❤️ da [oop7](https://github.com/oop7)