lumenfetch 2.1.2__tar.gz → 2.2.0__tar.gz

lumenfetch-2.2.0/.github/dependabot.yml

@@ -0,0 +1,14 @@
+version: 2
+updates:
+  - package-ecosystem: pip
+    directory: "/"
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 5
+    groups:
+      minor-and-patch:
+        update-types: ["minor", "patch"]
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: weekly

{lumenfetch-2.1.2 → lumenfetch-2.2.0}/.github/workflows/publish.yml

@@ -1,4 +1,4 @@
-name: Publish
+name: Publish
 
 on:
   release:
@@ -13,10 +13,10 @@ jobs:
     runs-on: windows-latest
     steps:
       - name: Checkout repo
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
 
       - name: Setup Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v7
         with:
           python-version: "3.12"
 
@@ -26,13 +26,13 @@ jobs:
           pip install pyinstaller
 
       - name: Build Windows exe
-        run: pyinstaller --onefile --console --name lumenfetch main.py
+        run: pyinstaller lumenfetch.spec --noconfirm
 
       - name: Smoke test exe
         run: ./dist/lumenfetch.exe --version
 
       - name: Attach exe to release
-        uses: softprops/action-gh-release@v2
+        uses: softprops/action-gh-release@v3
         with:
           files: dist/lumenfetch.exe
 
@@ -44,10 +44,10 @@ jobs:
       id-token: write
     steps:
       - name: Checkout repo
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
 
       - name: Setup Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v7
         with:
           python-version: "3.12"
 

{lumenfetch-2.1.2 → lumenfetch-2.2.0}/.github/workflows/tests.yml

@@ -1,4 +1,4 @@
-name: Tests
+name: Tests
 
 on:
   push:
@@ -8,17 +8,17 @@ on:
 
 jobs:
   test:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     strategy:
       matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12"]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
 
     steps:
       - name: Checkout repo
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
 
       - name: Setup Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v7
         with:
           python-version: ${{ matrix.python-version }}
 

{lumenfetch-2.1.2 → lumenfetch-2.2.0}/.gitignore

@@ -12,3 +12,10 @@ config.json
 dist/
 build/
 *.egg-info/
+
+# local-only dev notes
+.dev/
+SECURITY_MAP.md
+SECURITY_REVIEW.md
+SECURITY_REPORT.md
+rancangan.md

lumenfetch-2.2.0/CHANGELOG.id.md

@@ -0,0 +1,98 @@
+# Changelog
+
+## v2.2.0
+
+Startup lebih cepat dan pipeline rilis lebih ramping.
+
+### Peningkatan
+
+- **Startup lebih cepat.** Dependency berat (yt-dlp, sebagian rich) di-import secara lazy, jadi command seperti `--version` merespons jauh lebih cepat.
+- **Build exe Windows yang lebih kecil dan konsisten.** Build rilis sekarang memakai file spec, menyertakan icon logo, dan mengecualikan toolkit GUI yang tidak dipakai.
+- **CI mencakup Python 3.13 dan 3.14**, dan GitHub Actions diperbarui ke versi major terbaru.
+- **Dependabot menjaga dependency tetap terkini** untuk ekosistem pip dan github-actions.
+- **Bersih-bersih internal.** Logika setup ffmpeg yang duplikat digabungkan, dan update checker tidak lagi memuat yt-dlp saat import.
+
+## v2.1.2
+
+Rilis ini memperbaiki kegagalan download berulang (0 bytes, lalu error) yang terjadi bahkan untuk video publik.
+
+### Fitur baru
+
+- **Cek JavaScript di Doctor.** `lumenfetch --doctor` sekarang juga mengecek JavaScript runtime (Deno/Node), yang dibutuhkan untuk signature challenge YouTube.
+
+### Peningkatan
+
+- **Override `player_client` yang dipaksakan dihapus.** Itu memicu eksperimen SABR-only YouTube (cuma 5 format, bukan sekitar 46). Sekarang pakai default yt-dlp yang dirawat maintainer.
+- **Error format yang transien ikut di-retry.** Error format sekarang mendapat backoff seperti error koneksi.
+- **Crash post-processing tidak lagi menggagalkan video yang sebenarnya utuh.** Crash (mis. embed thumbnail) videonya tetap disimpan dengan warning.
+- **Download paralel judul duplikat dapat nama file unik**, tidak saling merusak.
+
+### Perbaikan bug
+
+- **Hasil 0-byte sekarang gagal dengan jujur + bersih-bersih.** Hasil kosong tidak lagi dilaporkan sebagai sukses atau nyampah di folder.
+- **File batch ber-prefix BOM tidak lagi dilewati diam-diam**, dan kegagalan per-URL di batch sekarang ditampilkan.
+
+## v2.1.1
+
+Rilis ini membuat English menjadi bahasa tampilan default dan me-refresh halaman PyPI.
+
+### Fitur baru
+
+- **`lumenfetch doctor`.** Mendiagnosa setup dalam hitungan detik, tiap cek dengan saran fix spesifik.
+- **Notice self-update.** Memberi tahu kalau ada lumenfetch lebih baru di PyPI.
+- **`--ui-lang en|id`.** Bahasa tampilan via flag, `LUMENFETCH_LANG`, atau setting `ui_lang` yang diingat.
+
+### Breaking changes
+
+- **Bahasa tampilan default sekarang English.** Jalankan `lumenfetch --ui-lang id` sekali untuk kembali ke Indonesia; pilihannya diingat.
+
+## v2.1.0
+
+Rilis ini menambahkan doctor setup, notice self-update, dan dukungan SponsorBlock.
+
+### Fitur baru
+
+- **`lumenfetch doctor`.** Mendiagnosa setup dalam hitungan detik: Python, ffmpeg, `curl_cffi`, versi yt-dlp, versi lumenfetch, keterjangkauan YouTube, keterbacaan cookies browser, dan keterulisan config, masing-masing dengan saran fix spesifik.
+- **Notice self-update.** Memberi tahu kalau ada lumenfetch lebih baru di PyPI (`pip install --upgrade lumenfetch`), di samping notice yt-dlp yang sudah ada.
+- **`--sponsorblock`.** Lewati segmen SponsorBlock, mis. `--sponsorblock sponsor intro outro`.
+- **`--write-info-json`.** Simpan metadata video sebagai `.info.json` di sebelah file.
+- **`.m3u` otomatis.** Playlist audio (`--playlist all`) sekarang juga nulis file `.m3u`.
+
+### Peningkatan
+
+- **Download paralel yang aman.** Dua worker batch untuk judul yang sama tidak lagi saling menimpa file (reservasi nama atomik, terverifikasi live 2/2).
+- **Batch gagal yang bersuara.** Mode batch sekarang menampilkan URL mana yang gagal dan kenapa, bukan gagal diam-diam (termasuk file ber-prefix BOM dari PowerShell).
+- **Terminal yang tenang.** Noise mentah `ERROR:` dari yt-dlp dialihkan ke `lumenfetch.log`; terminal cuma menampilkan pesan ramah.
+- **Modul baru `core/cli.py` dan `core/doctor.py`.** Parsing argumen dan diagnostik dipisah dari `main.py`; `main.py` dirampingkan.
+- **Coverage gate dan trusted publishing.** CI menegakkan coverage gate 80% dan publish ke PyPI tanpa token.
+- **Exe Windows.** `lumenfetch.exe` terlampir di release, tanpa perlu Python.
+
+### Perbaikan bug
+
+- **URL batch ber-prefix BOM tidak lagi dilewati diam-diam.**
+- **Mode batch tidak lagi menelan error per-URL** (ditampilkan bersama URL yang gagal).
+- **Download paralel judul duplikat tidak lagi merusak output satu sama lain.**
+
+## v2.0.0
+
+Lumenfetch sekarang downloader YouTube yang fokus: video MP4 dan audio MP3, tidak yang lain.
+
+### Fitur baru
+
+- **Video MP4.** Quality Best/1080p/720p/480p/360p/Worst dengan thumbnail ter-embed otomatis.
+- **Audio MP3.** Bitrate Best/320kbps/192kbps/128kbps.
+- **CLI English dan Indonesia.** `--ui-lang en|id`; menu, prompt, tabel, pesan error, dan `--help` sepenuhnya bisa diterjemahkan. English menjadi default baru, diingat setelahnya. Juga via `LUMENFETCH_LANG` atau nilai `ui_lang` di config.
+- **Dokumentasi dua bahasa.** `README.md` dan `CONTRIBUTING.md` berbahasa Inggris, dengan versi Indonesia di `README.id.md` dan `CONTRIBUTING.id.md`.
+
+### Breaking changes
+
+- **YouTube-only.** Cuma link `youtube.com`, `youtu.be`, dan `music.youtube.com` yang diterima. Platform lain ditolak dengan pesan yang jelas, bukan error menyesatkan.
+- **Dependency yang dihapus.** `instaloader` dan `browser-cookie3` hilang; install jadi lebih ringan. Cookies browser/file untuk YouTube tetap jalan.
+- **Template nama file output.** Nama file mengikuti `%(platform)s_%(title)s_%(year)s`, mis. `YouTube_Lofi-Hip-Hop-Radio_2026.mp4`.
+
+### Peningkatan
+
+- **Modul baru `core/i18n.py`.** Kamus teks tampilan (en/id); semua teks user lewat `t("key")`.
+- **Taxonomy baru `core/errors.py`.** Setiap kegagalan yt-dlp dipetakan ke kind spesifik (bot-check, cookies, rate-limit, removed, dll) dengan pesan yang actionable, termasuk retry otomatis tanpa cookies kalau database cookies terkunci.
+- **`curl_cffi` sekarang dependency wajib** biar lolos bot-check YouTube.
+- **Config user pindah** ke folder config OS (`%APPDATA%` di Windows, `~/.config` di Linux, `~/Library/Application Support` di macOS), dengan migrasi sekali dari lokasi lama.

lumenfetch-2.2.0/CHANGELOG.md

@@ -0,0 +1,98 @@
+# Changelog
+
+## v2.2.0
+
+Startup is faster and the release pipeline is leaner.
+
+### Improvements
+
+- **Faster startup.** Heavy dependencies (yt-dlp, parts of rich) are imported lazily, so commands like `--version` respond noticeably faster.
+- **Smaller, consistent Windows exe build.** The release build now uses the spec file, ships the logo icon, and excludes unused GUI toolkits.
+- **CI covers Python 3.13 and 3.14**, and GitHub Actions were updated to their latest major versions.
+- **Dependabot keeps dependencies current** in the pip and github-actions ecosystems.
+- **Internal cleanup.** Duplicated ffmpeg setup logic was unified, and the update checker no longer loads yt-dlp at import time.
+
+## v2.1.2
+
+This release fixes repeated download failures (0 bytes, then an error) that happened even for public videos.
+
+### New features
+
+- **Doctor JavaScript check.** `lumenfetch --doctor` now also checks for a JavaScript runtime (Deno/Node), required for YouTube signature challenges.
+
+### Improvements
+
+- **Removed the forced `player_client` override.** It triggered YouTube's SABR-only experiment (5 formats served instead of about 46). yt-dlp's maintained defaults are used now.
+- **Transient format errors retried.** Format errors now get backoff like connection errors.
+- **Post-processing crashes no longer fail an otherwise good download.** A crash (for example thumbnail embed) keeps the video with a warning.
+- **Parallel batch downloads of duplicate titles get unique filenames** instead of corrupting each other.
+
+### Bug fixes
+
+- **0-byte results now fail loudly with cleanup.** Empty results are no longer reported as success or left in the folder.
+- **Batch files with a BOM prefix are no longer skipped silently**, and per-URL batch failures are now reported.
+
+## v2.1.1
+
+This release makes English the default display language and refreshes the PyPI page.
+
+### New features
+
+- **`lumenfetch doctor`.** Diagnoses your setup in seconds, each check with a specific fix hint.
+- **Self-update notice.** Tells you when a newer lumenfetch is on PyPI.
+- **`--ui-lang en|id`.** Display language via flag, `LUMENFETCH_LANG`, or the remembered `ui_lang` setting.
+
+### Breaking changes
+
+- **Default display language is now English.** Run `lumenfetch --ui-lang id` once to keep Bahasa Indonesia; the choice is remembered afterwards.
+
+## v2.1.0
+
+This release adds a setup doctor, a self-update notice, and SponsorBlock support.
+
+### New features
+
+- **`lumenfetch doctor`.** Diagnoses your setup in seconds: Python, ffmpeg, `curl_cffi`, yt-dlp version, lumenfetch version, YouTube reachability, browser-cookie readability, and config writability, each with a specific fix hint.
+- **Self-update notice.** Tells you when a newer lumenfetch is on PyPI (`pip install --upgrade lumenfetch`), next to the existing yt-dlp notice.
+- **`--sponsorblock`.** Skip SponsorBlock segments, e.g. `--sponsorblock sponsor intro outro`.
+- **`--write-info-json`.** Save video metadata as `.info.json` next to the file.
+- **Auto `.m3u`.** Audio playlists (`--playlist all`) now also write an `.m3u` file.
+
+### Improvements
+
+- **Parallel-safe downloads.** Two batch workers for the same title no longer overwrite each other's file (atomic name reservation, verified live 2/2).
+- **Loud batch failures.** Batch mode now prints which URL failed and why instead of failing silently (also handles BOM-prefixed files from PowerShell).
+- **Quiet terminal.** Raw yt-dlp `ERROR:` noise is redirected to `lumenfetch.log`; the terminal only shows friendly messages.
+- **New `core/cli.py` and `core/doctor.py` modules.** Argument parsing and diagnostics were split out of `main.py`; `main.py` is slimmed down.
+- **Coverage gate and trusted publishing.** CI enforces an 80% coverage gate and publishes to PyPI without a token.
+- **Windows exe.** `lumenfetch.exe` is attached to the release, no Python needed.
+
+### Bug fixes
+
+- **Batch URLs with a BOM prefix are no longer silently skipped.**
+- **Batch mode no longer swallows per-URL errors** (they are printed with the failing URL).
+- **Parallel downloads of duplicate titles no longer corrupt each other's output.**
+
+## v2.0.0
+
+Lumenfetch is now a focused YouTube downloader: MP4 video and MP3 audio, nothing else.
+
+### New features
+
+- **MP4 video.** Quality Best/1080p/720p/480p/360p/Worst with auto-embedded thumbnail.
+- **MP3 audio.** Bitrate Best/320kbps/192kbps/128kbps.
+- **English and Indonesian CLI.** `--ui-lang en|id`; menus, prompts, tables, error messages, and `--help` are fully translatable. English is the default, remembered afterwards. Also via `LUMENFETCH_LANG` or the `ui_lang` config value.
+- **Bilingual documentation.** `README.md` and `CONTRIBUTING.md` in English, with Indonesian versions in `README.id.md` and `CONTRIBUTING.id.md`.
+
+### Breaking changes
+
+- **YouTube-only.** Only `youtube.com`, `youtu.be`, and `music.youtube.com` links are accepted. Other platforms are rejected with a clear message instead of a misleading error.
+- **Removed dependencies.** `instaloader` and `browser-cookie3` are gone; install is lighter. Browser/file cookies for YouTube still work.
+- **Output filename template.** Filenames follow `%(platform)s_%(title)s_%(year)s`, e.g. `YouTube_Lofi-Hip-Hop-Radio_2026.mp4`.
+
+### Improvements
+
+- **New `core/i18n.py` module.** A pure dictionary of display text (en/id); all user-facing text goes through `t("key")`.
+- **New `core/errors.py` taxonomy.** Every yt-dlp failure maps to a specific kind (bot-check, cookies, rate-limit, removed, etc.) with an actionable message, including automatic retry without cookies when the cookie database is locked.
+- **`curl_cffi` is now a required dependency** so YouTube bot-checks pass.
+- **User config moved** to the OS config dir (`%APPDATA%` on Windows, `~/.config` on Linux, `~/Library/Application Support` on macOS), with one-time migration from the old location.

{lumenfetch-2.1.2 → lumenfetch-2.2.0}/CONTRIBUTING.id.md

@@ -1,40 +1,40 @@
 # Kontribusi ke Lumenfetch
 
-Makasih udah mau bantu kembangin Lumenfetch. Panduan ini biar kontribusi kamu gampang diproses.
+Makasih sudah mau bantu kembangin Lumenfetch. Panduan ini biar kontribusi kamu gampang diproses.
 
 [English](CONTRIBUTING.md) | **Bahasa Indonesia**
 
-## 🛠 Setup Development
+## Setup Development
 
-1. Fork & clone repo ini
-2. Install dependency (termasuk tools testing & lint):
+1. Fork dan clone repo ini
+2. Install dependency (termasuk tools testing dan lint):
    ```bash
    pip install -r requirements-dev.txt
    ```
 3. Pastikan `ffmpeg` sudah terinstall di sistem kamu (lihat bagian Requirements di README)
 
-## 🗂 Struktur & Prinsip Modul
+## Struktur dan Prinsip Modul
 
-Lumenfetch sengaja dipisah per tanggung jawab, tolong dijaga konsistensinya kalau nambah/ubah kode:
+Lumenfetch sengaja dipisah per tanggung jawab. Tolong jaga konsistensinya kalau menambah/mengubah kode:
 
 | File | Tanggung jawab | Tidak boleh |
-|------|-----------------|-------------|
+|------|----------------|-------------|
 | `core/constants.py` | Nilai shared (versi, format, batas) | Logic bisnis |
-| `core/errors.py` | Klasifikasi error + pesan ramah terpusat | Logic download/deteksi |
+| `core/errors.py` | Klasifikasi error dan pesan ramah terpusat | Logic download/deteksi |
 | `core/i18n.py` | Katalog string UI (EN default, ID opsional) | Logic bisnis |
-| `core/cli.py` | Parsing argumen + bangun pilihan non-interaktif | Logic bisnis |
+| `core/cli.py` | Parsing argumen dan bangun pilihan non-interaktif | Logic bisnis |
 | `core/doctor.py` | Diagnosa setup (ffmpeg, dep, cookies, jaringan) | Download/deteksi |
 | `core/ffmpeg.py` | Deteksi ffmpeg sistem dulu, bundled fallback | Download/deteksi |
 | `core/log.py` | Logging file terpusat | Tampilan rich/menu |
 | `core/detector.py` | Deteksi info video YouTube via yt-dlp | Mendownload apa pun |
 | `core/downloader.py` | Proses download, progress hook, retry | Menampilkan menu/prompt |
-| `core/options.py` | Semua interaksi & tampilan menu (rich) | Logic download |
+| `core/options.py` | Semua interaksi dan tampilan menu (rich) | Logic download |
 | `core/utils.py` | Helper murni: sanitasi, format, config user | Bergantung ke CLI atau jaringan |
-| `main.py` | Menyatukan semua modul lewat CLI + loop utama | Logic bisnis baru |
+| `main.py` | Menyatukan semua modul lewat CLI dan loop utama | Logic bisnis baru |
 
-Kalau nambah fitur, coba taruh di modul yang paling sesuai dulu sebelum bikin file baru.
+Kalau menambah fitur, taruh di modul yang paling sesuai dulu sebelum bikin file baru.
 
-## ✅ Sebelum Bikin Pull Request
+## Sebelum Bikin Pull Request
 
 Jalankan ini dulu di root project:
 
@@ -43,30 +43,31 @@ pytest tests/ -v
 ruff check .
 ```
 
-Pastikan semua test lulus dan tidak ada warning lint baru. GitHub Actions juga bakal jalanin ini otomatis di setiap PR.
+Pastikan semua test lulus dan tidak ada warning lint baru. GitHub Actions juga menjalankan ini otomatis di setiap PR.
 
-## 📝 Commit Message
+## Commit Message
 
 Pakai prefix singkat biar history gampang dibaca:
 
-- `feat:` — fitur baru
-- `fix:` — perbaikan bug
-- `docs:` — perubahan dokumentasi (README, CONTRIBUTING, dll)
-- `refactor:` — perubahan struktur kode tanpa mengubah perilaku
-- `test:` — nambah/ubah test
+- `feat:` fitur baru
+- `fix:` perbaikan bug
+- `docs:` perubahan dokumentasi (README, CONTRIBUTING, dll)
+- `refactor:` perubahan struktur kode tanpa mengubah perilaku
+- `test:` nambah/ubah test
 
 Contoh: `fix: handle playlist YouTube satu video`
 
-## 🐛 Lapor Bug / Request Fitur
+## Lapor Bug / Request Fitur
 
 Buka [Issues](../../issues) baru, sertakan:
+
 - Link yang bermasalah (kalau ada, hapus info pribadi)
 - Pesan error yang muncul di terminal
 - Langkah buat reproduce masalahnya
 
-## 🤝 Pull Request
+## Pull Request
 
 1. Buat branch baru dari `main`, kasih nama yang jelas (misal `fix/playlist-satu-video`)
 2. Pastikan `pytest` dan `ruff check .` lulus
-3. Jelasin di deskripsi PR apa yang diubah dan kenapa
-4. Tunggu review — mungkin ada request perubahan kecil sebelum di-merge
+3. Jelaskan di deskripsi PR apa yang diubah dan kenapa
+4. Tunggu review, mungkin ada request perubahan kecil sebelum di-merge

{lumenfetch-2.1.2 → lumenfetch-2.2.0}/CONTRIBUTING.md

@@ -2,41 +2,39 @@
 
 Thanks for helping develop Lumenfetch. This guide keeps contributions easy to review.
 
-**Bahasa Indonesia** | [English](CONTRIBUTING.md)
+**English** | [Bahasa Indonesia](CONTRIBUTING.id.md)
 
-> Indonesian version: [`CONTRIBUTING.id.md`](CONTRIBUTING.id.md)
+## Development Setup
 
-## 🛠 Development Setup
-
-1. Fork & clone this repo
-2. Install dependencies (including testing & lint tools):
+1. Fork and clone this repo
+2. Install dependencies (including testing and lint tools):
    ```bash
    pip install -r requirements-dev.txt
    ```
 3. Make sure `ffmpeg` is installed on your system (see Requirements in the README)
 
-## 🗂 Module Structure & Principles
+## Module Structure and Principles
 
-Lumenfetch is split by responsibility - please keep it consistent when adding/changing code:
+Lumenfetch is split by responsibility. Keep it consistent when adding or changing code:
 
 | File | Responsibility | Must not |
 |------|----------------|----------|
 | `core/constants.py` | Shared values (version, formats, limits) | Business logic |
-| `core/errors.py` | Central error classification + friendly messages | Download/detect logic |
+| `core/errors.py` | Central error classification and friendly messages | Download/detect logic |
 | `core/i18n.py` | UI string catalog (EN default, ID optional) | Business logic |
-| `core/cli.py` | Argument parsing + non-interactive choice building | Business logic |
+| `core/cli.py` | Argument parsing and non-interactive choice building | Business logic |
 | `core/doctor.py` | Setup diagnosis (ffmpeg, deps, cookies, network) | Download/detect |
 | `core/ffmpeg.py` | System ffmpeg first, bundled fallback | Download/detect |
 | `core/log.py` | Central file logging | Rich display/menus |
 | `core/detector.py` | YouTube video info detection via yt-dlp | Download anything |
 | `core/downloader.py` | Download process, progress hook, retry | Show menus/prompts |
-| `core/options.py` | All interaction & menus (rich) | Download logic |
+| `core/options.py` | All interaction and menus (rich) | Download logic |
 | `core/utils.py` | Pure helpers: sanitizing, formatting, user config | Depend on CLI or network |
-| `main.py` | Ties everything together via CLI + main loop | New business logic |
+| `main.py` | Ties everything together via CLI and main loop | New business logic |
 
 When adding a feature, put it in the most fitting module first before creating a new file.
 
-## ✅ Before Opening a Pull Request
+## Before Opening a Pull Request
 
 Run this in the project root:
 
@@ -47,28 +45,29 @@ ruff check .
 
 Make sure all tests pass and there are no new lint warnings. GitHub Actions also runs these automatically on every PR.
 
-## 📝 Commit Messages
+## Commit Messages
 
 Use short prefixes so history stays readable:
 
-- `feat:` — new feature
-- `fix:` — bug fix
-- `docs:` — documentation changes (README, CONTRIBUTING, etc.)
-- `refactor:` — code structure changes without behavior change
-- `test:` — add/change tests
+- `feat:` new feature
+- `fix:` bug fix
+- `docs:` documentation changes (README, CONTRIBUTING, etc.)
+- `refactor:` code structure changes without behavior change
+- `test:` add/change tests
 
 Example: `fix: handle single-video YouTube playlist`
 
-## 🐛 Bug Reports / Feature Requests
+## Bug Reports / Feature Requests
 
 Open a new [Issue](../../issues) and include:
+
 - The problematic link (if any, remove personal info)
 - The error message shown in the terminal
 - Steps to reproduce the problem
 
-## 🤝 Pull Requests
+## Pull Requests
 
 1. Create a new branch from `main` with a clear name (e.g. `fix/playlist-single-video`)
 2. Make sure `pytest` and `ruff check .` pass
 3. Explain in the PR description what changed and why
-4. Wait for review - there may be small change requests before merging
+4. Wait for review, there may be small change requests before merging