diff --git a/readme-translations/README.pl.md b/readme-translations/README.pl.md index 25e867c..a8c78e5 100644 --- a/readme-translations/README.pl.md +++ b/readme-translations/README.pl.md @@ -12,81 +12,82 @@ [![PyPI version](https://img.shields.io/pypi/v/ytsage?color=c90000&style=for-the-badge&logo=pypi&logoColor=white)](https://pypi.org/project/ytsage/) [![GitHub Sponsors](https://img.shields.io/github/sponsors/oop7?color=c90000&style=for-the-badge&logo=githubsponsors&logoColor=white)](https://github.com/sponsors/oop7) -**Nowoczesny downloader YouTube z przejrzystym interfejsem PySide6.** -Pobieraj filmy w dowolnej jakości, wyodrębniaj dźwięk, pobieraj napisy i nie tylko. +**Nowoczesny downloader YouTube z czystym interfejsem PySide6.** +Pobieraj wideo w dowolnej jakości, wyodrębniaj audio, pobieraj napisy i wiele więcej. -### 🌍 PRZECZYTAJ Języki +### 🌍 Języki README Angielski: [EN](../README.md) -| Numer telefonu: [AR](README.ar.md) +| Arabski: [AR](README.ar.md) | Niemiecki: [DE](README.de.md) | Hiszpański: [ES](README.es.md) -| Français: [FR](README.fr.md) -| हिन्दी: [HI](README.hi.md) -| Bahasa Indonezja: [ID](README.id.md) -| włoski: [IT](README.it.md) -| 日本語: [JA](README.ja.md) +| Francuski: [FR](README.fr.md) +| Hindi: [HI](README.hi.md) +| Indonezyjski: [ID](README.id.md) +| Włoski: [IT](README.it.md) +| Japoński: [JA](README.ja.md) | Polski: [PL](README.pl.md) | Portugalski: [PT](README.pt.md) | Rosyjski: [RU](README.ru.md) | Turecki: [TR](README.tr.md) -| Nazwa: [ZH](README.zh.md) +| Chiński: [ZH](README.zh.md)

- Instalacja • - Funkcje • - Użycie • - Zrzuty ekranu • - Rozwiązywanie problemów • + Instalacja • + Funkcje • + Użycie • + Zrzuty ekranu • + Rozwiązywanie problemów • Sponsor • - Wspieranie + Współpraca

--- - + ## ❓ Dlaczego YTSage? -YTSage jest przeznaczony dla użytkowników, którzy chcą **prostego, ale potężnego narzędzia do pobierania YouTube**. W odróżnieniu od innych narzędzi oferuje: +YTSage został zaprojektowany dla użytkowników, którzy chcą **prostego, ale potężnego downloadera YouTube**. W przeciwieństwie do innych narzędzi oferuje: -- Czysty, nowoczesny interfejs PySide6 +- Nowoczesny i czysty interfejs PySide6 - Pobieranie wideo, audio i napisów jednym kliknięciem -- Zaawansowane funkcje, takie jak SponsorBlock, łączenie napisów i wybór listy odtwarzania -- Opcjonalny tryb ogólny dla witryn obsługujących yt-dlp poza YouTube +- Zaawansowane funkcje, takie jak SponsorBlock, scalanie napisów i wybór playlisty +- Opcjonalny tryb ogólny (Generic Mode) dla stron spoza YouTube obsługiwanych przez yt-dlp - Obsługa wielu platform i łatwa instalacja - + ## ✨ Funkcje
-| Podstawowe funkcje | Zaawansowane funkcje | Dodatkowe funkcje | -|----------------------------------|------------------------------------------------------|-----------------------------------| -| 🎥 Formatuj tabelę | 🚫 Integracja z blokiem sponsorskim | 🎞️ Wyświetlacz FPS/HDR | -| 🎵 Ekstrakcja dźwięku | 📝 Wybierz i połącz wiele napisów | 🔄 Automatyczna aktualizacja yt-dlp | -| ✨ Prosty interfejs użytkownika | 💾 Zapisz opis i miniaturę | 🛠️ Wykrywanie FFmpeg/yt-dlp/Deno | -| 📋 Obsługa i wybór list odtwarzania | 🚀 Ogranicznik prędkości | ⚙️ Polecenia niestandardowe | -| 📑 Umieść rozdziały | ✂️ Przytnij sekcje wideo | 🍪 Zaloguj się za pomocą plików cookie | -| 📜 Pobierz historię | 🔄 Zwolnij wybór kanału | 🌐 Wsparcie proxy | -| 🎚️ Konwersja formatu audio | 🎬 Ustawienia formatu wideo | 🆙 Wbudowana zakładka Aktualizator | -| 🌍 Tryb ogólny | 🔊 Normalizacja dźwięku (EBU R128) | 🌍 Lokalizacja w 14 językach | +| Funkcje podstawowe | Funkcje zaawansowane | Funkcje dodatkowe | +|-----------------------------------|-----------------------------------------|------------------------------------| +| 🎥 Tabela formatów | 🚫 Integracja SponsorBlock | 🎞️ Wyświetlanie FPS/HDR | +| 🎵 Wyodrębnianie audio | 📝 Wybór i scalanie napisów | 🔄 Auto-aktualizacja yt-dlp | +| ✨ Prosty interfejs użytkownika | 💾 Zapis opisu i miniatur | 🛠️ Wykrywanie FFmpeg/yt-dlp/Deno | +| 📋 Obsługa i wybór playlist | 🚀 Ogranicznik prędkości | ⚙️ Własne komendy | +| 📑 Integracja rozdziałów | ✂️ Przycinanie sekcji wideo | 🍪 Logowanie przez ciasteczka | +| 📜 Historia pobierania | 🔄 Wybór kanału wydań | 🌐 Obsługa proxy | +| 🎚️ Konwersja formatów audio | 🎬 Ustawienia formatu wideo | 🆙 Zintegrowana karta aktualizacji | +| 🌍 Tryb ogólny | 🔊 Normalizacja audio (EBU R128) | 🌍 Lokalizacja w 14 językach | +| 💾 Eksport playlisty | ⚙️ Domyślna jakość i napisy | |
- + ## 🚀 Instalacja -### ⚡ Szybka instalacja (zalecane) +### ⚡ Szybka instalacja (zalecana) -Zainstaluj YTSage z PyPI: +Zainstaluj YTSage przez PyPI: ```bash pip install ytsage ```
-🔄 Zaktualizuj istniejącą instalację +🔄 Aktualizacja istniejącej instalacji ```bash pip install --upgrade ytsage @@ -100,33 +101,33 @@ Następnie uruchom aplikację: ytsage ``` -### 📦 Gotowe pliki wykonywalne +### 📦 Gotowe pliki wykonywalne (Executable) -> [👉 Download Latest Release](https://github.com/oop7/YTSage/releases/latest) +> [👉 Pobierz najnowsze wydanie](https://github.com/oop7/YTSage/releases/latest) -#### 🪟 Okna +#### 🪟 Windows -| Formatuj | Opis | -|------------|------------| +| Format | Opis | +|--------|-------------| | ![Windows EXE](https://img.shields.io/badge/Windows-EXE-0078D6?style=for-the-badge&logo=windows&logoColor=white) | Standardowy instalator | -| ![Windows FFmpeg](https://img.shields.io/badge/Windows-FFmpeg-0078D6?style=for-the-badge&logo=windows&logoColor=white) | Z pakietem FFmpeg | +| ![Windows FFmpeg](https://img.shields.io/badge/Windows-FFmpeg-0078D6?style=for-the-badge&logo=windows&logoColor=white) | Z dołączonym FFmpeg | | ![Windows Portable](https://img.shields.io/badge/Windows-Portable-0078D6?style=for-the-badge&logo=windows&logoColor=white) | Wersja przenośna, nie wymaga instalacji | -| ![Windows Portable FFmpeg](https://img.shields.io/badge/Windows-Portable%20FFmpeg-0078D6?style=for-the-badge&logo=windows&logoColor=white) | Przenośny z FFmpeg, spakowany | +| ![Windows Portable FFmpeg](https://img.shields.io/badge/Windows-Portable%20FFmpeg-0078D6?style=for-the-badge&logo=windows&logoColor=white) | Przenośna z FFmpeg, skompresowana (ZIP) |
🛠️ Kroki instalacji -1. **Instalator EXE (`.exe`)**: Kliknij dwukrotnie plik i postępuj zgodnie z instrukcjami kreatora instalacji. -2. **Wersja przenośna (`.zip`)**: Wypakuj archiwum do wybranej lokalizacji i uruchom `ytsage.exe`. -3. **FFmpeg w pakiecie**: Wybierz wersję w pakiecie FFmpeg, jeśli nie masz zainstalowanego FFmpeg w swoim systemie. +1. **Instalator EXE (`.exe`)**: Kliknij dwukrotnie plik i postępuj zgodnie z instrukcjami kreatora. +2. **Wersja przenośna (`.zip`)**: Rozpakuj archiwum w wybranym miejscu i uruchom `ytsage.exe`. +3. **Wbudowany FFmpeg**: Jeśli nie masz zainstalowanego FFmpeg w systemie, wybierz wersję z dołączonym FFmpeg.
#### 🐧 Linux -| Formatuj | Opis | -|------------|------------| -| ![Linux DEB](https://img.shields.io/badge/Linux-DEB-FCC624?style=for-the-badge&logo=linux&logoColor=black) | Pakiet Debiana | -| ![Linux AppImage](https://img.shields.io/badge/Linux-AppImage-FCC624?style=for-the-badge&logo=linux&logoColor=black) | Obraz aplikacji, przenośny | +| Format | Opis | +|--------|-------------| +| ![Linux DEB](https://img.shields.io/badge/Linux-DEB-FCC624?style=for-the-badge&logo=linux&logoColor=black) | Pakiet Debian | +| ![Linux AppImage](https://img.shields.io/badge/Linux-AppImage-FCC624?style=for-the-badge&logo=linux&logoColor=black) | AppImage, przenośny | | ![Linux RPM](https://img.shields.io/badge/Linux-RPM-FCC624?style=for-the-badge&logo=linux&logoColor=black) | Pakiet RPM | | ![Flathub](https://img.shields.io/badge/Linux-Flatpak-FCC624?style=for-the-badge&logo=flathub&logoColor=black) | Pakiet Flatpak | @@ -136,18 +137,18 @@ ytsage - **DEB (`.deb`)**: ```bash sudo dpkg -i ytsage_*.deb - sudo apt-get install -f # Fix missing dependencies if any + sudo apt-get install -f # Jeśli trzeba naprawić brakujące zależności ``` - **RPM (`.rpm`)**: ```bash sudo rpm -i ytsage-*.rpm ``` -- **Obraz aplikacji (`.AppImage`)**: +- **AppImage (`.AppImage`)**: ```bash chmod +x YTSage-*.AppImage ./YTSage-*.AppImage ``` -- **Flatpak**: Postępuj zgodnie z instrukcjami na Flathubie lub uruchom: +- **Flatpak**: Postępuj zgodnie z instrukcjami na Flathub lub uruchom: ```bash flatpak install flathub io.github.oop7.ytsage ``` @@ -155,24 +156,24 @@ ytsage #### 🍎 macOS -| Formatuj | Opis | -|------------|------------| -| ![macOS ARM64 APP](https://img.shields.io/badge/macOS-ARM64%20APP-000000?style=for-the-badge&logo=apple&logoColor=white) | Spakowana aplikacja dla Apple Silicon | -| ![macOS ARM64 DMG](https://img.shields.io/badge/macOS-ARM64%20DMG-000000?style=for-the-badge&logo=apple&logoColor=white) | Instalator obrazu dysku dla Apple Silicon | +| Format | Opis | +|--------|-------------| +| ![macOS ARM64 APP](https://img.shields.io/badge/macOS-ARM64%20APP-000000?style=for-the-badge&logo=apple&logoColor=white) | Aplikacja ZIP dla Apple Silicon | +| ![macOS ARM64 DMG](https://img.shields.io/badge/macOS-ARM64%20DMG-000000?style=for-the-badge&logo=apple&logoColor=white) | Instalator Disk Image dla Apple Silicon |
🛠️ Kroki instalacji - **Instalator DMG (`.dmg`)**: Kliknij dwukrotnie, aby zamontować, a następnie przeciągnij `YTSage.app` do folderu Aplikacje. -- **Archiwum aplikacji (`.zip`)**: Wypakuj plik ZIP i przenieś `YTSage.app` do folderu Aplikacje. +- **Archiwum aplikacji (`.zip`)**: Rozpakuj ZIP i przenieś `YTSage.app` do folderu Aplikacje. -*Uwaga: jeśli napotkasz błąd „Aplikacja jest uszkodzona”, zobacz [macOS troubleshooting section](#troubleshooting) poniżej.* +*Uwaga: Jeśli otrzymasz błąd "Aplikacja jest uszkodzona", zapoznaj się z sekcją rozwiązywania problemów macOS poniżej.*
---
-💻 Instalacja ręczna ze źródła +💻 Ręczna instalacja ze źródeł ### 1. Sklonuj repozytorium @@ -183,13 +184,13 @@ cd YTSage ### 2. Zainstaluj zależności -#### ⚡ Z uv +#### ⚡ Z użyciem uv ```bash uv pip install . ``` -#### 📦 Lub ze standardową końcówką +#### 📦 Lub ze standardowym pip ```bash pip install . @@ -203,226 +204,230 @@ python -m ytsage.main
- + ## 📸 Zrzuty ekranu
- - + + - - + + - - + +
Download SettingsPlaylist DownloadUstawienia pobieraniaPobieranie playlisty
Pobierz ustawieniaPobieranie listy odtwarzaniaUstawienia pobieraniaPobieranie playlisty
Audio Format Selection with Save ThumbnailCustom OptionsWybór formatu audioOpcje niestandardowe
Format audio Opcje niestandardowe
-
+ + ## 📖 Użycie
🎯 Podstawowe użycie 1. **Uruchom YTSage** -2. **Wklej adres URL YouTube** (lub użyj przycisku „Wklej adres URL”) -3. **Kliknij „Analizuj”** +2. **Wklej URL z YouTube** (lub użyj przycisku "Wklej URL") +3. **Kliknij "Analizuj"** 4. **Wybierz format:** - - `Video` do pobierania plików wideo - - `Audio Only` do ekstrakcji dźwięku + - `Wideo` dla pobierania wideo + - `Tylko audio` dla wyodrębniania dźwięku 5. **Wybierz opcje:** - Włącz napisy i wybierz język - Włącz scalanie napisów - Zapisz miniaturę - - Usuń segmenty sponsorów + - Usuń sekcje sponsorowane - Zapisz opis - - Osadzaj rozdziały -6. **Wybierz katalog wyjściowy** -7. **Kliknij „Pobierz”** + - Osadź rozdziały +6. **Wybierz folder wyjściowy** +7. **Kliknij "Pobierz"** -> 💡 Domyślnym katalogiem pobierania jest folder „Pobrane” użytkownika. +> 💡 Domyślny folder pobierania to folder "Pobrane" użytkownika.
-📋 Pobieranie listy odtwarzania +📋 Pobieranie playlisty -1. **Wklej adres URL listy odtwarzania** -2. **Kliknij „Analizuj”** -3. **Wybierz filmy z selektora playlist (opcjonalnie, domyślnie wszystkie)** +1. **Wklej URL playlisty** +2. **Kliknij "Analizuj"** +3. **Wybierz filmy z selektora (opcjonalnie, domyślnie wszystkie)** 4. **Wybierz żądany format/jakość** -5. **Kliknij „Pobierz”** +5. **Kliknij "Pobierz"** -> 💡 Aplikacja automatycznie obsługuje kolejkę pobierania +> 💡 Aplikacja automatycznie zarządza kolejką pobierania, a wpisy playlisty możesz eksportować do plików `.txt`, `.csv`, `.m3u` lub `.json`.
-🌍 Tryb ogólny dla witryn innych niż YouTube +🌍 Tryb ogólny dla stron innych niż YouTube -Użyj trybu ogólnego, jeśli chcesz, aby YTSage akceptował adresy URL z witryn obsługiwanych przez yt-dlp, takich jak Dailymotion, CBC Gem, TikTok i inne. +Użyj trybu ogólnego (Generic Mode), gdy chcesz, aby YTSage akceptował adresy URL ze stron obsługiwanych przez yt-dlp, takich jak Dailymotion, CBC Gem, TikTok i inne. -Jak z niego korzystać: +Jak go użyć: 1. Otwórz `Download Settings`. 2. Włącz `Generic Mode`. -3. Wklej obsługiwany adres URL filmu lub listy odtwarzania spoza YouTube. +3. Wklej obsługiwany URL wideo lub playlisty spoza YouTube. 4. Kliknij `Analyze`. 5. Wybierz format i pobierz jak zwykle. Uwagi: -- Tryb ogólny zmienia tylko weryfikację adresu URL w YTSage. Witryna docelowa musi nadal być obsługiwana przez zainstalowaną wersję yt-dlp. -- Niektóre witryny wymagają plików cookie, sesji logowania, serwera proxy lub dodatkowych argumentów yt-dlp, w zależności od ekstraktora. -- Jeśli witryna ulegnie awarii, przed zgłoszeniem problemu zaktualizuj najpierw yt-dlp z wbudowanej karty aktualizatora. +- Tryb ogólny zmienia tylko walidację adresu URL wewnątrz YTSage. Strona docelowa musi być nadal obsługiwana przez zainstalowaną wersję yt-dlp. +- Niektóre strony wymagają ciasteczek, logowania, proxy lub dodatkowych argumentów yt-dlp w zależności od ekstraktora. +- Jeśli strona nie działa, zaktualizuj yt-dlp ze zintegrowanej karty aktualizacji przed zgłoszeniem problemu.
-🧰 Opcje multimediów i pobierania +🧰 Opcje mediów i pobierania -- **Opcje napisów:** Filtruj języki i osadzaj napisy w pliku wideo -- **Scalanie napisów:** Łączenie napisów z plikiem wideo w celu uzyskania napisów zakodowanych na stałe -- **Zapisz opis:** Zapisz opis filmu jako plik tekstowy -- **Zapisz miniaturę:** zapisz miniaturę wideo jako plik obrazu -- **Osadzanie rozdziałów:** Osadzanie znaczników rozdziałów jako metadanych dla zgodnych odtwarzaczy wideo -- **Usuń segmenty sponsora:** Usuń segmenty sponsora z filmu za pomocą funkcji SponsorBlock -- **Przytnij wideo:** Pobierz tylko określone fragmenty filmu, określając zakresy czasu w formacie `HH:MM:SS` +- **Opcje napisów:** Filtruj języki i osadzaj napisy w pliku wideo. +- **Scalanie napisów:** Scala napisy z plikiem wideo (hardcoded). +- **Zapis opisu:** Zapisuje opis wideo jako plik tekstowy. +- **Zapis miniatury:** Zapisuje miniaturę wideo jako plik graficzny. +- **Osadź rozdziały:** Dołącza znaczniki rozdziałów jako metadane dla kompatybilnych odtwarzaczy. +- **Usuń sekcje sponsorowane:** Używa SponsorBlock do usuwania segmentów sponsorowanych z filmu. +- **Przycinanie wideo:** Pobieraj tylko określone części filmu, określając zakres czasu w formacie `GG:MM:SS`.
-⚙️ Ustawienia wyjściowe i plikowe +⚙️ Ustawienia wyjściowe i plików + +- **Ogranicznik prędkości:** Ogranicz prędkość pobierania, np. `500K` dla 500 KB/s. +- **Zapisz ścieżkę pobierania:** Zapisuje domyślną ścieżkę dla przyszłych pobrań. Dostępne w **Download Settings → Download Path**. +- **Domyślna rozdzielczość wideo:** Ustaw preferowaną rozdzielczość dla automatycznego wyboru (np. 1080p, 720p). Dostępne w **Download Settings → Default Video Resolution**. +- **Domyślne języki napisów:** Ustaw domyślne języki dla automatycznego wyboru (rozdzielone przecinkami, np. `pl,en`). Dostępne w **Download Settings → Default Subtitle Languages**. +- **Format nazwy pliku:** Dostosuj format nazwy pliku wyjściowego, używając zmiennych takich jak `%(title)s`, `%(uploader)s`, `%(playlist_index)s` i `%(resolution)s`. Dostępne w **Download Settings → Filename Format**. +- **Wymuś format wyjściowy:** Wymuś pobieranie wideo do konkretnego formatu kontenera, jak `mp4`, `webm` lub `mkv`. Dostępne w **Download Settings → Output Format Settings**. +- **Konwersja formatów audio:** Konwertuj pobierany dźwięk do preferowanego formatu, takiego jak `AAC`, `MP3`, `FLAC`, `WAV`, `Opus`, `M4A`, `Vorbis` lub `Best`. Dostępne w **Download Settings → Audio Format Settings**. +- **Normalizacja audio:** Ujednolica głośność pobieranego dźwięku przy użyciu EBU R128. +- **Jednoczesne połączenia:** Znacznie zwiększa prędkość pobierania, pobierając pliki w kilku częściach naraz. Dostępne w **Download Settings → General → Concurrent Connections** (domyślnie 1, zalecane maks. 8-10, aby uniknąć blokad IP). -- **Ogranicznik prędkości:** Ogranicz prędkość pobierania, na przykład `500K` dla 500 KB/s -- **Zapisz ścieżkę pobierania:** zapisz domyślną ścieżkę pobierania dla przyszłych pobrań. Dostępne w **Ustawienia pobierania → Ścieżka pobierania**. -- **Format nazwy pliku wyjściowego:** Dostosuj format nazwy pliku wyjściowego za pomocą zmiennych takich jak `%(title)s`, `%(uploader)s` i `%(resolution)s`. Dostępne w **Ustawienia pobierania → Format nazwy pliku**. -- **Wymuś format wyjściowy:** Wymuś pobieranie plików wideo w określonym formacie kontenera, takim jak `mp4`, `webm` lub `mkv`. Dostępne w **Ustawienia pobierania → Ustawienia formatu wyjściowego**. -- **Konwersja formatu audio:** Konwertuj pliki do pobrania zawierające wyłącznie dźwięk do preferowanych formatów, takich jak `AAC`, `MP3`, `FLAC`, `WAV`, `Opus`, `M4A`, `Vorbis` lub `Best`. Dostępne w **Ustawienia pobierania → Ustawienia formatu audio**. -- **Normalizacja dźwięku:** Ujednolicenie głośności pobieranych plików zawierających wyłącznie dźwięk za pomocą EBU R128. -- **Jednoczesne połączenia:** Znacznie zwiększ prędkość pobierania, pobierając pliki w wielu fragmentach jednocześnie. Dostępne w **Ustawienia pobierania → Ogólne → Jednoczesne połączenia** (Domyślnie 1, zalecane maksimum to 8-10, aby zapobiec blokowaniu IP).\n
🌐 Dostęp i sieć -- **Zaloguj się za pomocą plików cookie:** zaloguj się do YouTube za pomocą plików cookie, aby uzyskać dostęp do prywatnych treści. - Jak z niego korzystać: - 1. **Zalecane:** Skorzystaj z wbudowanej opcji `Extract cookies from browser` w aplikacji, a następnie wybierz przeglądarkę i opcjonalnie profil. - 2. Alternatywnie wyodrębnij pliki cookie ręcznie: - a. Eksportuj pliki cookie ze swojej przeglądarki za pomocą rozszerzenia takiego jak [cookie-editor](https://github.com/moustachauve/cookie-editor?tab=readme-ov-file) - b. Skopiuj pliki cookie w formacie Netscape - c. Utwórz plik o nazwie `cookies.txt` i wklej do niego pliki cookie +- **Logowanie przez ciasteczka:** Zaloguj się do YouTube, używając ciasteczek, aby uzyskać dostęp do prywatnych treści. + Użycie: + 1. **Zalecane:** Użyj wbudowanej opcji `Eksportuj ciasteczka z przeglądarki`, a następnie wybierz przeglądarkę i opcjonalnie profil. + 2. Alternatywnie, wyeksportuj ciasteczka ręcznie: + a. Eksportuj ciasteczka z przeglądarki, używając rozszerzenia typu [cookie-editor](https://github.com/moustachauve/cookie-editor?tab=readme-ov-file) + b. Skopiuj ciasteczka w formacie Netscape + c. Utwórz plik o nazwie `cookies.txt` i wklej ciasteczka d. Wybierz plik `cookies.txt` w aplikacji -- **Obsługa proxy:** Do pobierania używaj serwera proxy, na przykład `http://:` -- **Tryb ogólny:** Zezwól YTSage na analizowanie i pobieranie z witryn innych niż YouTube obsługiwanych przez yt-dlp. Włącz tę opcję w **Ustawienia pobierania → Tryb ogólny**. +- **Obsługa proxy:** Użyj serwera proxy do pobierania, np. `http://:` +- **Tryb ogólny:** Pozwala YTSage na analizę i pobieranie z witryn innych niż YouTube obsługiwanych przez yt-dlp. Włącz w **Download Settings → Generic Mode**.
🛠️ Narzędzia i konserwacja -- **Niestandardowe polecenia:** Dostęp do zaawansowanych funkcji yt-dlp poprzez argumenty wiersza poleceń -- **Karta Aktualizator:** Zarządzaj wbudowanymi narzędziami aktualizacji z jednego miejsca w Opcjach niestandardowych: - - **Aktualizacje yt-dlp:** sprawdź dostępność aktualizacji i przełączaj się między kanałami wersji stabilnej i nocnej - - **Kontrola wersji FFmpeg:** Sprawdź wersję FFmpeg i otwórz przewodniki instalacji - - **Aktualizacje Deno:** Sprawdź i zaktualizuj środowisko wykonawcze Deno -- **Wykrywanie FFmpeg/yt-dlp/Deno:** Automatycznie wykrywa ścieżki i wersje FFmpeg, yt-dlp i Deno w oknie dialogowym Informacje. -- **Historia pobierania:** Przeglądaj wcześniejsze pobrania z miniaturami i statusami za pomocą przycisku **Historia**. +- **Własne komendy:** Dostęp do zaawansowanych funkcji yt-dlp poprzez argumenty wiersza poleceń. +- **Karta aktualizacji:** Zarządzaj wbudowanymi narzędziami aktualizacji z jednego miejsca w opcjach niestandardowych: + - **Aktualizacja yt-dlp:** Sprawdzaj aktualizacje i przełączaj się między kanałami Stable i Nightly. + - **Sprawdzanie wersji FFmpeg:** Weryfikuj wersję FFmpeg i otwieraj przewodniki instalacji. + - **Aktualizacja Deno:** Sprawdzaj i aktualizuj środowisko uruchomieniowe Deno. +- **Wykrywanie FFmpeg/yt-dlp/Deno:** Automatycznie wykrywa ścieżki i wersje FFmpeg, yt-dlp i Deno w oknie "O programie". +- **Historia pobierania:** Przeglądaj poprzednie pobrania z miniaturami i statusami za pomocą przycisku **History**.
🌍 Lokalizacja -YTSage obsługuje **14 języków**, zapewniając dostępność na całym świecie. Wybierz preferowany język z **Opcje niestandardowe → Język**. +YTSage obsługuje **14 języków**. Wybierz preferowany język w **Custom Options → Language**. ### Obsługiwane języki | Język | Kod | Język | Kod | -|---------|------|----------|------| +|----------|------|----------|------| | 🇺🇸 Angielski | `en` | 🇪🇸 Hiszpański | `es` | -| 🇸🇦 arabski | `ar` | 🇫🇷 Francuski | `fr` | -| 🇩🇪 niemiecki | `de` | 🇮🇳 hindi | `hi` | -| 🇮🇩 Indonezyjski | `id` | 🇮🇹 włoski | `it` | -| 🇯🇵 Japoński | `ja` | 🇵🇱polski | `pl` | -| 🇧🇷 portugalski | `pt` | 🇷🇺 Rosyjski | `ru` | -| 🇹🇷 Turecki | `tr` | 🇨🇳 chiński | `zh` | +| 🇸🇦 Arabski | `ar` | 🇫🇷 Francuski | `fr` | +| 🇩🇪 Niemiecki | `de` | 🇮🇳 Hindi | `hi` | +| 🇮🇩 Indonezyjski | `id` | 🇮🇹 Włoski | `it` | +| 🇯🇵 Japoński | `ja` | 🇵🇱 Polski | `pl` | +| 🇧🇷 Portugalski | `pt` | 🇷🇺 Rosyjski | `ru` | +| 🇹🇷 Turecki | `tr` | 🇨🇳 Chiński | `zh` | ### Tłumaczenia README | Język | Plik | Język | Plik | -|---------|------|----------|------| -| 🇺🇸 Angielski | [README.md](../README.md) | 🇪🇸 Hiszpański | [README.es.md](README.es.md) -| 🇸🇦 arabski | [README.ar.md](README.ar.md) | 🇫🇷 Francuski | [README.fr.md](README.fr.md) | -| 🇩🇪 niemiecki | [README.de.md](README.de.md) | 🇮🇳 hindi | [README.hi.md](README.hi.md) | -| 🇮🇩 Indonezyjski | [README.id.md](README.id.md) | 🇮🇹 włoski | [README.it.md](README.it.md) | -| 🇯🇵 Japoński | [README.ja.md](README.ja.md) | 🇵🇱polski | [README.pl.md](README.pl.md) | -| 🇧🇷 portugalski | [README.pt.md](README.pt.md) | 🇷🇺 Rosyjski | [README.ru.md](README.ru.md) | -| 🇹🇷 Turecki | [README.tr.md](README.tr.md) | 🇨🇳 chiński | [README.zh.md](README.zh.md) | +|----------|------|----------|------| +| 🇺🇸 Angielski | [README.md](README.md) | 🇪🇸 Hiszpański | [README.es.md](README.es.md) | +| 🇸🇦 Arabski | [README.ar.md](README.ar.md) | 🇫🇷 Francuski | [README.fr.md](README.fr.md) | +| 🇩🇪 Niemiecki | [README.de.md](README.de.md) | 🇮🇳 Hindi | [README.hi.md](README.hi.md) | +| 🇮🇩 Indonezyjski | [README.id.md](README.id.md) | 🇮🇹 Włoski | [README.it.md](README.it.md) | +| 🇯🇵 Japoński | [README.ja.md](README.ja.md) | 🇵🇱 Polski | [README.pl.md](README.pl.md) | +| 🇧🇷 Portugalski | [README.pt.md](README.pt.md) | 🇷🇺 Rosyjski | [README.ru.md](README.ru.md) | +| 🇹🇷 Turecki | [README.tr.md](README.tr.md) | 🇨🇳 Chiński | [README.zh.md](README.zh.md) | -> 💡 **Chcesz dodać tłumaczenie?** Sprawdź sekcję [Contributing](#contributing), aby pomóc nam dodać więcej języków! +> 💡 **Chcesz pomóc w tłumaczeniu?** Sprawdź sekcję [Współpraca](#współpraca), aby pomóc nam dodać więcej języków!
- + ## 🛠️ Rozwiązywanie problemów
-Kliknij, aby wyświetlić typowe problemy i rozwiązania +Kliknij, aby zobaczyć typowe problemy i rozwiązania -- **Tabela formatów nie wyświetla się:** Aktualizuj yt-dlp do najnowszej wersji i co wieczór przełączaj się na yt-dlp. -- **Pobieranie nie powiodło się:** Sprawdź swoje połączenie internetowe i upewnij się, że plik wideo jest dostępny. -- **Specyficzne błędy pobierania:** - - **Prywatne filmy:** Użyj uwierzytelniania plików cookie, aby uzyskać dostęp do prywatnych treści. - - **Treści z ograniczeniami wiekowymi:** Zaloguj się do konta YouTube, aby oglądać filmy z ograniczeniami wiekowymi. - - **Filmy z blokadą geograficzną:** rozważ użycie VPN w celu ominięcia ograniczeń regionalnych. - - **Usunięte/usunięte filmy:** Film nie jest już dostępny w serwisie YouTube. - - **Transmisje na żywo:** Transmisji na żywo nie można pobrać; poczekaj, aż strumień się zakończy. - - **Błędy sieciowe:** Sprawdź swoje połączenie internetowe i spróbuj ponownie. - - **Nieprawidłowe adresy URL:** Upewnij się, że adres URL jest poprawny i pochodzi z obsługiwanej platformy. - – **Treści premium:** wymaga członkostwa YouTube Premium. - - **Bloki dotyczące praw autorskich:** Treść jest blokowana ze względu na ograniczenia praw autorskich. -- **Oddziel pliki wideo i audio po pobraniu:** Dzieje się tak, gdy brakuje FFmpeg lub nie został on wykryty. YTSage wymaga FFmpeg do łączenia wysokiej jakości strumieni wideo i audio. - - **Rozwiązanie:** Upewnij się, że FFmpeg jest zainstalowany i dostępny w PATH twojego systemu. Dla użytkowników systemu Windows najłatwiejszą opcją jest pobranie pliku `YTSage-v-ffmpeg.exe`, który jest dostarczany w pakiecie z FFmpeg. +- **Tabela formatów nie pojawia się:** Zaktualizuj yt-dlp do najnowszej wersji i spróbuj przełączyć się na kanał yt-dlp Nightly. +- **Pobieranie nie powiodło się:** Sprawdź połączenie z internetem i upewnij się, że wideo jest dostępne. +- **Konkretne błędy pobierania:** + - **Prywatne wideo:** Użyj uwierzytelniania przez ciasteczka, aby uzyskać dostęp do prywatnych treści. + - **Treści z ograniczeniem wiekowym:** Zaloguj się na swoje konto YouTube, aby wyświetlić filmy z ograniczeniem wiekowym. + - **Wideo z blokadą regionalną:** Rozważ użycie VPN, aby obejść ograniczenia regionalne. + - **Usunięte wideo:** Film nie jest już dostępny na YouTube. + - **Transmisje na żywo:** Transmisji na żywo nie można pobierać w trakcie ich trwania; poczekaj, aż transmisja się zakończy. + - **Błędy sieciowe:** Sprawdź połączenie z internetem i spróbuj ponownie. + - **Nieprawidłowy URL:** Upewnij się, że adres URL jest poprawny i pochodzi z obsługiwanej platformy. + - **Treść Premium:** Wymaga subskrypcji YouTube Premium. + - **Blokada praw autorskich:** Treść jest zablokowana z powodu ograniczeń praw autorskich. +- **Pliki wideo i audio są oddzielne po pobraniu:** Dzieje się tak, gdy brakuje FFmpeg lub nie został on wykryty. YTSage wymaga FFmpeg do scalania strumieni wideo i audio wysokiej jakości. + - **Rozwiązanie:** Upewnij się, że FFmpeg jest zainstalowany i dostępny w zmiennej PATH systemu. Dla użytkowników Windows najprostszą opcją jest pobranie pliku `YTSage-v-ffmpeg.exe`, który zawiera FFmpeg. --- -#### 🛡️ Ostrzeżenie o programie Windows Defender/antywirusie +#### 🛡️ Ostrzeżenie Windows Defender / Antywirus -Niektóre programy antywirusowe mogą oznaczać pliki `.exe` jako fałszywe alarmy. Jest to **znane ograniczenie** aplikacji w pakietach. +Niektóre programy antywirusowe mogą oznaczać pliki `.exe` jako fałszywe alarmy (false positive). Jest to **znane ograniczenie** pakowanych aplikacji. **Dlaczego tak się dzieje:** -- Heurystyka antywirusowa może błędnie zidentyfikować spakowane pliki wykonywalne jako podejrzane +- Heurystyka antywirusa może błędnie zidentyfikować spakowane pliki wykonywalne jako podejrzane. **Bezpieczne alternatywy:** -- ✅ **Użyj instalacji pip:** `pip install ytsage` (zalecane) -- ✅ **Kompiluj ze źródła**: postępując zgodnie z tym [guide](../.github/CI_CD_README.md) -- ✅ **Dodaj aplikację do białej listy** w swoim oprogramowaniu antywirusowym +- ✅ **Użyj instalacji przez pip:** `pip install ytsage` (zalecane) +- ✅ **Zbuduj ze źródeł**: Postępując zgodnie z tym [przewodnikiem](.github/CI_CD_README.md) +- ✅ **Dodaj aplikację do wyjątków** w swoim programie antywirusowym. -#### 🍎 macOS: „Aplikacja jest uszkodzona i nie można jej otworzyć” +#### 🍎 macOS: "Aplikacja jest uszkodzona i nie można jej otworzyć" Jeśli widzisz ten błąd w systemie macOS Sonoma lub nowszym, musisz usunąć atrybut kwarantanny. -1. **Otwórz Terminal** (możesz go znaleźć za pomocą Spotlight). -2. **Wpisz następujące polecenie**, ale **nie** jeszcze naciskaj Enter. Pamiętaj o dodaniu spacji na końcu: +1. **Otwórz Terminal** (możesz go znaleźć przez Spotlight). +2. **Wpisz następującą komendę**, ale jeszcze **NIE** naciskaj Enter. Pamiętaj o spacjach na końcu: ```bash xattr -d com.apple.quarantine ``` -3. **Przeciągnij plik `YTSage.app`** z okna Findera i upuść go bezpośrednio w oknie Terminala. Spowoduje to automatyczne wklejenie prawidłowej ścieżki pliku. -4. **Naciśnij Enter**, aby uruchomić polecenie. -5. **Spróbuj ponownie otworzyć YTSage.app.** Powinna teraz uruchomić się poprawnie. +3. **Przeciągnij plik `YTSage.app` z okna Findera** i upuść go bezpośrednio w oknie Terminala. To automatycznie wklei poprawną ścieżkę do pliku. +4. **Naciśnij Enter**, aby uruchomić komendę. +5. **Spróbuj ponownie otworzyć YTSage.app.** Powinien uruchomić się poprawnie. --- -#### **Lokacje konfiguracji (zaawansowane)** +#### **Lokalizacja konfiguracji (zaawansowane)** - **Windows:** `%LOCALAPPDATA%\YTSage` - **macOS:** `~/Library/Application Support/YTSage` - **Linux:** `~/.local/share/YTSage` @@ -432,102 +437,102 @@ Jeśli widzisz ten błąd w systemie macOS Sonoma lub nowszym, musisz usunąć a ## 💖 Sponsor -Jeśli YTSage pozwoli Ci zaoszczędzić czas, rozważ sponsorowanie projektu. Sponsoring pomaga pokryć czas opracowywania, testowania na różnych platformach i przyszłych ulepszeń. +Jeśli YTSage oszczędza Twój czas, rozważ wsparcie projektu. Sponsoring pomaga pokryć czas programistyczny, testy na wszystkich platformach i przyszłe ulepszenia. -- Sponsorzy GitHuba: https://github.com/sponsors/oop7 -- Link sponsora jest również dostępny bezpośrednio w aplikacji, w oknie dialogowym Informacje. +- GitHub Sponsors: https://github.com/sponsors/oop7 +- Link do wsparcia jest dostępny bezpośrednio przez okno "O programie" w aplikacji. [![Sponsor YTSage](https://img.shields.io/badge/Sponsor-YTSage-EA4AAA?style=for-the-badge&logo=github&logoColor=white)](https://github.com/sponsors/oop7) - -## 👥 Wkład + +## 👥 Współpraca -Zapraszamy do wpłat! Oto jak możesz pomóc: +Zapraszamy do współpracy! Oto jak możesz pomóc: -1. 🍴Rozwidl repozytorium -2. 🌿 Utwórz gałąź funkcji: +1. 🍴 Skonfiguruj fork repozytorium +2. 🌿 Utwórz gałąź (branch) dla swojej funkcji: ```bash - git checkout -b feature/AmazingFeature + git checkout -b feature/NiesamowitaFunkcja ``` -3. 💾 Zatwierdź zmiany: +3. 💾 Zatwierdź zmiany (commit): ```bash - git commit -m 'Add some AmazingFeature' + git commit -m 'Dodaj NiesamowitaFunkcja' ``` -4. 📤 Pchnij do oddziału: +4. 📤 Wyślij zmiany do gałęzi (push): ```bash - git push origin feature/AmazingFeature + git push origin feature/NiesamowitaFunkcja ``` -5. 🔄 Otwórz żądanie ściągnięcia +5. 🔄 Otwórz Pull Request -### 🌍 Tłumaczenia wspierające +### 🌍 Pomóż w tłumaczeniach -- Zaktualizuj pasujący zlokalizowany plik README (na przykład `README.es.md`) -- Synchronizuj ciągi aplikacji, edytując `ytsage/languages/.json` -- Jeśli brakuje Twojego języka, zacznij od `README.md` i utwórz `README..md` +- Zaktualizuj odpowiedni lokalny plik README (np. `readme-translations/README.pl.md`) +- Dbaj o synchronizację komunikatów aplikacji, edytując `ytsage/languages/.json` +- Jeśli brakuje Twojego języka, zacznij od `README.md` i stwórz `README..md`
📂 Struktura projektu -## YTSage – Struktura projektu +## YTSage - Struktura projektu -Ten dokument opisuje zorganizowaną strukturę folderów YTSage. +Ten dokument opisuje zorganizowaną strukturę folderów projektu YTSage. ### 📁 Struktura projektu ``` 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/ # Konfiguracja GitHub +│ ├── 📁 ISSUE_TEMPLATE/ # Szablony zgłoszeń +│ │ └── 🐛-bug-report.md # Szablon zgłoszenia błędu +│ ├─── 📁 workflows/ # Procesy GitHub Actions +│ │ ├── build-linux.yml # Proces budowania dla Linux +│ │ ├── build-macos.yml # Proces budowania dla macOS +│ │ │── build-windows.yml # Proces budowania dla Windows +| | └── release-all.yml # Proces głównego wydania +│ └── 📄 CI_CD_README.md # Dokumentacja CI/CD +├── 📁 branding/ # Materiały graficzne (zrzuty ekranu, SVG) +│ ├── 📁 icons/ # Ikony aplikacji +│ ├── 📁 screenshots/ # Zrzuty ekranu do dokumentacji +│ └── 📁 svg/ # Zasoby SVG +├── 📄 LICENSE # Plik licencji +├── 📄 pyproject.toml # Metadane projektu i zależności +├── 📄 README.md # Dokumentacja projektu +├── 📄 requirements.txt # Zależności Python (dev) +└── 📁 ytsage/ # Pakiet kodu źródłowego + ├── 📁 assets/ # Zasoby czasu wykonywania + │ ├── 📁 Icon/ # Ikony aplikacji + │ └── 📁 sound/ # Pliki dźwiękowe + ├── 📁 languages/ # Pliki lokalizacji + │ ├── 📄 ar.json # Tłumaczenie arabskie + │ ├── 📄 de.json # Tłumaczenie niemieckie + │ ├── 📄 en.json # Tłumaczenie angielskie + │ └── ... # Inne języki + ├── 📁 core/ # Główna logika biznesowa + │ ├── 📄 __init__.py + │ ├── 📄 ytsage_deno.py # Integracja Deno + │ ├── 📄 ytsage_downloader.py # Funkcjonalność pobierania + │ ├── 📄 ytsage_ffmpeg.py # Integracja FFmpeg + │ ├── 📄 ytsage_utils.py # Funkcje pomocnicze + │ └── 📄 ytsage_yt_dlp.py # Integrasi yt-dlp + ├── 📁 gui/ # Komponenty interfejsu użytkownika + │ ├── 📄 __init__.py + │ ├── 📄 ytsage_gui_main.py # Główne okno aplikacji + │ └── 📁 ytsage_gui_dialogs/ # Klasy okien dialogowych + ├── 📁 utils/ # Moduły pomocnicze + │ ├── 📄 __init__.py + │ ├── 📄 ytsage_config_manager.py # Zarządzanie konfiguracją + │ └── 📄 ytsage_logger.py # Narzędzia logowania + ├── 📄 __init__.py # Punkt wejścia pakietu + └── 📄 main.py # Główny skrypt wykonawczy ```
-## ⭐️ Historia gwiazd +## ⭐️ Historia gwiazdek
-## Historia gwiazd +## Star History @@ -539,9 +544,9 @@ YTSage/
-## 📜Licencja +## 📜 Licencja -Ten projekt jest objęty licencją MIT — szczegółowe informacje można znaleźć w pliku [LICENSE](../LICENSE). +Ten projekt jest udostępniany na licencji MIT - zobacz plik [LICENSE](LICENSE), aby poznać szczegóły. ## 🙏 Podziękowania @@ -550,54 +555,55 @@ Ten projekt jest objęty licencją MIT — szczegółowe informacje można znale
-

Serdecznie dziękujemy wszystkim, którzy przyczynili się do tego projektu, otwierając problem, aby zasugerować ulepszenie lub zgłosić błąd.

+

Wielkie podziękowania dla wszystkich, którzy przyczynili się do rozwoju projektu poprzez zgłaszanie sugestii i błędów.

- + - + - + - + - + - - + + - + + - - + + - + - + - + - +
Główne komponenty
yt-dlpPobierz silnikSilnik pobierania
FFmpegPrzetwarzanie multimediówPrzetwarzanie mediów
DenoŚrodowisko wykonawcze do integracji z yt-dlpŚrodowisko dla integracji yt-dlp
Biblioteki i struktury
Biblioteki i frameworki
PySide6Struktura GUIFramework GUI
PoduszkaPrzetwarzanie obrazuPillowPrzetwarzanie obrazów
żądania
requests Żądania HTTP
opakowanieObsługa wersji i pakietówpackagingZarządzanie wersjami i pakowanie
przecenamarkdown Renderowanie Markdown
loguru Logowanie
Zasoby i współtwórcy
Zasoby i współpracownicy
Nowe powiadomienie 09 od UniversfieldNew Notification 09 by Universfield Dźwięk powiadomienia
viru185Współtwórca koduWspółpracownik kodu
@@ -607,12 +613,12 @@ Ten projekt jest objęty licencją MIT — szczegółowe informacje można znale ## ⚠️ Zastrzeżenie -To narzędzie jest przeznaczone wyłącznie do użytku osobistego. Prosimy o przestrzeganie warunków korzystania z usługi YouTube i praw twórców treści. +To narzędzie służy wyłącznie do użytku osobistego. Prosimy o przestrzeganie Warunków świadczenia usług YouTube i praw twórców treści. ---
-Wykonane z ❤️ przez [oop7](https://github.com/oop7) +Stworzone z ❤️ przez [oop7](https://github.com/oop7)
diff --git a/readme-translations/README.pt.md b/readme-translations/README.pt.md index 79b2f01..c12531f 100644 --- a/readme-translations/README.pt.md +++ b/readme-translations/README.pt.md @@ -12,81 +12,82 @@ [![PyPI version](https://img.shields.io/pypi/v/ytsage?color=c90000&style=for-the-badge&logo=pypi&logoColor=white)](https://pypi.org/project/ytsage/) [![GitHub Sponsors](https://img.shields.io/github/sponsors/oop7?color=c90000&style=for-the-badge&logo=githubsponsors&logoColor=white)](https://github.com/sponsors/oop7) -**Um downloader moderno do YouTube com uma interface PySide6 limpa.** -Baixe vídeos em qualquer qualidade, extraia áudio, busque legendas e muito mais. +**Um downloader de YouTube moderno com uma interface PySide6 limpa.** +Baixe vídeos em qualquer qualidade, extraia áudio, obtenha legendas e muito mais. -### 🌍 LEIA-ME Idiomas +### 🌍 Idiomas do README Inglês: [EN](../README.md) -| Nome: [AR](README.ar.md) +| Árabe: [AR](README.ar.md) | Alemão: [DE](README.de.md) | Espanhol: [ES](README.es.md) | Francês: [FR](README.fr.md) -| Nome: [HI](README.hi.md) -| Bahasa Indonésia: [ID](README.id.md) +| Hindi: [HI](README.hi.md) +| Indonésio: [ID](README.id.md) | Italiano: [IT](README.it.md) -| Nome do usuário: [JA](README.ja.md) -| Polaco: [PL](README.pl.md) +| Japonês: [JA](README.ja.md) +| Polonês: [PL](README.pl.md) | Português: [PT](README.pt.md) | Russo: [RU](README.ru.md) | Turco: [TR](README.tr.md) -| 中文: [ZH](README.zh.md) +| Chinês: [ZH](README.zh.md)

- Instalação • - Recursos • - Uso • - Capturas de tela • - Solução de problemas • - Patrocinador • - Contribuindo + Instalação • + Funcionalidades • + Uso • + Capturas de Tela • + Solução de Problemas • + Patrocinar • + Contribuindo

--- - + ## ❓ Por que YTSage? -YTSage foi projetado para usuários que desejam um **baixador de YouTube simples, mas poderoso**. Ao contrário de outras ferramentas, oferece: +O YTSage foi projetado para usuários que desejam um **downloader de YouTube simples, mas poderoso**. Ao contrário de outras ferramentas, ele oferece: -- Uma interface PySide6 limpa e moderna -- Downloads com um clique para vídeo, áudio e legendas +- Uma interface PySide6 moderna e limpa +- Download de vídeo, áudio e legendas com um clique - Recursos avançados como SponsorBlock, mesclagem de legendas e seleção de playlist -- Modo genérico opcional para sites compatíveis com yt-dlp além do YouTube -- Suporte multiplataforma e fácil instalação +- Modo Genérico opcional para sites além do YouTube suportados pelo yt-dlp +- Suporte multiplataforma e instalação fácil - -## ✨ Recursos + +## ✨ Funcionalidades
-| Recursos principais | Recursos Avançados | Recursos extras | -|-----------------------------------|---------------------------------------------------|-----------------------------------| -| 🎥 Tabela de Formatos | 🚫 Integração SponsorBlock | 🎞️ Tela FPS/HDR | -| 🎵 Extração de Áudio | 📝 Seleção e mesclagem de múltiplas legendas | 🔄 Atualização automática do yt-dlp | -| ✨ UI simples | 💾 Salvar descrição e miniatura | 🛠️ Detecção de FFmpeg/yt-dlp/Deno | -| 📋 Suporte e seletor de lista de reprodução | 🚀 Limitador de velocidade | ⚙️ Comandos personalizados | -| 📑 Incorporar capítulos | ✂️ Cortar seções de vídeo | 🍪 Login com Cookies | -| 📜 Histórico de downloads | 🔄 Seleção de canal de lançamento | 🌐 Suporte a proxy | -| 🎚️ Conversão de formato de áudio | 🎬 Configurações de formato de vídeo | 🆙 Guia Atualizador integrado | +| Recursos Básicos | Recursos Avançados | Recursos Extras | +|-----------------------------------|-----------------------------------------|------------------------------------| +| 🎥 Tabela de Formatos | 🚫 Integração SponsorBlock | 🎞️ Exibição de FPS/HDR | +| 🎵 Extração de Áudio | 📝 Seleção e Mesclagem de Legendas | 🔄 Atualização Automática do yt-dlp | +| ✨ Interface de Usuário Simples | 💾 Salvar Descrição e Miniatura | 🛠️ Detecção de FFmpeg/yt-dlp/Deno | +| 📋 Suporte e Seletor de Playlist | 🚀 Limitador de Velocidade | ⚙️ Comandos Personalizados | +| 📑 Integração de Capítulos | ✂️ Cortar Seções de Vídeo | 🍪 Login por Cookies | +| 📜 Histórico de Downloads | 🔄 Escolha do Canal de Lançamento | 🌐 Suporte a Proxy | +| 🎚️ Conversão de Formato de Áudio | 🎬 Configurações de Formato de Vídeo | 🆙 Aba de Atualização Integrada | | 🌍 Modo Genérico | 🔊 Normalização de Áudio (EBU R128) | 🌍 Localização em 14 idiomas | +| 💾 Exportação de Playlist | ⚙️ Qualidade e Legendas Padrão | |
- + ## 🚀 Instalação -### ⚡ Instalação rápida (recomendado) +### ⚡ Instalação Rápida (Recomendada) -Instale YTSage do PyPI: +Instale o YTSage via PyPI: ```bash pip install ytsage ```
-🔄 Atualizar uma instalação existente +🔄 Atualizar Instalação Existente ```bash pip install --upgrade ytsage @@ -94,49 +95,49 @@ pip install --upgrade ytsage
-Em seguida, inicie o aplicativo: +Em seguida, execute o aplicativo: ```bash ytsage ``` -### 📦 Executáveis pré-construídos +### 📦 Executáveis Pré-compilados (Executable) -> [👉 Download Latest Release](https://github.com/oop7/YTSage/releases/latest) +> [👉 Baixar Lançamento Mais Recente](https://github.com/oop7/YTSage/releases/latest) -#### 🪟 Janelas +#### 🪟 Windows | Formato | Descrição | -|--------|------------| -| ![Windows EXE](https://img.shields.io/badge/Windows-EXE-0078D6?style=for-the-badge&logo=windows&logoColor=white) | Instalador padrão | +|--------|-------------| +| ![Windows EXE](https://img.shields.io/badge/Windows-EXE-0078D6?style=for-the-badge&logo=windows&logoColor=white) | Instalador Padrão | | ![Windows FFmpeg](https://img.shields.io/badge/Windows-FFmpeg-0078D6?style=for-the-badge&logo=windows&logoColor=white) | Com FFmpeg incluído | -| ![Windows Portable](https://img.shields.io/badge/Windows-Portable-0078D6?style=for-the-badge&logo=windows&logoColor=white) | Versão portátil, sem necessidade de instalação | -| ![Windows Portable FFmpeg](https://img.shields.io/badge/Windows-Portable%20FFmpeg-0078D6?style=for-the-badge&logo=windows&logoColor=white) | Portátil com FFmpeg, compactado | +| ![Windows Portable](https://img.shields.io/badge/Windows-Portable-0078D6?style=for-the-badge&logo=windows&logoColor=white) | Versão Portátil, sem necessidade de instalação | +| ![Windows Portable FFmpeg](https://img.shields.io/badge/Windows-Portable%20FFmpeg-0078D6?style=for-the-badge&logo=windows&logoColor=white) | Portátil com FFmpeg, compactado (ZIP) |
-🛠️ Etapas de instalação +🛠️ Passos para Instalação -1. **EXE Installer (`.exe`)**: Clique duas vezes no arquivo e siga o assistente de configuração. -2. **Versão portátil (`.zip`)**: Extraia o arquivo para o local desejado e execute `ytsage.exe`. -3. **FFmpeg Bundled**: Escolha as versões empacotadas do FFmpeg se você não tiver o FFmpeg instalado em seu sistema. +1. **Instalador EXE (`.exe`)**: Clique duas vezes no arquivo e siga o assistente de configuração. +2. **Versão Portátil (`.zip`)**: Extraia o arquivo para o local desejado e execute `ytsage.exe`. +3. **FFmpeg Integrado**: Se você não possui o FFmpeg instalado no sistema, escolha as versões com FFmpeg integrado.
-#### 🐧Linux +#### 🐧 Linux | Formato | Descrição | -|--------|------------| +|--------|-------------| | ![Linux DEB](https://img.shields.io/badge/Linux-DEB-FCC624?style=for-the-badge&logo=linux&logoColor=black) | Pacote Debian | -| ![Linux AppImage](https://img.shields.io/badge/Linux-AppImage-FCC624?style=for-the-badge&logo=linux&logoColor=black) | AppImage, portátil | +| ![Linux AppImage](https://img.shields.io/badge/Linux-AppImage-FCC624?style=for-the-badge&logo=linux&logoColor=black) | AppImage, Portátil | | ![Linux RPM](https://img.shields.io/badge/Linux-RPM-FCC624?style=for-the-badge&logo=linux&logoColor=black) | Pacote RPM | | ![Flathub](https://img.shields.io/badge/Linux-Flatpak-FCC624?style=for-the-badge&logo=flathub&logoColor=black) | Pacote Flatpak |
-🛠️ Etapas de instalação +🛠️ Passos para Instalação - **DEB (`.deb`)**: ```bash sudo dpkg -i ytsage_*.deb - sudo apt-get install -f # Fix missing dependencies if any + sudo apt-get install -f # Se necessário para corrigir dependências ausentes ``` - **RPM (`.rpm`)**: ```bash @@ -156,34 +157,34 @@ ytsage #### 🍎 macOS | Formato | Descrição | -|--------|------------| -| ![macOS ARM64 APP](https://img.shields.io/badge/macOS-ARM64%20APP-000000?style=for-the-badge&logo=apple&logoColor=white) | Aplicativo compactado para Apple Silicon | -| ![macOS ARM64 DMG](https://img.shields.io/badge/macOS-ARM64%20DMG-000000?style=for-the-badge&logo=apple&logoColor=white) | Instalador de imagem de disco para Apple Silicon | +|--------|-------------| +| ![macOS ARM64 APP](https://img.shields.io/badge/macOS-ARM64%20APP-000000?style=for-the-badge&logo=apple&logoColor=white) | Aplicativo ZIP para Apple Silicon | +| ![macOS ARM64 DMG](https://img.shields.io/badge/macOS-ARM64%20DMG-000000?style=for-the-badge&logo=apple&logoColor=white) | Instalador Disk Image para Apple Silicon |
-🛠️ Etapas de instalação +🛠️ Passos para Instalação -- **Instalador DMG (`.dmg`)**: Clique duas vezes para montar e arraste `YTSage.app` para a pasta Aplicativos. -- **Arquivo de aplicativos (`.zip`)**: Extraia o zip e mova `YTSage.app` para a pasta Aplicativos. +- **Instalador DMG (`.dmg`)**: Clique duas vezes para montar e arraste `YTSage.app` para a sua pasta Aplicativos. +- **Arquivo do Aplicativo (`.zip`)**: Extraia o ZIP e mova `YTSage.app` para a sua pasta Aplicativos. -*Observação: se você encontrar um erro "O aplicativo está danificado", consulte [macOS troubleshooting section](#troubleshooting) abaixo.* +*Nota: Se você receber o erro "App está danificado", veja a seção de Problemos no macOS abaixo.*
---
-💻 Instalação manual da fonte +💻 Instalação Manual a partir do Código-Fonte -### 1. Clone o repositório +### 1. Clonar o Repositório ```bash git clone https://github.com/oop7/YTSage.git cd YTSage ``` -### 2. Instalar dependências +### 2. Instalar Dependências -#### ⚡ Com UV +#### ⚡ Com uv ```bash uv pip install . @@ -195,7 +196,7 @@ uv pip install . pip install . ``` -### 3. Execute o aplicativo +### 3. Executar o Aplicativo ```bash python -m ytsage.main @@ -203,147 +204,151 @@ python -m ytsage.main
- -## 📸 Capturas de tela + +## 📸 Capturas de Tela
- - + + - - + + - - + + - - + +
Download SettingsPlaylist DownloadConfigurações de DownloadDownload de Playlist
Configurações de downloadBaixar lista de reproduçãoConfigurações de DownloadDownload de Playlist
Audio Format Selection with Save ThumbnailCustom OptionsSeleção de Formato de ÁudioOpções Personalizadas
Formato de áudioOpções personalizadasFormato de ÁudioOpções Personalizadas
-
+ + ## 📖 Uso
🎯 Uso Básico 1. **Inicie o YTSage** -2. **Colar URL do YouTube** (ou usar o botão "Colar URL") -3. **Clique em "Analisar"** -4. **Selecione Formato:** - - `Video` para downloads de vídeos +2. **Cole uma URL do YouTube** (ou use o botão "Paste URL") +3. **Clique em "Analyze"** +4. **Escolha o Formato:** + - `Video` para download de vídeo - `Audio Only` para extração de áudio -5. **Escolha Opções:** - - Ative legendas e selecione o idioma - - Ativar mesclagem de legendas +5. **Selecione Opções:** + - Habilite legendas e escolha o idioma + - Habilite a mesclagem de legendas - Salvar miniatura - - Remover segmentos de patrocinadores + - Remover seções de patrocinadores - Salvar descrição - Incorporar capítulos -6. **Selecione Diretório de Saída** -7. **Clique em "Baixar"** +6. **Escolha o Diretório de Saída** +7. **Clique em "Download"** > 💡 O diretório de download padrão é a pasta "Downloads" do usuário.
-📋 Baixar lista de reprodução +📋 Download de Playlist -1. **Colar URL da lista de reprodução** -2. **Clique em "Analisar"** -3. **Selecione vídeos no seletor de playlist (opcional, o padrão é todos)** +1. **Cole a URL da Playlist** +2. **Clique em "Analyze"** +3. **Selecione vídeos do seletor (opcional, padrão todos)** 4. **Escolha o formato/qualidade desejado** -5. **Clique em "Baixar"** +5. **Clique em "Download"** -> 💡 O aplicativo gerencia automaticamente a fila de download +> 💡 O aplicativo gerencia automaticamente a fila de download, e você pode exportar as entradas da playlist como arquivos `.txt`, `.csv`, `.m3u` ou `.json`.
-🌍 Modo genérico para sites que não são do YouTube +🌍 Modo Genérico para Sites além do YouTube -Use o modo genérico quando quiser que o YTSage aceite URLs de sites suportados pelo yt-dlp, como Dailymotion, CBC Gem, TikTok e outros. +Use o Modo Genérico quando quiser que o YTSage aceite URLs de sites suportados pelo yt-dlp, como Dailymotion, CBC Gem, TikTok e outros. Como usar: 1. Abra `Download Settings`. -2. Ative `Generic Mode`. -3. Cole um URL de vídeo ou lista de reprodução compatível que não seja do YouTube. +2. Habilite `Generic Mode`. +3. Cole uma URL de vídeo ou playlist suportada que não seja do YouTube. 4. Clique em `Analyze`. 5. Escolha um formato e baixe normalmente. Notas: -- O Modo Genérico altera apenas a validação de URL dentro do YTSage. O site de destino ainda deve ser compatível com a versão yt-dlp instalada. -- Alguns sites exigem cookies, uma sessão de login, um proxy ou argumentos yt-dlp extras, dependendo do extrator. -- Se um site falhar, atualize o yt-dlp primeiro na guia do atualizador integrado antes de relatar o problema. +- O Modo Genérico apenas altera a validação da URL dentro do YTSage. O site de destino ainda deve ser suportado pela sua versão instalada do yt-dlp. +- Alguns sites exigem cookies, login, proxy ou argumentos adicionais do yt-dlp, dependendo do extrator. +- Se um site falhar, atualize o yt-dlp na aba de atualização integrada antes de relatar o problema.
-🧰 Opções de mídia e download +🧰 Opções de Mídia e Download -- **Opções de legenda:** Filtre idiomas e incorpore legendas no arquivo de vídeo -- **Mesclagem de legendas:** Mesclar legendas no arquivo de vídeo para legendas codificadas -- **Salvar descrição:** Salve a descrição do vídeo como um arquivo de texto -- **Salvar miniatura:** Salve a miniatura do vídeo como um arquivo de imagem -- **Incorporar capítulos:** Incorpore marcadores de capítulo como metadados para players de vídeo compatíveis -- **Remover segmentos de patrocinadores:** Remova segmentos de patrocinadores do vídeo usando SponsorBlock -- **Cortar vídeo:** baixe apenas partes específicas de um vídeo especificando intervalos de tempo no formato `HH:MM:SS` +- **Opções de Legendas:** Filtre idiomas e incorpore legendas no arquivo de vídeo. +- **Mesclagem de Legendas:** Mescla legendas no arquivo de vídeo para legendas fixas (hardcoded). +- **Salvar Descrição:** Salva a descrição do vídeo como um arquivo de texto. +- **Salvar Miniatura:** Salva a miniatura do vídeo como um arquivo de imagem. +- **Incorporar Capítulos:** Inclui marcadores de capítulo como metadados para players de vídeo compatíveis. +- **Remover Seções de Patrocinadores:** Usa o SponsorBlock para remover segmentos patrocinados do vídeo. +- **Cortar Vídeo:** Baixe apenas partes específicas do vídeo, especificando o intervalo de tempo no formato `HH:MM:SS`.
-⚙️ Configurações de saída e arquivo +⚙️ Configurações de Saída e Arquivos + +- **Limitador de Velocidade:** Limite a velocidade de download, por exemplo, `500K` para 500 KB/s. +- **Salvar Caminho de Download:** Salva o caminho de download padrão para downloads futuros. Disponível em **Download Settings → Download Path**. +- **Resolução de Vídeo Padrão:** Defina sua resolução de vídeo preferida para seleção automática (ex: 1080p, 720p). Disponível em **Download Settings → Default Video Resolution**. +- **Idiomas de Legendas Padrão:** Defina idiomas de legendas padrão para seleção automática (separados por vírgula, ex: `pt,en`). Disponível em **Download Settings → Default Subtitle Languages**. +- **Formato de Nome de Arquivo:** Personalize o formato do nome do arquivo de saída usando variáveis como `%(title)s`, `%(uploader)s`, `%(playlist_index)s` e `%(resolution)s`. Disponível em **Download Settings → Filename Format**. +- **Forçar Formato de Saída:** Força o download do vídeo em um formato de contêiner específico, como `mp4`, `webm` ou `mkv`. Disponível em **Download Settings → Output Format Settings**. +- **Conversão de Formato de Áudio:** Converta downloads de apenas áudio para formatos preferidos como `AAC`, `MP3`, `FLAC`, `WAV`, `Opus`, `M4A`, `Vorbis`, ou `Best`. Disponível em **Download Settings → Audio Format Settings**. +- **Normalização de Áudio:** Padroniza o volume para downloads de apenas áudio usando EBU R128. +- **Conexões Simultâneas:** Aumente significativamente a velocidade de download baixando arquivos em várias partes ao mesmo tempo. Disponível em **Download Settings → General → Concurrent Connections** (padrão 1, máximo 8-10 recomendado para evitar bloqueios de IP). -- **Limitador de velocidade:** Limite a velocidade de download, por exemplo `500K` para 500 KB/s -- **Salvar caminho de download:** Salve o caminho de download padrão para downloads futuros. Disponível em **Configurações de download → Caminho de download**. -- **Formato do nome do arquivo de saída:** Personalize o formato do nome do arquivo de saída usando variáveis ​​como `%(title)s`, `%(uploader)s` e `%(resolution)s`. Disponível em **Configurações de download → Formato do nome do arquivo**. -- **Forçar formato de saída:** Força downloads de vídeo em um formato de contêiner específico, como `mp4`, `webm` ou `mkv`. Disponível em **Configurações de download → Configurações de formato de saída**. -- **Conversão de formato de áudio:** Converta downloads somente de áudio para formatos preferidos, como `AAC`, `MP3`, `FLAC`, `WAV`, `Opus`, `M4A`, `Vorbis` ou `Best`. Disponível em **Configurações de download → Configurações de formato de áudio**. -- **Normalização de áudio:** Padronize o volume para downloads somente de áudio usando EBU R128. -- **Conexões Simultâneas:** Aumente a velocidade de download drasticamente baixando arquivos em vários fragmentos simultaneamente. Disponível em **Configurações de Download → Geral → Conexões Simultâneas** (O padrão é 1, o máximo recomendado é 8-10 para evitar bloqueios de IP).\n
🌐 Acesso e Rede -- **Login com Cookies:** Faça login no YouTube usando cookies para acessar conteúdo privado. - Como usar: - 1. **Recomendado:** Use a opção `Extract cookies from browser` integrada no aplicativo e selecione seu navegador e, opcionalmente, um perfil. - 2. Como alternativa, extraia os cookies manualmente: - uma. Exporte cookies do seu navegador usando uma extensão como [cookie-editor](https://github.com/moustachauve/cookie-editor?tab=readme-ov-file) +- **Login por Cookies:** Faça login no YouTube usando cookies para acessar conteúdo privado. + Uso: + 1. **Recomendado:** Use a opção integrada `Extract cookies from browser` no aplicativo, selecione o navegador e, opcionalmente, o perfil. + 2. Opcionalmente, extraia cookies manualmente: + a. Exporte cookies do seu navegador usando uma extensão como [cookie-editor](https://github.com/moustachauve/cookie-editor?tab=readme-ov-file) b. Copie os cookies no formato Netscape - c. Crie um arquivo chamado `cookies.txt` e cole os cookies nele + c. Crie um arquivo chamado `cookies.txt` e cole os cookies d. Selecione o arquivo `cookies.txt` no aplicativo -- **Suporte a proxy:** Use um servidor proxy para downloads, por exemplo `http://:` -- **Modo genérico:** permite que o YTSage analise e faça download de sites que não sejam do YouTube suportados pelo yt-dlp. Habilite-o em **Configurações de download → Modo genérico**. +- **Suporte a Proxy:** Use um servidor proxy para downloads, ex: `http://:` +- **Modo Genérico:** Permite que o YTSage analise e baixe de sites além do YouTube suportados pelo yt-dlp. Habilite em **Download Settings → Generic Mode**.
🛠️ Ferramentas e Manutenção -- **Comandos personalizados:** Acesse recursos avançados do yt-dlp por meio de argumentos de linha de comando -- **Guia Atualizador:** Gerencie ferramentas de atualização integradas em um só lugar nas Opções Personalizadas: - - **Atualizações do yt-dlp:** verifique se há atualizações e alterne entre canais de lançamento estável e noturno - - **Verificador de versão do FFmpeg:** Verifique sua versão do FFmpeg e abra os guias de instalação - - **Atualizações do Deno:** Verifique e atualize o tempo de execução do Deno -- **Detecção de FFmpeg/yt-dlp/Deno:** Detecta automaticamente caminhos e versões de FFmpeg, yt-dlp e Deno na caixa de diálogo Sobre. -- **Histórico de downloads:** Veja downloads anteriores com miniaturas e status no botão **Histórico**. +- **Comandos Personalizados:** Acesse recursos avançados do yt-dlp via argumentos de linha de comando. +- **Aba de Atualização:** Gerencie as ferramentas de atualização integradas em um só lugar nas Opções Personalizadas: + - **Atualização do yt-dlp:** Verifique atualizações e alterne entre os canais de lançamento Stable e Nightly. + - **Verificador de Versão do FFmpeg:** Verifique sua versão do FFmpeg e abra guias de instalação. + - **Atualização do Deno:** Verifique e atualize o runtime do Deno. +- **Detecção de FFmpeg/yt-dlp/Deno:** Detecta automaticamente caminhos e versões de FFmpeg, yt-dlp e Deno no diálogo Sobre. +- **Histórico de Downloads:** Veja downloads anteriores com miniaturas e status no botão **History**.
🌍 Localização -YTSage oferece suporte a **14 idiomas** para acessibilidade mundial. Selecione seu idioma preferido em **Opções personalizadas → Idioma**. +O YTSage suporta **14 idiomas** para alcance global. Escolha o seu idioma preferido em **Custom Options → Language**. ### Idiomas Suportados @@ -357,11 +362,11 @@ YTSage oferece suporte a **14 idiomas** para acessibilidade mundial. Selecione s | 🇧🇷 Português | `pt` | 🇷🇺 Russo | `ru` | | 🇹🇷 Turco | `tr` | 🇨🇳 Chinês | `zh` | -### LEIA-ME Traduções +### Traduções do README | Idioma | Arquivo | Idioma | Arquivo | |----------|------|----------|------| -| 🇺🇸 Inglês | [README.md](../README.md) | 🇪🇸 Espanhol | [README.es.md](README.es.md) +| 🇺🇸 Inglês | [README.md](README.md) | 🇪🇸 Espanhol | [README.es.md](README.es.md) | | 🇸🇦 Árabe | [README.ar.md](README.ar.md) | 🇫🇷 Francês | [README.fr.md](README.fr.md) | | 🇩🇪 Alemão | [README.de.md](README.de.md) | 🇮🇳 Hindi | [README.hi.md](README.hi.md) | | 🇮🇩 Indonésio | [README.id.md](README.id.md) | 🇮🇹 Italiano | [README.it.md](README.it.md) | @@ -369,101 +374,101 @@ YTSage oferece suporte a **14 idiomas** para acessibilidade mundial. Selecione s | 🇧🇷 Português | [README.pt.md](README.pt.md) | 🇷🇺 Russo | [README.ru.md](README.ru.md) | | 🇹🇷 Turco | [README.tr.md](README.tr.md) | 🇨🇳 Chinês | [README.zh.md](README.zh.md) | -> 💡 **Quer contribuir com uma tradução?** Confira a seção [Contributing](#contributing) para nos ajudar a adicionar mais idiomas! +> 💡 **Quer ajudar na tradução?** Veja a seção [Contribuindo](#contribuindo) para nos ajudar a adicionar mais idiomas!
- -## 🛠️ Solução de problemas + +## 🛠️ Solução de Problemas
-Clique para ver problemas e soluções comuns +Clique para ver problemas comuns e soluções -- **Tabela de formato não exibida:** Atualize yt-dlp para a versão mais recente e mude para yt-dlp todas as noites. -- **Falha no download:** Verifique sua conexão com a Internet e certifique-se de que o vídeo esteja disponível. -- **Erros específicos de download:** - - **Vídeos privados:** Use autenticação de cookies para acessar conteúdo privado. - - **Conteúdo com restrição de idade:** Faça login na conta do YouTube para visualizar vídeos com restrição de idade. - - **Vídeos bloqueados geograficamente:** considere usar uma VPN para contornar restrições regionais. - - **Vídeos removidos/excluídos:** O vídeo não está mais disponível no YouTube. - - **Transmissões ao vivo:** As transmissões ao vivo não podem ser baixadas; espere o fluxo terminar. - - **Erros de rede:** Verifique sua conexão com a Internet e tente novamente. - - **URLs inválidos:** certifique-se de que o URL esteja correto e seja de uma plataforma compatível. - - **Conteúdo Premium:** Requer assinatura do YouTube Premium. - - **Bloqueios de direitos autorais:** O conteúdo está bloqueado devido a restrições de direitos autorais. -- **Arquivos de vídeo e áudio separados após o download:** Isso acontece quando o FFmpeg está ausente ou não é detectado. YTSage requer FFmpeg para mesclar fluxos de vídeo e áudio de alta qualidade. - - **Solução:** Certifique-se de que o FFmpeg esteja instalado e acessível no PATH do seu sistema. Para usuários do Windows, a opção mais fácil é baixar o arquivo `YTSage-v-ffmpeg.exe`, que vem junto com o FFmpeg. +- **Tabela de formatos não aparece:** Atualize o yt-dlp para a versão mais recente e tente alternar para o yt-dlp Nightly. +- **Download falhou:** Verifique sua conexão com a internet e certifique-se de que o vídeo está disponível. +- **Erros de Download Específicos:** + - **Vídeos Privados:** Use a autenticação por cookies para acessar conteúdo privado. + - **Conteúdo com Restrição de Idade:** Faça login na sua conta do YouTube para visualizar vídeos com restrição de idade. + - **Vídeos com Bloqueio Geográfico:** Considere usar uma VPN para contornar restrições regionais. + - **Vídeo Removido:** O vídeo não está mais disponível no YouTube. + - **Live Streams:** Transmissões ao vivo não podem ser baixadas enquanto estão sendo transmitidas; aguarde até que a transmissão termine. + - **Erros de Rede:** Verifique sua conexão com a internet e tente novamente. + - **URL Inválida:** Certifique-se de que a URL está correta e pertence a uma plataforma suportada. + - **Conteúdo Premium:** Requer uma assinatura do YouTube Premium. + - **Bloqueio por Direitos Autorais:** O conteúdo está bloqueado devido a restrições de direitos autorais. +- **Arquivos de vídeo e áudio estão separados após o download:** Isso acontece quando o FFmpeg está ausente ou não foi detectado. O YTSage requer o FFmpeg para mesclar streams de vídeo e áudio de alta qualidade. + - **Solução:** Certifique-se de que o FFmpeg está instalado e acessível no PATH do seu sistema. Para usuários do Windows, a opção mais fácil é baixar o arquivo `YTSage-v-ffmpeg.exe`, que já vem com o FFmpeg. --- #### 🛡️ Aviso do Windows Defender / Antivírus -Alguns softwares antivírus podem sinalizar os arquivos `.exe` como falsos positivos. Esta é uma **limitação conhecida** dos aplicativos empacotados. +Alguns softwares antivírus podem sinalizar arquivos `.exe` como falsos positivos. Esta é uma **limitação conhecida** de aplicativos empacotados. **Por que isso acontece:** -- A heurística antivírus pode identificar erroneamente executáveis compactados como suspeitos +- As heurísticas do antivírus podem identificar incorretamente executáveis empacotados como suspeitos. -**Alternativas seguras:** -- ✅ **Use instalação pip:** `pip install ytsage` (recomendado) -- ✅ **Construir a partir da fonte**: seguindo isto [guide](../.github/CI_CD_README.md) -- ✅ **Coloque o aplicativo na lista de permissões** em seu software antivírus +**Opções Seguras:** +- ✅ **Use a instalação via pip:** `pip install ytsage` (recomendado) +- ✅ **Compile a partir do código-fonte**: Seguindo este [guia](.github/CI_CD_README.md) +- ✅ **Adicione o aplicativo à lista de permissões** do seu software antivírus. -#### 🍎 macOS: "O aplicativo está danificado e não pode ser aberto" -Se você vir esse erro no macOS Sonoma ou mais recente, será necessário remover o atributo de quarentena. +#### 🍎 macOS: "App está danificado e não pode ser aberto" +Se você vir este erro no macOS Sonoma ou mais recente, você precisa remover o atributo de quarentena. -1. **Abra o Terminal** (você pode encontrá-lo usando o Spotlight). -2. **Digite o seguinte comando** mas **não** pressione Enter ainda. Certifique-se de incluir o espaço no final: +1. **Abra o Terminal** (você pode encontrá-lo usando o Spotlight). +2. **Digite o seguinte comando**, mas ainda **NÃO** pressione Enter. Certifique-se de incluir o espaço no final: ```bash xattr -d com.apple.quarantine ``` -3. **Arraste o arquivo `YTSage.app`** da janela do Finder e solte-o diretamente na janela do Terminal. Isso colará automaticamente o caminho correto do arquivo. -4. **Pressione Enter** para executar o comando. -5. **Tente abrir YTSage.app novamente.** Agora ele deve iniciar corretamente. +3. **Arraste o arquivo `YTSage.app` da janela do Finder** e solte-o diretamente na janela do Terminal. Isso colará automaticamente o caminho correto do arquivo. +4. **Pressione Enter** para executar o comando. +5. **Tente abrir o YTSage.app novamente.** Ele agora deve iniciar corretamente. --- -#### **Locais de configuração (avançado)** -- **Janelas:** `%LOCALAPPDATA%\YTSage` +#### **Localização da Configuração (Avançado)** +- **Windows:** `%LOCALAPPDATA%\YTSage` - **macOS:** `~/Library/Application Support/YTSage` - **Linux:** `~/.local/share/YTSage`
- -## 💖 Patrocinador + +## 💖 Patrocinar -Se o YTSage economizar seu tempo, considere patrocinar o projeto. O patrocínio ajuda a cobrir o tempo de desenvolvimento, testes em plataformas e melhorias futuras. +Se o YTSage economiza seu tempo, considere patrocinar o projeto. Os patrocínios ajudam a cobrir o tempo de desenvolvimento, testes em todas as plataformas e melhorias futuras. -- Patrocinadores do GitHub: https://github.com/sponsors/oop7 -- O link do patrocinador também está disponível diretamente no aplicativo, na caixa de diálogo Sobre. +- GitHub Sponsors: https://github.com/sponsors/oop7 +- O link de patrocínio está disponível diretamente através do diálogo Sobre no aplicativo. [![Sponsor YTSage](https://img.shields.io/badge/Sponsor-YTSage-EA4AAA?style=for-the-badge&logo=github&logoColor=white)](https://github.com/sponsors/oop7) - + ## 👥 Contribuindo -Aceitamos contribuições! Veja como você pode ajudar: +Contribuições são bem-vindas! Veja como você pode ajudar: -1. 🍴 Bifurque o repositório -2. 🌿 Crie seu branch de recursos: +1. 🍴 Faça um Fork do repositório +2. 🌿 Crie sua branch de recurso: ```bash - git checkout -b feature/AmazingFeature + git checkout -b feature/RecursoIncrivel ``` -3. 💾 Confirme suas alterações: +3. 💾 Faça o commit de suas alterações: ```bash - git commit -m 'Add some AmazingFeature' + git commit -m 'Adicionar RecursoIncrivel' ``` -4. 📤 Empurre para o galho: +4. 📤 Faça o push para a branch: ```bash - git push origin feature/AmazingFeature + git push origin feature/RecursoIncrivel ``` -5. 🔄 Abra uma solicitação pull +5. 🔄 Abra um Pull Request -### 🌍 Contribuindo com traduções +### 🌍 Contribua com Traduções -- Atualize o arquivo README localizado correspondente (por exemplo `README.es.md`) -- Mantenha as strings do aplicativo sincronizadas editando `ytsage/languages/.json` -- Se o seu idioma estiver faltando, comece em `README.md` e crie `README..md` +- Atualize o arquivo README localizado relevante (ex: `readme-translations/README.pt.md`) +- Mantenha as strings do aplicativo em sincronia editando `ytsage/languages/.json` +- Se o seu idioma estiver ausente, comece pelo `README.md` e crie `README..md`
📂 Estrutura do Projeto @@ -476,58 +481,58 @@ Este documento descreve a estrutura de pastas organizada do 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/ # Configurações do GitHub +│ ├── 📁 ISSUE_TEMPLATE/ # Modelos de problemas +│ │ └── 🐛-bug-report.md # Modelo de relatório de erro +│ ├─── 📁 workflows/ # Fluxos de trabalho do GitHub Actions +│ │ ├── build-linux.yml # Fluxo de build para Linux +│ │ ├── build-macos.yml # Fluxo de build para macOS +│ │ │── build-windows.yml # Fluxo de build para Windows +| | └── release-all.yml # Fluxo de lançamento principal +│ └── 📄 CI_CD_README.md # Documentação CI/CD +├── 📁 branding/ # Ativos de marca (capturas de tela, SVGs) +│ ├── 📁 icons/ # Ícones do aplicativo +│ ├── 📁 screenshots/ # Capturas de tela para documentação +│ └── 📁 svg/ # Ativos SVG +├── 📄 LICENSE # Arquivo de licença +├── 📄 pyproject.toml # Metadados do projeto e dependências +├── 📄 README.md # Documentação do projeto +├── 📄 requirements.txt # Dependências Python (dev) +└── 📁 ytsage/ # Pacote de código-fonte + ├── 📁 assets/ # Ativos de tempo de execução + │ ├── 📁 Icon/ # Ícones do aplicativo + │ └── 📁 sound/ # Arquivos de áudio + ├── 📁 languages/ # Arquivos de localização + │ ├── 📄 ar.json # Tradução em árabe + │ ├── 📄 de.json # Tradução em alemão + │ ├── 📄 en.json # Tradução em inglês + │ └── ... # Outros idiomas + ├── 📁 core/ # Lógica de negócios principal + │ ├── 📄 __init__.py + │ ├── 📄 ytsage_deno.py # Integração Deno + │ ├── 📄 ytsage_downloader.py # Funcionalidade de download + │ ├── 📄 ytsage_ffmpeg.py # Integração FFmpeg + │ ├── 📄 ytsage_utils.py # Funções utilitárias + │ └── 📄 ytsage_yt_dlp.py # Integração yt-dlp + ├── 📁 gui/ # Componentes de interface do usuário + │ ├── 📄 __init__.py + │ ├── 📄 ytsage_gui_main.py # Janela principal do aplicativo + │ └── 📁 ytsage_gui_dialogs/ # Classes de diálogo + ├── 📁 utils/ # Módulos utilitários + │ ├── 📄 __init__.py + │ ├── 📄 ytsage_config_manager.py # Gerenciamento de configuração + │ └── 📄 ytsage_logger.py # Ferramentas de registro + ├── 📄 __init__.py # Ponto de entrada do pacote + └── 📄 main.py # Script de execução principal ```
-## ⭐️ História da estrela +## ⭐️ Histórico de Estrelas
-## História da estrela +## Star History @@ -541,63 +546,64 @@ YTSage/ ## 📜 Licença -Este projeto está licenciado sob a licença MIT - consulte o arquivo [LICENSE](../LICENSE) para obter detalhes. +Este projeto é licenciado sob a Licença MIT - consulte o arquivo [LICENSE](LICENSE) para mais detalhes. ## 🙏 Agradecimentos
-Mostrar agradecimentos +Mostrar Agradecimentos
-

Um sincero obrigado a todos que contribuíram para este projeto abrindo um problema para sugerir uma melhoria ou relatar um bug.

+

Muito obrigado a todos que contribuíram para este projeto abrindo problemas para sugerir melhorias ou relatar erros.

- + - + - + - + - + - + - - - - - + + - - + + - - + + + + + + - + - + - - + + - +
Componentes principais
Componentes Principais
yt-dlpMecanismo de downloadMecanismo de Download
FFmpegProcessamento de mídiaProcessamento de Mídia
DenoTempo de execução para integração com yt-dlpRuntime para integração do yt-dlp
Bibliotecas e Estruturas
Bibliotecas e Frameworks
PySide6Estrutura GUIFramework GUI
TravesseiroProcessamento de imagem
solicitaçõesSolicitações HTTPPillowProcessamento de Imagens
embalagemManuseio de versões e pacotesrequestsRequisições HTTP
remarcaçãoRenderização de reduçãopackagingGerenciamento de Versão e Empacotamento
markdownRenderização de Markdown
loguruRegistroRegistro de Logs
Ativos e Contribuintes
Ativos e Contribuidores
Nova Notificação 09 por UniversfieldSom de notificaçãoNew Notification 09 de UniversfieldSom de Notificação
viru185Colaborador de códigoContribuidor de Código
@@ -605,14 +611,14 @@ Este projeto está licenciado sob a licença MIT - consulte o arquivo [LICENSE](
-## ⚠️ Isenção de responsabilidade +## ⚠️ Isenção de Responsabilidade -Esta ferramenta é apenas para uso pessoal. Respeite os termos de serviço do YouTube e os direitos dos criadores de conteúdo. +Esta ferramenta é apenas para uso pessoal. Respeite os Termos de Serviço do YouTube e os direitos dos produtores de conteúdo. ---
-Feito com ❤️ por [oop7](https://github.com/oop7) +Criado com ❤️ por [oop7](https://github.com/oop7)