Add README translations and language links
Add localized README files and update main README to expose them. Creates readme-translations/*.md (Arabic, German, Spanish, French, Hindi, Indonesian, Italian, Japanese, Polish, Portuguese, Russian, Turkish, Chinese) and adds a language list, README Translations table, and a "Contributing Translations" subsection to README.md so contributors can find and update localized docs.
This commit is contained in:
oop7
@@ -0,0 +1,617 @@
|
||||
<div align="center">
|
||||
|
||||
<img src="../branding/svg/ytsage-wordmark.svg" width="400" alt="ytsage-wordmark">
|
||||
<img src="../branding/screenshots/main.png" width="800" alt="YTSage Interface"/>
|
||||
|
||||
[](https://www.python.org/downloads/)
|
||||
[](https://pepy.tech/project/ytsage)
|
||||
[](https://github.com/oop7/YTSage/releases)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://github.com/oop7/YTSage/releases)
|
||||
[](https://github.com/oop7/YTSage/stargazers)
|
||||
[](https://pypi.org/project/ytsage/)
|
||||
[](https://github.com/sponsors/oop7)
|
||||
|
||||
**Pengunduh YouTube modern dengan antarmuka PySide6 yang bersih.**
|
||||
Unduh video dalam kualitas apa pun, ekstrak audio, ambil subtitle, dan banyak lagi.
|
||||
|
||||
### 🌍 README Bahasa
|
||||
|
||||
Bahasa Inggris: [EN](../README.md)
|
||||
| Nilai: [AR](README.ar.md)
|
||||
| Jerman: [DE](README.de.md)
|
||||
| Spanyol: [ES](README.es.md)
|
||||
| Perancis: [FR](README.fr.md)
|
||||
| nilai: [HI](README.hi.md)
|
||||
| Bahasa Indonesia: [ID](README.id.md)
|
||||
| Italia: [IT](README.it.md)
|
||||
| Nilai: [JA](README.ja.md)
|
||||
| Polski: [PL](README.pl.md)
|
||||
| Portugis: [PT](README.pt.md)
|
||||
| Jawaban: [RU](README.ru.md)
|
||||
| Turki: [TR](README.tr.md)
|
||||
| nama: [ZH](README.zh.md)
|
||||
|
||||
<p align="center">
|
||||
<a href="#installation">Instalasi</a> •
|
||||
<a href="#features">Fitur</a> •
|
||||
<a href="#usage">Penggunaan</a> •
|
||||
<a href="#screenshots">Tangkapan Layar</a> •
|
||||
<a href="#troubleshooting">Pemecahan Masalah</a> •
|
||||
<a href="#sponsor">Sponsor</a> •
|
||||
<a href="#contributing">Berkontribusi</a>
|
||||
</p>
|
||||
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
<a id="why-ytsage"></a>
|
||||
## ❓ Mengapa YTSage?
|
||||
|
||||
YTSage dirancang untuk pengguna yang menginginkan **pengunduh YouTube yang sederhana namun kuat**. Tidak seperti alat lainnya, alat ini menawarkan:
|
||||
|
||||
- Antarmuka PySide6 yang bersih dan modern
|
||||
- Unduhan sekali klik untuk video, audio, dan subtitle
|
||||
- Fitur lanjutan seperti SponsorBlock, penggabungan subtitle, dan pemilihan playlist
|
||||
- Mode Generik Opsional untuk situs yang didukung yt-dlp di luar YouTube
|
||||
- Dukungan lintas platform dan instalasi mudah
|
||||
|
||||
<a id="features"></a>
|
||||
## ✨ Fitur
|
||||
|
||||
<div align="center">
|
||||
|
||||
| Fitur Inti | Fitur Lanjutan | Fitur Ekstra |
|
||||
|----------------------------------||-----------------------------------------|------------------------------------|
|
||||
| 🎥 Format Tabel | 🚫 Integrasi Blok Sponsor | 🎞️ Tampilan FPS/HDR |
|
||||
| 🎵 Ekstraksi Audio | 📝 Pilih & Gabungkan Multi-Subjudul | 🔄 Perbarui Otomatis yt-dlp |
|
||||
| ✨ UI Sederhana | 💾 Simpan Deskripsi & Gambar Kecil | 🛠️ Deteksi FFmpeg/yt-dlp/Deno |
|
||||
| 📋 Dukungan & Pemilih Daftar Putar | 🚀 Pembatas Kecepatan | ⚙️ Perintah Khusus |
|
||||
| 📑 Sematkan Bab | ✂️ Pangkas Bagian Video | 🍪 Masuk dengan Cookie |
|
||||
| 📜 Unduh Riwayat | 🔄 Rilis Pilihan Saluran | 🌐 Dukungan Proksi |
|
||||
| 🎚️ Konversi Format Audio | 🎬 Pengaturan Format Video | 🆙 Tab Pembaruan Bawaan |
|
||||
| 🌍 Mode Generik |
|
||||
| 🌍 Lokalisasi dalam 14 Bahasa | |
|
||||
</div>
|
||||
|
||||
<a id="installation"></a>
|
||||
## 🚀 Instalasi
|
||||
|
||||
### ⚡ Instal Cepat (Disarankan)
|
||||
|
||||
Instal YTSage dari PyPI:
|
||||
|
||||
```bash
|
||||
pip install ytsage
|
||||
```
|
||||
|
||||
<details>
|
||||
<summary>🔄 Perbarui instalasi yang ada</summary>
|
||||
|
||||
```bash
|
||||
pip install --upgrade ytsage
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
Kemudian luncurkan aplikasi:
|
||||
|
||||
```bash
|
||||
ytsage
|
||||
```
|
||||
|
||||
### 📦 Executable yang sudah dibuat sebelumnya
|
||||
|
||||
> [👉 Download Latest Release](https://github.com/oop7/YTSage/releases/latest)
|
||||
|
||||
#### 🪟 Jendela
|
||||
|
||||
| Format | Deskripsi |
|
||||
|--------|-------------|
|
||||
|  | Pemasang standar |
|
||||
|  | Dengan FFmpeg dibundel |
|
||||
|  | Versi portabel, tidak perlu instalasi |
|
||||
|  | Portabel dengan FFmpeg, zip |
|
||||
|
||||
<details>
|
||||
<summary>🛠️ Langkah Instalasi</summary>
|
||||
|
||||
1. **EXE Installer (`.exe`)**: Klik dua kali file tersebut dan ikuti panduan pengaturan.
|
||||
2. **Versi Portabel (`.zip`)**: Ekstrak arsip ke lokasi yang Anda inginkan dan jalankan `ytsage.exe`.
|
||||
3. **FFmpeg Bundled**: Pilih versi paket FFmpeg jika Anda belum menginstal FFmpeg di sistem Anda.
|
||||
</details>
|
||||
|
||||
#### 🐧 Linux
|
||||
|
||||
| Format | Deskripsi |
|
||||
|--------|-------------|
|
||||
|  | Paket Debian |
|
||||
|  | AppImage, portabel |
|
||||
|  | Paket RPM |
|
||||
|  | Paket Flatpak |
|
||||
|
||||
<details>
|
||||
<summary>🛠️ Langkah Instalasi</summary>
|
||||
|
||||
- **DEB (`.deb`)**:
|
||||
```bash
|
||||
sudo dpkg -i ytsage_*.deb
|
||||
sudo apt-get install -f # Fix missing dependencies if any
|
||||
```
|
||||
- **RPM (`.rpm`)**:
|
||||
```bash
|
||||
sudo rpm -i ytsage-*.rpm
|
||||
```
|
||||
- **Gambar Aplikasi (`.AppImage`)**:
|
||||
```bash
|
||||
chmod +x YTSage-*.AppImage
|
||||
./YTSage-*.AppImage
|
||||
```
|
||||
- **Flatpak**: Ikuti instruksi di Flathub atau jalankan:
|
||||
```bash
|
||||
flatpak install flathub io.github.oop7.ytsage
|
||||
```
|
||||
</details>
|
||||
|
||||
#### 🍎 macOS
|
||||
|
||||
| Format | Deskripsi |
|
||||
|--------|-------------|
|
||||
|  | Aplikasi zip untuk Apple Silicon |
|
||||
|  | Penginstal gambar disk untuk Apple Silicon |
|
||||
|
||||
<details>
|
||||
<summary>🛠️ Langkah Instalasi</summary>
|
||||
|
||||
- **Pemasang DMG (`.dmg`)**: Klik dua kali untuk memasang, lalu seret `YTSage.app` ke dalam folder Aplikasi Anda.
|
||||
- **Arsip Aplikasi (`.zip`)**: Ekstrak zip dan pindahkan `YTSage.app` ke folder Aplikasi Anda.
|
||||
|
||||
*Catatan: Jika Anda mengalami kesalahan "Aplikasi rusak", lihat [macOS troubleshooting section](#troubleshooting) di bawah.*
|
||||
</details>
|
||||
|
||||
---
|
||||
|
||||
<details>
|
||||
<summary>💻 Instalasi Manual dari Sumber</summary>
|
||||
|
||||
### 1. Kloning Repositori
|
||||
|
||||
```bash
|
||||
git clone https://github.com/oop7/YTSage.git
|
||||
cd YTSage
|
||||
```
|
||||
|
||||
### 2. Instal Dependensi
|
||||
|
||||
#### ⚡ Dengan UV
|
||||
|
||||
```bash
|
||||
uv pip install .
|
||||
```
|
||||
|
||||
#### 📦 Atau dengan pip standar
|
||||
|
||||
```bash
|
||||
pip install .
|
||||
```
|
||||
|
||||
### 3. Jalankan Aplikasi
|
||||
|
||||
```bash
|
||||
python -m ytsage.main
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
<a id="screenshots"></a>
|
||||
## 📸 Tangkapan layar
|
||||
|
||||
<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>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="center"><em>Pengaturan Unduhan</em></td>
|
||||
<td align="center"><em>Unduh Daftar Putar</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>
|
||||
</tr>
|
||||
<tr>
|
||||
<td align="center"><em>Format Audio</em></td>
|
||||
<td align="center"><em>Opsi Khusus</em></td>
|
||||
</tr>
|
||||
</table>
|
||||
</div><a id="usage"></a>
|
||||
## 📖 Penggunaan
|
||||
|
||||
<details>
|
||||
<summary>🎯 Penggunaan Dasar</summary>
|
||||
|
||||
1. **Luncurkan YTSage**
|
||||
2. **Tempel URL YouTube** (atau gunakan tombol "Tempel URL")
|
||||
3. **Klik "Analisis"**
|
||||
4. **Pilih Format:**
|
||||
- `Video` untuk mengunduh video
|
||||
- `Audio Only` untuk ekstraksi audio
|
||||
5. **Pilih Opsi:**
|
||||
- Aktifkan subtitle & pilih bahasa
|
||||
- Aktifkan penggabungan subtitle
|
||||
- Simpan gambar kecil
|
||||
- Hapus segmen sponsor
|
||||
- Simpan deskripsi
|
||||
- Sematkan bab
|
||||
6. **Pilih Direktori Keluaran**
|
||||
7. **Klik "Unduh"**
|
||||
|
||||
> 💡 Direktori unduhan default adalah folder "Unduhan" milik pengguna.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>📋 Unduh Daftar Putar</summary>
|
||||
|
||||
1. **Tempel URL Daftar Putar**
|
||||
2. **Klik "Analisis"**
|
||||
3. **Pilih video dari pemilih daftar putar (opsional, default untuk semua)**
|
||||
4. **Pilih format/kualitas yang diinginkan**
|
||||
5. **Klik "Unduh"**
|
||||
|
||||
> 💡 Aplikasi secara otomatis menangani antrian unduhan
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>🌍 Mode Generik untuk situs non-YouTube</summary>
|
||||
|
||||
Gunakan Mode Generik bila Anda ingin YTSage menerima URL dari situs yang didukung oleh yt-dlp, seperti Dailymotion, CBC Gem, TikTok, dan lainnya.
|
||||
|
||||
Cara menggunakannya:
|
||||
|
||||
1. Buka `Download Settings`.
|
||||
2. Aktifkan `Generic Mode`.
|
||||
3. Tempelkan URL video atau playlist non-YouTube yang didukung.
|
||||
4. Klik `Analyze`.
|
||||
5. Pilih format dan unduh seperti biasa.
|
||||
|
||||
Catatan:
|
||||
|
||||
- Mode Generik hanya mengubah validasi URL di dalam YTSage. Situs target harus tetap didukung oleh versi yt-dlp yang Anda instal.
|
||||
- Beberapa situs memerlukan cookie, sesi login, proxy, atau argumen yt-dlp tambahan tergantung pada ekstraktornya.
|
||||
- Jika situs gagal, perbarui yt-dlp terlebih dahulu dari tab pembaru bawaan sebelum melaporkan masalah tersebut.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>🧰 Opsi Media dan Unduhan</summary>
|
||||
|
||||
- **Opsi Subtitle:** Filter bahasa dan sematkan subtitle ke dalam file video
|
||||
- **Penggabungan Subtitle:** Menggabungkan subtitle ke dalam file video untuk subtitle hardcode
|
||||
- **Simpan Deskripsi:** Simpan deskripsi video sebagai file teks
|
||||
- **Simpan Gambar Kecil:** Menyimpan gambar kecil video sebagai file gambar
|
||||
- **Sematkan Bab:** Sematkan penanda bab sebagai metadata untuk pemutar video yang kompatibel
|
||||
- **Hapus Segmen Sponsor:** Hapus segmen sponsor dari video menggunakan SponsorBlock
|
||||
- **Pangkas Video:** Unduh hanya bagian tertentu dari video dengan menentukan rentang waktu dalam format `HH:MM:SS`
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>⚙️ Pengaturan Output dan File</summary>
|
||||
|
||||
- **Pembatas Kecepatan:** Batasi kecepatan unduh, misalnya `500K` sebesar 500 KB/dtk
|
||||
- **Simpan Jalur Unduhan:** Simpan jalur unduhan default untuk unduhan berikutnya. Tersedia di **Pengaturan Unduhan → Jalur Unduhan**.
|
||||
- **Format Nama File Keluaran:** Sesuaikan format nama file keluaran menggunakan variabel seperti `%(title)s`, `%(uploader)s`, dan `%(resolution)s`. Tersedia di **Pengaturan Unduhan → Format Nama File**.
|
||||
- **Format Output Paksa:** Paksa pengunduhan video ke dalam format wadah tertentu seperti `mp4`, `webm`, atau `mkv`. Tersedia di **Pengaturan Unduhan → Pengaturan Format Output**.
|
||||
- **Konversi Format Audio:** Konversi unduhan audio saja ke format pilihan seperti `AAC`, `MP3`, `FLAC`, `WAV`, `Opus`, `M4A`, `Vorbis`, atau `Best`. Tersedia di **Pengaturan Unduhan → Pengaturan Format Audio**.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>🌐 Akses dan Jaringan</summary>
|
||||
|
||||
- **Masuk dengan Cookie:** Masuk ke YouTube menggunakan cookie untuk mengakses konten pribadi.
|
||||
Cara menggunakannya:
|
||||
1. **Disarankan:** Gunakan opsi `Extract cookies from browser` bawaan di aplikasi, lalu pilih browser Anda dan opsional profil.
|
||||
2. Alternatifnya, ekstrak cookie secara manual:
|
||||
sebuah. Ekspor cookie dari browser Anda menggunakan ekstensi seperti [cookie-editor](https://github.com/moustachauve/cookie-editor?tab=readme-ov-file)
|
||||
b. Salin cookie dalam format Netscape
|
||||
c. Buat file bernama `cookies.txt` dan tempel cookie ke dalamnya
|
||||
d. Pilih file `cookies.txt` di aplikasi
|
||||
- **Dukungan Proxy:** Gunakan server proxy untuk mendownload, misalnya `http://<proxy-server>:<port>`
|
||||
- **Mode Generik:** Izinkan YTSage menganalisis dan mengunduh dari situs non-YouTube yang didukung oleh yt-dlp. Aktifkan dari **Pengaturan Unduhan → Mode Generik**.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>🛠️ Alat dan Perawatan</summary>
|
||||
|
||||
- **Perintah Khusus:** Akses fitur yt-dlp tingkat lanjut melalui argumen baris perintah
|
||||
- **Tab Pembaruan:** Kelola alat pembaruan bawaan dari satu tempat di Opsi Kustom:
|
||||
- **Pembaruan yt-dlp:** Periksa pembaruan dan beralih antara saluran rilis Stabil dan Malam
|
||||
- **Pemeriksa Versi FFmpeg:** Periksa versi FFmpeg Anda dan buka panduan instalasi
|
||||
- **Pembaruan Deno:** Periksa dan perbarui runtime Deno
|
||||
- **Deteksi FFmpeg/yt-dlp/Deno:** Secara otomatis mendeteksi jalur dan versi FFmpeg, yt-dlp, dan Deno dari dialog Tentang.
|
||||
- **Riwayat Unduhan:** Lihat unduhan sebelumnya dengan thumbnail dan status dari tombol **Riwayat**.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>🌍 Lokalisasi</summary>
|
||||
|
||||
YTSage mendukung **14 bahasa** untuk aksesibilitas di seluruh dunia. Pilih bahasa pilihan Anda dari **Opsi Kustom → Bahasa**.
|
||||
|
||||
### Bahasa yang Didukung
|
||||
|
||||
| Bahasa | Kode | Bahasa | Kode |
|
||||
|----------|------|----------|------|
|
||||
| 🇮🇩 Bahasa Inggris | `en` | 🇪🇪 Spanyol | `es` |
|
||||
| Arab Saudi | `ar` | 🇫🇷 Perancis | `fr` |
|
||||
| 🇩🇪 Jerman | `de` | 🇮🇩 Hindi | `hi` |
|
||||
| 🇮🇩 Bahasa Indonesia | `id` | 🇮🇹 Italia | `it` |
|
||||
| 🇯ppa Jepang | `ja` | 🇱 Polandia | `pl` |
|
||||
| 🇧🇷 Portugis | `pt` | 🇷л Rusia | `ru` |
|
||||
| 🇹🇷 Turki | `tr` | CNY Cina | `zh` |
|
||||
|
||||
### README Terjemahan
|
||||
|
||||
| Bahasa | Berkas | Bahasa | Berkas |
|
||||
|----------|------|----------|------|
|
||||
| 🇮🇩 Bahasa Inggris | [README.md](../README.md) | 🇪🇪 Spanyol | [README.es.md](README.es.md)
|
||||
| Arab Saudi | [README.ar.md](README.ar.md) | 🇫🇷 Perancis | [README.fr.md](README.fr.md) |
|
||||
| 🇩🇪 Jerman | [README.de.md](README.de.md) | 🇮🇩 Hindi | [README.hi.md](README.hi.md) |
|
||||
| 🇮🇩 Bahasa Indonesia | [README.id.md](README.id.md) | 🇮🇹 Italia | [README.it.md](README.it.md) |
|
||||
| 🇯ppa Jepang | [README.ja.md](README.ja.md) | 🇱 Polandia | [README.pl.md](README.pl.md) |
|
||||
| 🇧🇷 Portugis | [README.pt.md](README.pt.md) | 🇷л Rusia | [README.ru.md](README.ru.md) |
|
||||
| 🇹🇷 Turki | [README.tr.md](README.tr.md) | CNY Cina | [README.zh.md](README.zh.md) |
|
||||
|
||||
> 💡 **Ingin berkontribusi terjemahan?** Lihat bagian [Contributing](#contributing) untuk membantu kami menambahkan lebih banyak bahasa!
|
||||
|
||||
</details>
|
||||
|
||||
<a id="troubleshooting"></a>
|
||||
## 🛠️ Pemecahan masalah
|
||||
|
||||
<details>
|
||||
<summary>Klik untuk melihat masalah umum dan solusinya</summary>
|
||||
|
||||
- **Format tabel tidak ditampilkan:** Perbarui yt-dlp ke versi terbaru, dan beralih ke yt-dlp setiap malam.
|
||||
- **Pengunduhan gagal:** Periksa koneksi internet Anda dan pastikan video tersedia.
|
||||
- **Kesalahan pengunduhan tertentu:**
|
||||
- **Video pribadi:** Gunakan autentikasi cookie untuk mengakses konten pribadi.
|
||||
- **Konten dengan batasan usia:** Masuk ke akun YouTube untuk melihat video dengan batasan usia.
|
||||
- **Video yang diblokir secara geografis:** Pertimbangkan untuk menggunakan VPN untuk melewati batasan regional.
|
||||
- **Video yang dihapus/dihapus:** Video tidak lagi tersedia di YouTube.
|
||||
- **Streaming langsung:** Streaming langsung tidak dapat diunduh; tunggu hingga streaming berakhir.
|
||||
- **Kesalahan jaringan:** Periksa koneksi internet Anda dan coba lagi.
|
||||
- **URL tidak valid:** Pastikan URL benar dan berasal dari platform yang didukung.
|
||||
- **Konten premium:** Memerlukan keanggotaan YouTube Premium.
|
||||
- **Pemblokiran hak cipta:** Konten diblokir karena pembatasan hak cipta.
|
||||
- **Pisahkan file video dan audio setelah diunduh:** Ini terjadi jika FFmpeg hilang atau tidak terdeteksi. YTSage memerlukan FFmpeg untuk menggabungkan aliran video dan audio berkualitas tinggi.
|
||||
- **Solusi:** Pastikan FFmpeg diinstal dan dapat diakses di PATH sistem Anda. Untuk pengguna Windows, opsi termudah adalah mengunduh file `YTSage-v<version>-ffmpeg.exe`, yang disertakan dengan FFmpeg.
|
||||
|
||||
---
|
||||
|
||||
#### 🛡️ Peringatan Windows Defender / Antivirus
|
||||
|
||||
Beberapa perangkat lunak antivirus mungkin menandai file `.exe` sebagai positif palsu. Ini adalah **batasan umum** pada aplikasi paket.
|
||||
|
||||
**Mengapa ini terjadi:**
|
||||
- Heuristik antivirus dapat salah mengidentifikasi executable yang dikemas sebagai sesuatu yang mencurigakan
|
||||
|
||||
**Alternatif yang aman:**
|
||||
- ✅ **Gunakan instalasi pip:** `pip install ytsage` (disarankan)
|
||||
- ✅ **Bangun dari sumber**: dengan mengikuti [guide](../.github/CI_CD_README.md) ini
|
||||
- ✅ **Masukkan aplikasi ke daftar putih** di perangkat lunak antivirus Anda
|
||||
|
||||
#### 🍎 macOS: "Aplikasi rusak dan tidak dapat dibuka"
|
||||
Jika Anda melihat kesalahan ini di macOS Sonoma atau lebih baru, Anda harus menghapus atribut karantina.
|
||||
|
||||
1. **Buka Terminal** (Anda dapat menemukannya menggunakan Spotlight).
|
||||
2. **Ketik perintah berikut** tetapi **jangan** tekan Enter dulu. Pastikan untuk menyertakan spasi di akhir:
|
||||
```bash
|
||||
xattr -d com.apple.quarantine
|
||||
```
|
||||
3. **Seret file `YTSage.app`** dari jendela Finder Anda dan letakkan langsung ke jendela Terminal. Ini secara otomatis akan menempelkan jalur file yang benar.
|
||||
4. **Tekan Enter** untuk menjalankan perintah.
|
||||
5. **Coba buka YTSage.app lagi.** Sekarang seharusnya sudah diluncurkan dengan benar.
|
||||
|
||||
---
|
||||
|
||||
#### **Lokasi Konfigurasi (Lanjutan)**
|
||||
- **Jendela:** `%LOCALAPPDATA%\YTSage`
|
||||
- **macOS:** `~/Library/Application Support/YTSage`
|
||||
- **Linux:** `~/.local/share/YTSage`
|
||||
|
||||
</details>
|
||||
|
||||
<a id="sponsor"></a>
|
||||
## 💖 Sponsor
|
||||
|
||||
Jika YTSage menghemat waktu Anda, pertimbangkan untuk mensponsori proyek tersebut. Sponsor membantu menutupi waktu pengembangan, pengujian lintas platform, dan peningkatan di masa depan.
|
||||
|
||||
- Sponsor GitHub: https://github.com/sponsors/oop7
|
||||
- Tautan sponsor juga tersedia langsung di dalam aplikasi dari dialog Tentang.
|
||||
|
||||
[](https://github.com/sponsors/oop7)
|
||||
|
||||
<a id="contributing"></a>
|
||||
## 👥 Berkontribusi
|
||||
|
||||
Kami menyambut kontribusi! Inilah cara Anda dapat membantu:
|
||||
|
||||
1. 🍴 Cabangkan repositori
|
||||
2. 🌿 Buat cabang fitur Anda:
|
||||
```bash
|
||||
git checkout -b feature/AmazingFeature
|
||||
```
|
||||
3. 💾 Komit perubahan Anda:
|
||||
```bash
|
||||
git commit -m 'Add some AmazingFeature'
|
||||
```
|
||||
4. 📤 Dorong ke cabang:
|
||||
```bash
|
||||
git push origin feature/AmazingFeature
|
||||
```
|
||||
5. 🔄 Buka Permintaan Tarik
|
||||
|
||||
### 🌍 Berkontribusi pada Terjemahan
|
||||
|
||||
- Perbarui file README lokal yang cocok (misalnya `README.es.md`)
|
||||
- Jaga agar string aplikasi tetap sinkron dengan mengedit `ytsage/languages/<code>.json`
|
||||
- Jika bahasa Anda hilang, mulai dari `README.md` dan buat `README.<code>.md`
|
||||
|
||||
<details>
|
||||
<summary>📂 Struktur Proyek</summary>
|
||||
|
||||
## YTSage - Struktur Proyek
|
||||
|
||||
Dokumen ini menjelaskan struktur folder YTSage yang terorganisir.
|
||||
|
||||
### 📁 Struktur Proyek
|
||||
|
||||
```
|
||||
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
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
## ⭐️ Sejarah Bintang
|
||||
|
||||
<div align="center">
|
||||
|
||||
## Sejarah Bintang
|
||||
|
||||
<a href="https://www.star-history.com/#oop7/YTSage&Date">
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=oop7/YTSage&type=Date&theme=dark" />
|
||||
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=oop7/YTSage&type=Date" />
|
||||
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=oop7/YTSage&type=Date" />
|
||||
</picture>
|
||||
</a>
|
||||
|
||||
</div>
|
||||
|
||||
## 📜 Lisensi
|
||||
|
||||
Proyek ini dilisensikan di bawah Lisensi MIT - lihat file [LICENSE](../LICENSE) untuk detailnya.
|
||||
|
||||
## 🙏 Ucapan Terima Kasih
|
||||
|
||||
<details>
|
||||
<summary>Tampilkan Ucapan Terima Kasih</summary>
|
||||
|
||||
<div align="center">
|
||||
|
||||
<p>Terima kasih yang sebesar-besarnya kepada semua orang yang telah berkontribusi pada proyek ini dengan membuka terbitan untuk menyarankan perbaikan atau melaporkan bug.</p>
|
||||
|
||||
<table>
|
||||
<tr class="section"><th colspan="2">Komponen Inti</th></tr>
|
||||
<tr>
|
||||
<td width="35%"><a href="https://github.com/yt-dlp/yt-dlp">yt-dlp</a></td>
|
||||
<td>Mesin Unduh</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="https://ffmpeg.org/">FFmpeg</a></td>
|
||||
<td>Pemrosesan Media</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="https://deno.com/">Deno</a></td>
|
||||
<td>Waktu proses untuk integrasi dengan yt-dlp</td>
|
||||
</tr>
|
||||
<tr class="section"><th colspan="2">Perpustakaan & Kerangka Kerja</th></tr>
|
||||
<tr>
|
||||
<td><a href="https://wiki.qt.io/Qt_for_Python">PySide6</a></td>
|
||||
<td>Kerangka GUI</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="https://python-pillow.org/">Bantal</a></td>
|
||||
<td>Pemrosesan Gambar</td>
|
||||
</tr>
|
||||
<tr><td><a href="https://requests.readthedocs.io/">permintaan</a></td>
|
||||
<td>Permintaan HTTP</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="https://packaging.python.org/">kemasan</a></td>
|
||||
<td>Penanganan Versi & Paket</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="https://python-markdown.github.io/">penurunan harga</a></td>
|
||||
<td>Render Penurunan Harga</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="https://github.com/Delgan/loguru">logguru</a></td>
|
||||
<td>Pencatatan</td>
|
||||
</tr>
|
||||
<tr class="section"><th colspan="2">Aset & Kontributor</th></tr>
|
||||
<tr>
|
||||
<td><a href="https://pixabay.com/sound-effects/new-notification-09-352705/">Pemberitahuan Baru 09 oleh Universfield</a></td>
|
||||
<td>Suara Notifikasi</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><a href="https://github.com/viru185">virus185</a></td>
|
||||
<td>Kontributor Kode</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
</div>
|
||||
|
||||
</details>
|
||||
|
||||
## ⚠️ Penafian
|
||||
|
||||
Alat ini hanya untuk penggunaan pribadi. Harap hormati persyaratan layanan YouTube dan hak pembuat konten.
|
||||
|
||||
---
|
||||
|
||||
<div align="center">
|
||||
|
||||
Dibuat dengan ❤️ oleh [oop7](https://github.com/oop7)
|
||||
|
||||
</div>
|
||||
Reference in New Issue
Block a user