Update Polish README translation and formatting
Apply copy edits and formatting fixes to readme-translations/README.pl.md: adjust wording and capitalization, standardize section headings and anchors (e.g. instalacja, funkcje, użycie), harmonize terminology (Download Settings, Generic Mode), fix tables and list formatting, update platform/executable descriptions and installation steps, revise screenshots alt text, clarify usage and troubleshooting instructions, and refresh localization & contributing sections for consistency.
This commit is contained in:
oop7
+260
-254
@@ -12,81 +12,82 @@
|
||||
[](https://pypi.org/project/ytsage/)
|
||||
[](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)
|
||||
|
||||
<p align="center">
|
||||
<a href="#installation">Instalacja</a> •
|
||||
<a href="#features">Funkcje</a> •
|
||||
<a href="#usage">Użycie</a> •
|
||||
<a href="#screenshots">Zrzuty ekranu</a> •
|
||||
<a href="#troubleshooting">Rozwiązywanie problemów</a> •
|
||||
<a href="#instalacja">Instalacja</a> •
|
||||
<a href="#funkcje">Funkcje</a> •
|
||||
<a href="#użycie">Użycie</a> •
|
||||
<a href="#zrzuty-ekranu">Zrzuty ekranu</a> •
|
||||
<a href="#rozwiązywanie-problemów">Rozwiązywanie problemów</a> •
|
||||
<a href="#sponsor">Sponsor</a> •
|
||||
<a href="#contributing">Wspieranie</a>
|
||||
<a href="#współpraca">Współpraca</a>
|
||||
</p>
|
||||
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
<a id="why-ytsage"></a>
|
||||
<a id="dlaczego-ytsage"></a>
|
||||
## ❓ 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
|
||||
|
||||
<a id="features"></a>
|
||||
<a id="funkcje"></a>
|
||||
## ✨ Funkcje
|
||||
|
||||
<div align="center">
|
||||
|
||||
| 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 | |
|
||||
</div>
|
||||
|
||||
<a id="installation"></a>
|
||||
<a id="instalacja"></a>
|
||||
## 🚀 Instalacja
|
||||
|
||||
### ⚡ Szybka instalacja (zalecane)
|
||||
### ⚡ Szybka instalacja (zalecana)
|
||||
|
||||
Zainstaluj YTSage z PyPI:
|
||||
Zainstaluj YTSage przez PyPI:
|
||||
|
||||
```bash
|
||||
pip install ytsage
|
||||
```
|
||||
|
||||
<details>
|
||||
<summary>🔄 Zaktualizuj istniejącą instalację</summary>
|
||||
<summary>🔄 Aktualizacja istniejącej instalacji</summary>
|
||||
|
||||
```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 |
|
||||
|--------|-------------|
|
||||
|  | Standardowy instalator |
|
||||
|  | Z pakietem FFmpeg |
|
||||
|  | Z dołączonym FFmpeg |
|
||||
|  | Wersja przenośna, nie wymaga instalacji |
|
||||
|  | Przenośny z FFmpeg, spakowany |
|
||||
|  | Przenośna z FFmpeg, skompresowana (ZIP) |
|
||||
|
||||
<details>
|
||||
<summary>🛠️ Kroki instalacji</summary>
|
||||
|
||||
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.
|
||||
</details>
|
||||
|
||||
#### 🐧 Linux
|
||||
|
||||
| Formatuj | Opis |
|
||||
|------------|------------|
|
||||
|  | Pakiet Debiana |
|
||||
|  | Obraz aplikacji, przenośny |
|
||||
| Format | Opis |
|
||||
|--------|-------------|
|
||||
|  | Pakiet Debian |
|
||||
|  | AppImage, przenośny |
|
||||
|  | Pakiet RPM |
|
||||
|  | 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 |
|
||||
|------------|------------|
|
||||
|  | Spakowana aplikacja dla Apple Silicon |
|
||||
|  | Instalator obrazu dysku dla Apple Silicon |
|
||||
| Format | Opis |
|
||||
|--------|-------------|
|
||||
|  | Aplikacja ZIP dla Apple Silicon |
|
||||
|  | Instalator Disk Image dla Apple Silicon |
|
||||
|
||||
<details>
|
||||
<summary>🛠️ Kroki instalacji</summary>
|
||||
|
||||
- **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.*
|
||||
</details>
|
||||
|
||||
---
|
||||
|
||||
<details>
|
||||
<summary>💻 Instalacja ręczna ze źródła</summary>
|
||||
<summary>💻 Ręczna instalacja ze źródeł</summary>
|
||||
|
||||
### 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
|
||||
|
||||
</details>
|
||||
|
||||
<a id="screenshots"></a>
|
||||
<a id="zrzuty-ekranu"></a>
|
||||
## 📸 Zrzuty ekranu
|
||||
|
||||
<div align="center">
|
||||
<table>
|
||||
<tr>
|
||||
<td><img src="../branding/screenshots/Download-Settings.png" alt="Download Settings" width="400"/></td>
|
||||
<td><img src="../branding/screenshots/playlist.png" alt="Playlist Download" width="400"/></td>
|
||||
<td><img src="../branding/screenshots/Download-Settings.png" alt="Ustawienia pobierania" width="400"/></td>
|
||||
<td><img src="../branding/screenshots/playlist.png" alt="Pobieranie playlisty" width="400"/></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="center"><em>Pobierz ustawienia</em></td>
|
||||
<td align="center"><em>Pobieranie listy odtwarzania</em></td>
|
||||
<td align="center"><em>Ustawienia pobierania</em></td>
|
||||
<td align="center"><em>Pobieranie playlisty</em></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><img src="../branding/screenshots/audio_format.png" alt="Audio Format Selection with Save Thumbnail" width="400"/></td>
|
||||
<td><img src="../branding/screenshots/Custom-Option.png" alt="Custom Options" width="400"/></td>
|
||||
<td><img src="../branding/screenshots/audio_format.png" alt="Wybór formatu audio" width="400"/></td>
|
||||
<td><img src="../branding/screenshots/Custom-Option.png" alt="Opcje niestandardowe" width="400"/></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="center"><em>Format audio</em></td>
|
||||
<td align="center"><em>Opcje niestandardowe</em></td>
|
||||
</tr>
|
||||
</table>
|
||||
</div><a id="usage"></a>
|
||||
</div>
|
||||
|
||||
<a id="użycie"></a>
|
||||
## 📖 Użycie
|
||||
|
||||
<details>
|
||||
<summary>🎯 Podstawowe użycie</summary>
|
||||
|
||||
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.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>📋 Pobieranie listy odtwarzania</summary>
|
||||
<summary>📋 Pobieranie playlisty</summary>
|
||||
|
||||
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`.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>🌍 Tryb ogólny dla witryn innych niż YouTube</summary>
|
||||
<summary>🌍 Tryb ogólny dla stron innych niż YouTube</summary>
|
||||
|
||||
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.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>🧰 Opcje multimediów i pobierania</summary>
|
||||
<summary>🧰 Opcje mediów i pobierania</summary>
|
||||
|
||||
- **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`.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>⚙️ Ustawienia wyjściowe i plikowe</summary>
|
||||
<summary>⚙️ Ustawienia wyjściowe i plików</summary>
|
||||
|
||||
- **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
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>🌐 Dostęp i sieć</summary>
|
||||
|
||||
- **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://<proxy-server>:<port>`
|
||||
- **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://<serwer-proxy>:<port>`
|
||||
- **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**.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>🛠️ Narzędzia i konserwacja</summary>
|
||||
|
||||
- **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**.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>🌍 Lokalizacja</summary>
|
||||
|
||||
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!
|
||||
|
||||
</details>
|
||||
|
||||
<a id="troubleshooting"></a>
|
||||
<a id="rozwiązywanie-problemów"></a>
|
||||
## 🛠️ Rozwiązywanie problemów
|
||||
|
||||
<details>
|
||||
<summary>Kliknij, aby wyświetlić typowe problemy i rozwiązania</summary>
|
||||
<summary>Kliknij, aby zobaczyć typowe problemy i rozwiązania</summary>
|
||||
|
||||
- **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<version>-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<wersja>-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
|
||||
<a id="sponsor"></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.
|
||||
|
||||
[](https://github.com/sponsors/oop7)
|
||||
|
||||
<a id="contributing"></a>
|
||||
## 👥 Wkład
|
||||
<a id="współpraca"></a>
|
||||
## 👥 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/<code>.json`
|
||||
- Jeśli brakuje Twojego języka, zacznij od `README.md` i utwórz `README.<code>.md`
|
||||
- Zaktualizuj odpowiedni lokalny plik README (np. `readme-translations/README.pl.md`)
|
||||
- Dbaj o synchronizację komunikatów aplikacji, edytując `ytsage/languages/<code>.json`
|
||||
- Jeśli brakuje Twojego języka, zacznij od `README.md` i stwórz `README.<code>.md`
|
||||
|
||||
<details>
|
||||
<summary>📂 Struktura projektu</summary>
|
||||
|
||||
## 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
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
## ⭐️ Historia gwiazd
|
||||
## ⭐️ Historia gwiazdek
|
||||
|
||||
<div align="center">
|
||||
|
||||
## Historia gwiazd
|
||||
## Star History
|
||||
|
||||
<a href="https://www.star-history.com/#oop7/YTSage&Date">
|
||||
<picture>
|
||||
@@ -539,9 +544,9 @@ YTSage/
|
||||
|
||||
</div>
|
||||
|
||||
## 📜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
|
||||
|
||||
<div align="center">
|
||||
|
||||
<p>Serdecznie dziękujemy wszystkim, którzy przyczynili się do tego projektu, otwierając problem, aby zasugerować ulepszenie lub zgłosić błąd.</p>
|
||||
<p>Wielkie podziękowania dla wszystkich, którzy przyczynili się do rozwoju projektu poprzez zgłaszanie sugestii i błędów.</p>
|
||||
|
||||
<table>
|
||||
<tr class="section"><th colspan="2">Główne komponenty</th></tr>
|
||||
<tr>
|
||||
<td width="35%"><a href="https://github.com/yt-dlp/yt-dlp">yt-dlp</a></td>
|
||||
<td>Pobierz silnik</td>
|
||||
<td>Silnik pobierania</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="https://ffmpeg.org/">FFmpeg</a></td>
|
||||
<td>Przetwarzanie multimediów</td>
|
||||
<td>Przetwarzanie mediów</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="https://deno.com/">Deno</a></td>
|
||||
<td>Środowisko wykonawcze do integracji z yt-dlp</td>
|
||||
<td>Środowisko dla integracji yt-dlp</td>
|
||||
</tr>
|
||||
<tr class="section"><th colspan="2">Biblioteki i struktury</th></tr>
|
||||
<tr class="section"><th colspan="2">Biblioteki i frameworki</th></tr>
|
||||
<tr>
|
||||
<td><a href="https://wiki.qt.io/Qt_for_Python">PySide6</a></td>
|
||||
<td>Struktura GUI</td>
|
||||
<td>Framework GUI</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="https://python-pillow.org/">Poduszka</a></td>
|
||||
<td>Przetwarzanie obrazu</td>
|
||||
<td><a href="https://python-pillow.org/">Pillow</a></td>
|
||||
<td>Przetwarzanie obrazów</td>
|
||||
</tr>
|
||||
<tr><td><a href="https://requests.readthedocs.io/">żądania</a></td>
|
||||
<tr>
|
||||
<td><a href="https://requests.readthedocs.io/">requests</a></td>
|
||||
<td>Żądania HTTP</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="https://packaging.python.org/">opakowanie</a></td>
|
||||
<td>Obsługa wersji i pakietów</td>
|
||||
<td><a href="https://packaging.python.org/">packaging</a></td>
|
||||
<td>Zarządzanie wersjami i pakowanie</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="https://python-markdown.github.io/">przecena</a></td>
|
||||
<td><a href="https://python-markdown.github.io/">markdown</a></td>
|
||||
<td>Renderowanie Markdown</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="https://github.com/Delgan/loguru">loguru</a></td>
|
||||
<td>Logowanie</td>
|
||||
</tr>
|
||||
<tr class="section"><th colspan="2">Zasoby i współtwórcy</th></tr>
|
||||
<tr class="section"><th colspan="2">Zasoby i współpracownicy</th></tr>
|
||||
<tr>
|
||||
<td><a href="https://pixabay.com/sound-effects/new-notification-09-352705/">Nowe powiadomienie 09 od Universfield</a></td>
|
||||
<td><a href="https://pixabay.com/sound-effects/new-notification-09-352705/">New Notification 09 by Universfield</a></td>
|
||||
<td>Dźwięk powiadomienia</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="https://github.com/viru185">viru185</a></td>
|
||||
<td>Współtwórca kodu</td>
|
||||
<td>Współpracownik kodu</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
@@ -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.
|
||||
|
||||
---
|
||||
|
||||
<div align="center">
|
||||
|
||||
Wykonane z ❤️ przez [oop7](https://github.com/oop7)
|
||||
Stworzone z ❤️ przez [oop7](https://github.com/oop7)
|
||||
|
||||
</div>
|
||||
|
||||
+263
-257
@@ -12,81 +12,82 @@
|
||||
[](https://pypi.org/project/ytsage/)
|
||||
[](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)
|
||||
|
||||
<p align="center">
|
||||
<a href="#installation">Instalação</a> •
|
||||
<a href="#features">Recursos</a> •
|
||||
<a href="#usage">Uso</a> •
|
||||
<a href="#screenshots">Capturas de tela</a> •
|
||||
<a href="#troubleshooting">Solução de problemas</a> •
|
||||
<a href="#sponsor">Patrocinador</a> •
|
||||
<a href="#contributing">Contribuindo</a>
|
||||
<a href="#instalação">Instalação</a> •
|
||||
<a href="#funcionalidades">Funcionalidades</a> •
|
||||
<a href="#uso">Uso</a> •
|
||||
<a href="#capturas-de-tela">Capturas de Tela</a> •
|
||||
<a href="#solução-de-problemas">Solução de Problemas</a> •
|
||||
<a href="#patrocinar">Patrocinar</a> •
|
||||
<a href="#contribuindo">Contribuindo</a>
|
||||
</p>
|
||||
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
<a id="why-ytsage"></a>
|
||||
<a id="por-que-ytsage"></a>
|
||||
## ❓ 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
|
||||
|
||||
<a id="features"></a>
|
||||
## ✨ Recursos
|
||||
<a id="funcionalidades"></a>
|
||||
## ✨ Funcionalidades
|
||||
|
||||
<div align="center">
|
||||
|
||||
| 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 | |
|
||||
</div>
|
||||
|
||||
<a id="installation"></a>
|
||||
<a id="instalação"></a>
|
||||
## 🚀 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
|
||||
```
|
||||
|
||||
<details>
|
||||
<summary>🔄 Atualizar uma instalação existente</summary>
|
||||
<summary>🔄 Atualizar Instalação Existente</summary>
|
||||
|
||||
```bash
|
||||
pip install --upgrade ytsage
|
||||
@@ -94,49 +95,49 @@ pip install --upgrade ytsage
|
||||
|
||||
</details>
|
||||
|
||||
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 |
|
||||
|--------|------------|
|
||||
|  | Instalador padrão |
|
||||
|--------|-------------|
|
||||
|  | Instalador Padrão |
|
||||
|  | Com FFmpeg incluído |
|
||||
|  | Versão portátil, sem necessidade de instalação |
|
||||
|  | Portátil com FFmpeg, compactado |
|
||||
|  | Versão Portátil, sem necessidade de instalação |
|
||||
|  | Portátil com FFmpeg, compactado (ZIP) |
|
||||
|
||||
<details>
|
||||
<summary>🛠️ Etapas de instalação</summary>
|
||||
<summary>🛠️ Passos para Instalação</summary>
|
||||
|
||||
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.
|
||||
</details>
|
||||
|
||||
#### 🐧Linux
|
||||
#### 🐧 Linux
|
||||
|
||||
| Formato | Descrição |
|
||||
|--------|------------|
|
||||
|--------|-------------|
|
||||
|  | Pacote Debian |
|
||||
|  | AppImage, portátil |
|
||||
|  | AppImage, Portátil |
|
||||
|  | Pacote RPM |
|
||||
|  | Pacote Flatpak |
|
||||
|
||||
<details>
|
||||
<summary>🛠️ Etapas de instalação</summary>
|
||||
<summary>🛠️ Passos para Instalação</summary>
|
||||
|
||||
- **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 |
|
||||
|--------|------------|
|
||||
|  | Aplicativo compactado para Apple Silicon |
|
||||
|  | Instalador de imagem de disco para Apple Silicon |
|
||||
|--------|-------------|
|
||||
|  | Aplicativo ZIP para Apple Silicon |
|
||||
|  | Instalador Disk Image para Apple Silicon |
|
||||
|
||||
<details>
|
||||
<summary>🛠️ Etapas de instalação</summary>
|
||||
<summary>🛠️ Passos para Instalação</summary>
|
||||
|
||||
- **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.*
|
||||
</details>
|
||||
|
||||
---
|
||||
|
||||
<details>
|
||||
<summary>💻 Instalação manual da fonte</summary>
|
||||
<summary>💻 Instalação Manual a partir do Código-Fonte</summary>
|
||||
|
||||
### 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
|
||||
|
||||
</details>
|
||||
|
||||
<a id="screenshots"></a>
|
||||
## 📸 Capturas de tela
|
||||
<a id="capturas-de-tela"></a>
|
||||
## 📸 Capturas de Tela
|
||||
|
||||
<div align="center">
|
||||
<table>
|
||||
<tr>
|
||||
<td><img src="../branding/screenshots/Download-Settings.png" alt="Download Settings" width="400"/></td>
|
||||
<td><img src="../branding/screenshots/playlist.png" alt="Playlist Download" width="400"/></td>
|
||||
<td><img src="../branding/screenshots/Download-Settings.png" alt="Configurações de Download" width="400"/></td>
|
||||
<td><img src="../branding/screenshots/playlist.png" alt="Download de Playlist" width="400"/></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="center"><em>Configurações de download</em></td>
|
||||
<td align="center"><em>Baixar lista de reprodução</em></td>
|
||||
<td align="center"><em>Configurações de Download</em></td>
|
||||
<td align="center"><em>Download de Playlist</em></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><img src="../branding/screenshots/audio_format.png" alt="Audio Format Selection with Save Thumbnail" width="400"/></td>
|
||||
<td><img src="../branding/screenshots/Custom-Option.png" alt="Custom Options" width="400"/></td>
|
||||
<td><img src="../branding/screenshots/audio_format.png" alt="Seleção de Formato de Áudio" width="400"/></td>
|
||||
<td><img src="../branding/screenshots/Custom-Option.png" alt="Opções Personalizadas" width="400"/></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="center"><em>Formato de áudio</em></td>
|
||||
<td align="center"><em>Opções personalizadas</em></td>
|
||||
<td align="center"><em>Formato de Áudio</em></td>
|
||||
<td align="center"><em>Opções Personalizadas</em></td>
|
||||
</tr>
|
||||
</table>
|
||||
</div><a id="usage"></a>
|
||||
</div>
|
||||
|
||||
<a id="uso"></a>
|
||||
## 📖 Uso
|
||||
|
||||
<details>
|
||||
<summary>🎯 Uso Básico</summary>
|
||||
|
||||
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.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>📋 Baixar lista de reprodução</summary>
|
||||
<summary>📋 Download de Playlist</summary>
|
||||
|
||||
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`.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>🌍 Modo genérico para sites que não são do YouTube</summary>
|
||||
<summary>🌍 Modo Genérico para Sites além do YouTube</summary>
|
||||
|
||||
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.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>🧰 Opções de mídia e download</summary>
|
||||
<summary>🧰 Opções de Mídia e Download</summary>
|
||||
|
||||
- **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`.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>⚙️ Configurações de saída e arquivo</summary>
|
||||
<summary>⚙️ Configurações de Saída e Arquivos</summary>
|
||||
|
||||
- **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
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>🌐 Acesso e Rede</summary>
|
||||
|
||||
- **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://<proxy-server>:<port>`
|
||||
- **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://<proxy-server>:<port>`
|
||||
- **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**.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>🛠️ Ferramentas e Manutenção</summary>
|
||||
|
||||
- **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**.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>🌍 Localização</summary>
|
||||
|
||||
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!
|
||||
|
||||
</details>
|
||||
|
||||
<a id="troubleshooting"></a>
|
||||
## 🛠️ Solução de problemas
|
||||
<a id="solução-de-problemas"></a>
|
||||
## 🛠️ Solução de Problemas
|
||||
|
||||
<details>
|
||||
<summary>Clique para ver problemas e soluções comuns</summary>
|
||||
<summary>Clique para ver problemas comuns e soluções</summary>
|
||||
|
||||
- **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<version>-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<versão>-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`
|
||||
|
||||
</details>
|
||||
|
||||
<a id="sponsor"></a>
|
||||
## 💖 Patrocinador
|
||||
<a id="patrocinar"></a>
|
||||
## 💖 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.
|
||||
|
||||
[](https://github.com/sponsors/oop7)
|
||||
|
||||
<a id="contributing"></a>
|
||||
<a id="contribuindo"></a>
|
||||
## 👥 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/<code>.json`
|
||||
- Se o seu idioma estiver faltando, comece em `README.md` e crie `README.<code>.md`
|
||||
- Atualize o arquivo README localizado relevante (ex: `readme-translations/README.pt.md`)
|
||||
- Mantenha as strings do aplicativo em sincronia editando `ytsage/languages/<code>.json`
|
||||
- Se o seu idioma estiver ausente, comece pelo `README.md` e crie `README.<code>.md`
|
||||
|
||||
<details>
|
||||
<summary>📂 Estrutura do Projeto</summary>
|
||||
@@ -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
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
## ⭐️ História da estrela
|
||||
## ⭐️ Histórico de Estrelas
|
||||
|
||||
<div align="center">
|
||||
|
||||
## História da estrela
|
||||
## Star History
|
||||
|
||||
<a href="https://www.star-history.com/#oop7/YTSage&Date">
|
||||
<picture>
|
||||
@@ -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
|
||||
|
||||
<details>
|
||||
<summary>Mostrar agradecimentos</summary>
|
||||
<summary>Mostrar Agradecimentos</summary>
|
||||
|
||||
<div align="center">
|
||||
|
||||
<p>Um sincero obrigado a todos que contribuíram para este projeto abrindo um problema para sugerir uma melhoria ou relatar um bug.</p>
|
||||
<p>Muito obrigado a todos que contribuíram para este projeto abrindo problemas para sugerir melhorias ou relatar erros.</p>
|
||||
|
||||
<table>
|
||||
<tr class="section"><th colspan="2">Componentes principais</th></tr>
|
||||
<tr class="section"><th colspan="2">Componentes Principais</th></tr>
|
||||
<tr>
|
||||
<td width="35%"><a href="https://github.com/yt-dlp/yt-dlp">yt-dlp</a></td>
|
||||
<td>Mecanismo de download</td>
|
||||
<td>Mecanismo de Download</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="https://ffmpeg.org/">FFmpeg</a></td>
|
||||
<td>Processamento de mídia</td>
|
||||
<td>Processamento de Mídia</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="https://deno.com/">Deno</a></td>
|
||||
<td>Tempo de execução para integração com yt-dlp</td>
|
||||
<td>Runtime para integração do yt-dlp</td>
|
||||
</tr>
|
||||
<tr class="section"><th colspan="2">Bibliotecas e Estruturas</th></tr>
|
||||
<tr class="section"><th colspan="2">Bibliotecas e Frameworks</th></tr>
|
||||
<tr>
|
||||
<td><a href="https://wiki.qt.io/Qt_for_Python">PySide6</a></td>
|
||||
<td>Estrutura GUI</td>
|
||||
<td>Framework GUI</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="https://python-pillow.org/">Travesseiro</a></td>
|
||||
<td>Processamento de imagem</td>
|
||||
</tr>
|
||||
<tr><td><a href="https://requests.readthedocs.io/">solicitações</a></td>
|
||||
<td>Solicitações HTTP</td>
|
||||
<td><a href="https://python-pillow.org/">Pillow</a></td>
|
||||
<td>Processamento de Imagens</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="https://packaging.python.org/">embalagem</a></td>
|
||||
<td>Manuseio de versões e pacotes</td>
|
||||
<td><a href="https://requests.readthedocs.io/">requests</a></td>
|
||||
<td>Requisições HTTP</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="https://python-markdown.github.io/">remarcação</a></td>
|
||||
<td>Renderização de redução</td>
|
||||
<td><a href="https://packaging.python.org/">packaging</a></td>
|
||||
<td>Gerenciamento de Versão e Empacotamento</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="https://python-markdown.github.io/">markdown</a></td>
|
||||
<td>Renderização de Markdown</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="https://github.com/Delgan/loguru">loguru</a></td>
|
||||
<td>Registro</td>
|
||||
<td>Registro de Logs</td>
|
||||
</tr>
|
||||
<tr class="section"><th colspan="2">Ativos e Contribuintes</th></tr>
|
||||
<tr class="section"><th colspan="2">Ativos e Contribuidores</th></tr>
|
||||
<tr>
|
||||
<td><a href="https://pixabay.com/sound-effects/new-notification-09-352705/">Nova Notificação 09 por Universfield</a></td>
|
||||
<td>Som de notificação</td>
|
||||
<td><a href="https://pixabay.com/sound-effects/new-notification-09-352705/">New Notification 09 de Universfield</a></td>
|
||||
<td>Som de Notificação</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="https://github.com/viru185">viru185</a></td>
|
||||
<td>Colaborador de código</td>
|
||||
<td>Contribuidor de Código</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
@@ -605,14 +611,14 @@ Este projeto está licenciado sob a licença MIT - consulte o arquivo [LICENSE](
|
||||
|
||||
</details>
|
||||
|
||||
## ⚠️ 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.
|
||||
|
||||
---
|
||||
|
||||
<div align="center">
|
||||
|
||||
Feito com ❤️ por [oop7](https://github.com/oop7)
|
||||
Criado com ❤️ por [oop7](https://github.com/oop7)
|
||||
|
||||
</div>
|
||||
|
||||
Reference in New Issue
Block a user