melody-mp3 1.0.0__tar.gz

melody_mp3-1.0.0/.github/workflows/publish.yml

@@ -0,0 +1,27 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write   # OIDC — tidak perlu API token
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build package
+        run: |
+          pip install build --quiet
+          python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

melody_mp3-1.0.0/.gitignore

@@ -0,0 +1,28 @@
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+build/
+dist/
+*.egg-info/
+.eggs/
+.env
+.venv
+venv/
+env/
+*.egg
+.pytest_cache/
+.ruff_cache/
+htmlcov/
+.coverage
+*.mp3
+*.webm
+*.m4a
+*.wav
+*.flac
+*.opus
+test_out/
+test_mp3/
+*.txt
+!requirements*.txt

melody_mp3-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 aryansyach
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

melody_mp3-1.0.0/PKG-INFO

@@ -0,0 +1,195 @@
+Metadata-Version: 2.4
+Name: melody-mp3
+Version: 1.0.0
+Summary: Fast YouTube to MP3 downloader — CLI tool for music lovers
+Project-URL: Repository, https://github.com/0xAre/melody-cli
+Project-URL: Issues, https://github.com/0xAre/melody-cli/issues
+Author-email: aryansyach <aryansyach4@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: audio,cli,downloader,mp3,music,youtube
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Sound/Audio
+Requires-Python: >=3.10
+Requires-Dist: platformdirs>=4.0
+Requires-Dist: questionary>=2.0
+Requires-Dist: rich>=13.7
+Requires-Dist: tomli-w>=1.0
+Requires-Dist: typer[all]>=0.12
+Requires-Dist: yt-dlp>=2024.1
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# 🎵 Melody CLI
+
+> Fast, elegant YouTube → MP3 downloader for the terminal.
+> Navigasi dengan arrow keys — tidak perlu hafal command apapun.
+
+[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://python.org)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
+```
+╭────────────────────────────────────────────╮
+│  melody  v1.0.0                            │
+│  YouTube → MP3  •  Cari, Download, Konversi│
+╰────────────────────────────────────────────╯
+
+? Apa yang ingin kamu lakukan?
+❯   Download lagu / playlist dari YouTube
+    Download dari file daftar URL  (.txt)
+    Cari lagu di YouTube
+    Konversi file audio lokal ke MP3
+  ──────────────
+    Riwayat download
+    Pengaturan
+    Keluar
+```
+
+---
+
+## Install
+
+### Windows (satu command)
+
+Buka **PowerShell**, paste ini, tekan Enter:
+
+```powershell
+irm https://raw.githubusercontent.com/0xAre/melody-cli/master/install.ps1 | iex
+```
+
+Script akan otomatis:
+- cek Python & FFmpeg
+- install `pipx` jika belum ada
+- install `melody` dan daftarkan ke PATH
+
+### Linux / macOS
+
+```bash
+curl -sSL https://raw.githubusercontent.com/0xAre/melody-cli/master/install.sh | bash
+```
+
+### Via PyPI
+
+```bash
+pip install melody-mp3
+```
+
+### Manual dari GitHub
+
+```bash
+pip install git+https://github.com/0xAre/melody-cli.git
+```
+
+---
+
+## Persyaratan
+
+| | |
+|---|---|
+| **Python** | 3.10 atau lebih baru |
+| **FFmpeg** | wajib ada di PATH untuk konversi MP3 |
+
+**Install FFmpeg:**
+
+```bash
+# Windows
+winget install -e --id Gyan.FFmpeg
+
+# macOS
+brew install ffmpeg
+
+# Ubuntu / Debian
+sudo apt install ffmpeg
+```
+
+---
+
+## Penggunaan
+
+### Mode interaktif (direkomendasikan)
+
+```bash
+melody
+```
+
+Jalankan saja `melody`, navigasi dengan ↑↓ arrow keys. Tidak perlu hafal flag apapun.
+
+**Alur queue** — kumpulkan dulu, download sekaligus:
+```
+Cari → pilih → Tambah ke antrian
+Cari → pilih → Tambah ke antrian
+...
+Download antrian  (proses semua sekaligus)
+```
+
+### Mode CLI (untuk scripting)
+
+```bash
+# Download lagu / playlist
+melody get "https://youtu.be/..."
+melody get "https://youtube.com/playlist?list=..." -o ~/Music -q 320
+
+# Cari dan download
+melody search query "bohemian rhapsody"
+
+# Konversi file lokal
+melody convert file ./dump -o ./musik
+
+# Riwayat
+melody history show
+
+# Konfigurasi
+melody config show
+melody config show --set quality=320
+melody config show --set output_dir=D:/Musik
+```
+
+---
+
+## Konfigurasi
+
+Tersimpan otomatis di `%APPDATA%\melody\config.toml` (Windows) atau `~/.config/melody/config.toml`.
+
+| Key | Default | Keterangan |
+|---|---|---|
+| `output_dir` | `~/Music` | Folder default download |
+| `quality` | `192` | Bitrate MP3: 128 / 192 / 256 / 320 kbps |
+| `skip_history` | `true` | Skip otomatis jika sudah pernah didownload |
+| `sample_rate` | `44100` | Hz — kompatibel dengan portable music player |
+
+---
+
+## Kompatibilitas Music Player
+
+Melody menghasilkan MP3 yang kompatibel dengan hampir semua portable music player (music box, Acome, dll):
+
+- Sample rate **44100 Hz**
+- Codec **libmp3lame**
+- **Stereo** (2 channel)
+- ID3 metadata tertanam
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/0xAre/melody-cli
+cd melody-cli
+pip install -e ".[dev]"
+pytest tests/ -v
+```
+
+---
+
+## License
+
+[MIT](LICENSE) © 2025 [0xAre](https://github.com/0xAre)

melody_mp3-1.0.0/README.md

@@ -0,0 +1,164 @@
+# 🎵 Melody CLI
+
+> Fast, elegant YouTube → MP3 downloader for the terminal.
+> Navigasi dengan arrow keys — tidak perlu hafal command apapun.
+
+[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://python.org)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
+```
+╭────────────────────────────────────────────╮
+│  melody  v1.0.0                            │
+│  YouTube → MP3  •  Cari, Download, Konversi│
+╰────────────────────────────────────────────╯
+
+? Apa yang ingin kamu lakukan?
+❯   Download lagu / playlist dari YouTube
+    Download dari file daftar URL  (.txt)
+    Cari lagu di YouTube
+    Konversi file audio lokal ke MP3
+  ──────────────
+    Riwayat download
+    Pengaturan
+    Keluar
+```
+
+---
+
+## Install
+
+### Windows (satu command)
+
+Buka **PowerShell**, paste ini, tekan Enter:
+
+```powershell
+irm https://raw.githubusercontent.com/0xAre/melody-cli/master/install.ps1 | iex
+```
+
+Script akan otomatis:
+- cek Python & FFmpeg
+- install `pipx` jika belum ada
+- install `melody` dan daftarkan ke PATH
+
+### Linux / macOS
+
+```bash
+curl -sSL https://raw.githubusercontent.com/0xAre/melody-cli/master/install.sh | bash
+```
+
+### Via PyPI
+
+```bash
+pip install melody-mp3
+```
+
+### Manual dari GitHub
+
+```bash
+pip install git+https://github.com/0xAre/melody-cli.git
+```
+
+---
+
+## Persyaratan
+
+| | |
+|---|---|
+| **Python** | 3.10 atau lebih baru |
+| **FFmpeg** | wajib ada di PATH untuk konversi MP3 |
+
+**Install FFmpeg:**
+
+```bash
+# Windows
+winget install -e --id Gyan.FFmpeg
+
+# macOS
+brew install ffmpeg
+
+# Ubuntu / Debian
+sudo apt install ffmpeg
+```
+
+---
+
+## Penggunaan
+
+### Mode interaktif (direkomendasikan)
+
+```bash
+melody
+```
+
+Jalankan saja `melody`, navigasi dengan ↑↓ arrow keys. Tidak perlu hafal flag apapun.
+
+**Alur queue** — kumpulkan dulu, download sekaligus:
+```
+Cari → pilih → Tambah ke antrian
+Cari → pilih → Tambah ke antrian
+...
+Download antrian  (proses semua sekaligus)
+```
+
+### Mode CLI (untuk scripting)
+
+```bash
+# Download lagu / playlist
+melody get "https://youtu.be/..."
+melody get "https://youtube.com/playlist?list=..." -o ~/Music -q 320
+
+# Cari dan download
+melody search query "bohemian rhapsody"
+
+# Konversi file lokal
+melody convert file ./dump -o ./musik
+
+# Riwayat
+melody history show
+
+# Konfigurasi
+melody config show
+melody config show --set quality=320
+melody config show --set output_dir=D:/Musik
+```
+
+---
+
+## Konfigurasi
+
+Tersimpan otomatis di `%APPDATA%\melody\config.toml` (Windows) atau `~/.config/melody/config.toml`.
+
+| Key | Default | Keterangan |
+|---|---|---|
+| `output_dir` | `~/Music` | Folder default download |
+| `quality` | `192` | Bitrate MP3: 128 / 192 / 256 / 320 kbps |
+| `skip_history` | `true` | Skip otomatis jika sudah pernah didownload |
+| `sample_rate` | `44100` | Hz — kompatibel dengan portable music player |
+
+---
+
+## Kompatibilitas Music Player
+
+Melody menghasilkan MP3 yang kompatibel dengan hampir semua portable music player (music box, Acome, dll):
+
+- Sample rate **44100 Hz**
+- Codec **libmp3lame**
+- **Stereo** (2 channel)
+- ID3 metadata tertanam
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/0xAre/melody-cli
+cd melody-cli
+pip install -e ".[dev]"
+pytest tests/ -v
+```
+
+---
+
+## License
+
+[MIT](LICENSE) © 2025 [0xAre](https://github.com/0xAre)

melody_mp3-1.0.0/install.ps1

@@ -0,0 +1,67 @@
+# Melody CLI — Windows Installer
+# Usage: irm https://raw.githubusercontent.com/0xAre/melody-cli/master/install.ps1 | iex
+
+$ErrorActionPreference = "Stop"
+
+Write-Host ""
+Write-Host "  melody-cli installer" -ForegroundColor Cyan
+Write-Host "  ─────────────────────────────────────" -ForegroundColor DarkGray
+Write-Host ""
+
+# ── 1. Cek Python ────────────────────────────────────────────────
+if (-not (Get-Command python -ErrorAction SilentlyContinue)) {
+    Write-Host "  [!] Python tidak ditemukan." -ForegroundColor Red
+    Write-Host "      Install dari: https://python.org/downloads" -ForegroundColor Yellow
+    Write-Host "      Centang 'Add Python to PATH' saat install." -ForegroundColor Yellow
+    exit 1
+}
+
+$pyVer = python -c "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}')"
+$pyMinor = [int](python -c "import sys; print(sys.version_info.minor)")
+$pyMajor = [int](python -c "import sys; print(sys.version_info.major)")
+
+if ($pyMajor -lt 3 -or ($pyMajor -eq 3 -and $pyMinor -lt 10)) {
+    Write-Host "  [!] Python 3.10+ dibutuhkan (kamu punya $pyVer)" -ForegroundColor Red
+    exit 1
+}
+Write-Host "  [ok] Python $pyVer" -ForegroundColor Green
+
+# ── 2. Cek FFmpeg ─────────────────────────────────────────────────
+if (Get-Command ffmpeg -ErrorAction SilentlyContinue) {
+    Write-Host "  [ok] FFmpeg sudah ada" -ForegroundColor Green
+} else {
+    Write-Host ""
+    Write-Host "  [!] FFmpeg belum ada — dibutuhkan untuk konversi MP3." -ForegroundColor Yellow
+    Write-Host "      Install dengan salah satu cara:" -ForegroundColor Yellow
+    Write-Host "        winget install -e --id Gyan.FFmpeg" -ForegroundColor Cyan
+    Write-Host "        choco install ffmpeg" -ForegroundColor Cyan
+    Write-Host ""
+    $cont = Read-Host "  Lanjut install melody tanpa FFmpeg dulu? (y/n)"
+    if ($cont -ne "y") { exit 0 }
+}
+
+# ── 3. Install pipx jika belum ada ───────────────────────────────
+if (-not (Get-Command pipx -ErrorAction SilentlyContinue)) {
+    Write-Host "  Installing pipx..." -ForegroundColor Cyan
+    pip install pipx --quiet
+    python -m pipx ensurepath | Out-Null
+    # Reload PATH sesi ini
+    $userPath = [System.Environment]::GetEnvironmentVariable("PATH", "User")
+    $machinePath = [System.Environment]::GetEnvironmentVariable("PATH", "Machine")
+    $env:PATH = "$userPath;$machinePath"
+}
+Write-Host "  [ok] pipx" -ForegroundColor Green
+
+# ── 4. Install melody ─────────────────────────────────────────────
+Write-Host "  Installing melody-cli..." -ForegroundColor Cyan
+pipx install git+https://github.com/0xAre/melody-cli.git --force
+# Catatan: package PyPI tersedia sebagai: pip install melody-mp3
+
+Write-Host ""
+Write-Host "  ─────────────────────────────────────" -ForegroundColor DarkGray
+Write-Host "  Selesai! Jalankan: melody" -ForegroundColor Cyan
+Write-Host ""
+Write-Host "  Jika command 'melody' tidak ditemukan," -ForegroundColor DarkGray
+Write-Host "  restart terminal atau jalankan:" -ForegroundColor DarkGray
+Write-Host "  python -m pipx ensurepath" -ForegroundColor DarkGray
+Write-Host ""

melody_mp3-1.0.0/install.sh

@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+# Melody CLI — Linux/macOS Installer
+# Usage: curl -sSL https://raw.githubusercontent.com/0xAre/melody-cli/master/install.sh | bash
+
+set -e
+
+GREEN='\033[0;32m' CYAN='\033[0;36m' YELLOW='\033[1;33m' RED='\033[0;31m' NC='\033[0m'
+
+echo ""
+echo -e "  ${CYAN}melody-cli installer${NC}"
+echo "  ─────────────────────────────────────"
+echo ""
+
+# ── 1. Cek Python ────────────────────────────────────────────────
+if ! command -v python3 &>/dev/null; then
+    echo -e "  ${RED}[!] Python 3 tidak ditemukan.${NC}"
+    echo "      macOS: brew install python"
+    echo "      Ubuntu: sudo apt install python3 python3-pip"
+    exit 1
+fi
+
+PY_VER=$(python3 -c "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}')")
+PY_MINOR=$(python3 -c "import sys; print(sys.version_info.minor)")
+PY_MAJOR=$(python3 -c "import sys; print(sys.version_info.major)")
+
+if [ "$PY_MAJOR" -lt 3 ] || { [ "$PY_MAJOR" -eq 3 ] && [ "$PY_MINOR" -lt 10 ]; }; then
+    echo -e "  ${RED}[!] Python 3.10+ dibutuhkan (kamu punya $PY_VER)${NC}"
+    exit 1
+fi
+echo -e "  ${GREEN}[ok] Python $PY_VER${NC}"
+
+# ── 2. Cek FFmpeg ─────────────────────────────────────────────────
+if command -v ffmpeg &>/dev/null; then
+    echo -e "  ${GREEN}[ok] FFmpeg sudah ada${NC}"
+else
+    echo -e "  ${YELLOW}[!] FFmpeg belum ada.${NC}"
+    echo "      macOS:  brew install ffmpeg"
+    echo "      Ubuntu: sudo apt install ffmpeg"
+    echo ""
+fi
+
+# ── 3. Install pipx jika belum ada ───────────────────────────────
+if ! command -v pipx &>/dev/null; then
+    echo -e "  ${CYAN}Installing pipx...${NC}"
+    python3 -m pip install --user pipx --quiet
+    python3 -m pipx ensurepath
+fi
+echo -e "  ${GREEN}[ok] pipx${NC}"
+
+# ── 4. Install melody ─────────────────────────────────────────────
+echo -e "  ${CYAN}Installing melody-cli...${NC}"
+pipx install git+https://github.com/0xAre/melody-cli.git --force
+
+echo ""
+echo "  ─────────────────────────────────────"
+echo -e "  ${GREEN}Selesai! Jalankan: melody${NC}"
+echo ""
+echo "  Jika 'melody' tidak ditemukan, jalankan:"
+echo "  python3 -m pipx ensurepath"
+echo "  lalu restart terminal."
+echo ""

melody_mp3-1.0.0/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "melody-mp3"
+version = "1.0.0"
+description = "Fast YouTube to MP3 downloader — CLI tool for music lovers"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "aryansyach", email = "aryansyach4@gmail.com" }]
+keywords = ["youtube", "mp3", "downloader", "cli", "music", "audio"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Multimedia :: Sound/Audio",
+]
+dependencies = [
+    "typer[all]>=0.12",
+    "rich>=13.7",
+    "yt-dlp>=2024.1",
+    "platformdirs>=4.0",
+    "tomli-w>=1.0",
+    "questionary>=2.0",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0", "ruff>=0.4"]
+
+[project.scripts]
+melody = "melody.cli.app:main"
+
+[project.urls]
+Repository = "https://github.com/0xAre/melody-cli"
+Issues = "https://github.com/0xAre/melody-cli/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/melody"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"

melody_mp3-1.0.0/src/melody/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.0.0"

melody_mp3-1.0.0/src/melody/__main__.py

@@ -0,0 +1,4 @@
+from melody.cli.app import main
+
+if __name__ == "__main__":
+    main()