musicmandu 1.0.0__tar.gz

musicmandu-1.0.0/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.4
+Name: musicmandu
+Version: 1.0.0
+Summary: A production-grade YouTube music downloader CLI
+Author: Milan Prajapati
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: yt-dlp>=2023.0.0
+Requires-Dist: ffmpeg-downloader>=0.1.0
+
+# 🎵 musicmandu
+
+`musicmandu` is a production-grade, zero-configuration command-line interface (CLI) tool written in Python. It allows users to seamlessly download high-quality audio from YouTube videos and automatically process them into fully tagged, album-art-embedded MP3 files.
+
+---
+
+## ✨ Features
+
+- **Zero Manual Dependencies:** Automatically detects, downloads, and caches the correct system-specific FFmpeg binaries at runtime—even when Windows user paths contain spaces.
+- **High-Quality Audio:** Downloads the best available audio stream and converts it into a clean 192 kbps MP3 file.
+- **Rich Metadata Integration:** Automatically extracts and embeds metadata such as the title and creator, then downloads and embeds the video's high-resolution thumbnail as album art.
+- **Sleek Visual Feedback:** Uses `Rich` console components to replace noisy console output with clean status spinners and styled messages.
+
+---
+
+## 🚀 Installation & Prerequisites
+
+`musicmandu` runs on **Windows, macOS, and Linux**.
+
+### 1. Requirements
+
+- Python 3.8 or later
+
+### 2. Set Up the Project
+
+Clone or navigate to the project directory, then install the required Python packages:
+
+```bash
+pip install typer rich yt-dlp ffmpeg-downloader
+```
+
+---
+
+## 🛠 Usage & Commands
+
+Run the CLI using standard Python execution syntax:
+
+```bash
+python main.py [COMMAND] [ARGUMENTS] [FLAGS]
+```
+
+### 1. Greet Users (`greet`)
+
+Test the CLI setup or display a custom greeting.
+
+```bash
+# Standard greeting
+python main.py greet Milan
+
+# Formal greeting
+python main.py greet "Mr. Wayne" --formal
+```
+
+### 2. Download Tracks (`download`)
+
+Download audio and save a formatted MP3 file in the current working directory.
+
+```bash
+python main.py download "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
+```
+
+### 3. View Built-in Help
+
+Display automatically generated command descriptions, arguments, and flags.
+
+```bash
+python main.py --help
+python main.py download --help
+```
+
+---
+
+## ⚙️ Architecture & Under the Hood
+
+The application relies on three core frameworks to provide a seamless user experience:
+
+- **Typer:** Powers command parsing, argument handling, flags, and dynamically generated help screens.
+- **Rich:** Manages styled terminal output, layout, and responsive loading indicators.
+- **yt-dlp and ffmpeg-downloader:** Handle the download and processing pipeline, including metadata extraction, high-bitrate audio retrieval, thumbnail downloading, and FFmpeg-based MP3 conversion.
+
+### Runtime Dependency Sandbox
+
+When the `download` command is invoked, the application runs a gatekeeper function named `ensure_ffmpeg_installed`.
+
+If a valid FFmpeg installation cannot be found in the system path, the application downloads and caches a platform-specific FFmpeg binary. It then maps the binary into the current process environment without modifying the user's global system configuration.
+
+---
+
+## 📝 License
+
+Distributed under the MIT License. See `LICENSE` for more information.
+
+---
+
+## 💡 Project Idea
+
+A useful next feature would be a download history log that records previously downloaded songs.

musicmandu-1.0.0/README.md

@@ -0,0 +1,97 @@
+# 🎵 musicmandu
+
+`musicmandu` is a production-grade, zero-configuration command-line interface (CLI) tool written in Python. It allows users to seamlessly download high-quality audio from YouTube videos and automatically process them into fully tagged, album-art-embedded MP3 files.
+
+---
+
+## ✨ Features
+
+- **Zero Manual Dependencies:** Automatically detects, downloads, and caches the correct system-specific FFmpeg binaries at runtime—even when Windows user paths contain spaces.
+- **High-Quality Audio:** Downloads the best available audio stream and converts it into a clean 192 kbps MP3 file.
+- **Rich Metadata Integration:** Automatically extracts and embeds metadata such as the title and creator, then downloads and embeds the video's high-resolution thumbnail as album art.
+- **Sleek Visual Feedback:** Uses `Rich` console components to replace noisy console output with clean status spinners and styled messages.
+
+---
+
+## 🚀 Installation & Prerequisites
+
+`musicmandu` runs on **Windows, macOS, and Linux**.
+
+### 1. Requirements
+
+- Python 3.8 or later
+
+### 2. Set Up the Project
+
+Clone or navigate to the project directory, then install the required Python packages:
+
+```bash
+pip install typer rich yt-dlp ffmpeg-downloader
+```
+
+---
+
+## 🛠 Usage & Commands
+
+Run the CLI using standard Python execution syntax:
+
+```bash
+python main.py [COMMAND] [ARGUMENTS] [FLAGS]
+```
+
+### 1. Greet Users (`greet`)
+
+Test the CLI setup or display a custom greeting.
+
+```bash
+# Standard greeting
+python main.py greet Milan
+
+# Formal greeting
+python main.py greet "Mr. Wayne" --formal
+```
+
+### 2. Download Tracks (`download`)
+
+Download audio and save a formatted MP3 file in the current working directory.
+
+```bash
+python main.py download "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
+```
+
+### 3. View Built-in Help
+
+Display automatically generated command descriptions, arguments, and flags.
+
+```bash
+python main.py --help
+python main.py download --help
+```
+
+---
+
+## ⚙️ Architecture & Under the Hood
+
+The application relies on three core frameworks to provide a seamless user experience:
+
+- **Typer:** Powers command parsing, argument handling, flags, and dynamically generated help screens.
+- **Rich:** Manages styled terminal output, layout, and responsive loading indicators.
+- **yt-dlp and ffmpeg-downloader:** Handle the download and processing pipeline, including metadata extraction, high-bitrate audio retrieval, thumbnail downloading, and FFmpeg-based MP3 conversion.
+
+### Runtime Dependency Sandbox
+
+When the `download` command is invoked, the application runs a gatekeeper function named `ensure_ffmpeg_installed`.
+
+If a valid FFmpeg installation cannot be found in the system path, the application downloads and caches a platform-specific FFmpeg binary. It then maps the binary into the current process environment without modifying the user's global system configuration.
+
+---
+
+## 📝 License
+
+Distributed under the MIT License. See `LICENSE` for more information.
+
+---
+
+## 💡 Project Idea
+
+A useful next feature would be a download history log that records previously downloaded songs.

musicmandu-1.0.0/pyproject.toml

@@ -0,0 +1,19 @@
+[project]
+name = "musicmandu"
+version = "1.0.0"
+description = "A production-grade YouTube music downloader CLI"
+readme = "README.md"
+authors = [
+    { name = "Milan Prajapati" }
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "typer>=0.9.0",
+    "rich>=13.0.0",
+    "yt-dlp>=2023.0.0",
+    "ffmpeg-downloader>=0.1.0"
+]

musicmandu-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

musicmandu-1.0.0/src/musicmandu/main.py

@@ -0,0 +1,105 @@
+import sys
+
+import typer
+from rich.console import Console
+from rich.progress import BarColumn, Progress, SpinnerColumn, TextColumn, DownloadColumn, TransferSpeedColumn
+import os
+import ffmpeg_downloader as ffdl
+import yt_dlp
+
+
+# initialize the typer app and rich console
+app= typer.Typer(name="musicmandu",help="Youtube Music Downloader CLI")
+console=Console()
+
+
+def ensure_ffmpeg_installed():
+    """
+    Checks if FFmpeg is installed via ffmpeg-downloader.
+    If missing, automatically downloads it cleanly even with spaces in the Windows user path.
+    """
+    # 1. Check if the directory attribute exists or if the path is missing
+    if not hasattr(ffdl, "ffmpeg_dir") or not ffdl.ffmpeg_dir or not os.path.exists(ffdl.ffmpeg_dir):
+        console.print("[yellow]⚠️  FFmpeg dependency missing. Fetching production binary...[/]")
+        
+        # FIX: Escape the executable path in quotes to handle any potential spaces safely
+        cmd = f'"{sys.executable}" -m ffmpeg_downloader install'
+        os.system(cmd)
+        
+        # Force a refresh of the library attributes after installation completes
+        import importlib
+        importlib.reload(ffdl)
+        
+        console.print("[green]✅ FFmpeg successfully provisioned and cached safely.[/]\n")
+    
+    # Inject the fresh binaries into our running OS environment Path mapping
+    ffdl.add_path()
+    
+    # Return the directory path explicitly
+    return str(ffdl.ffmpeg_dir)
+
+
+
+@app.command()
+def greet(name:str,formal:bool=False):
+    """Greet the user with a message. """
+    if formal:
+        console.print(f"Good day, {name}. Welcome to musicmandu!",style="bold green")
+    else:
+        console.print(f"Hey {name}! Welcome to musicmandu!",style="bold blue")
+
+@app.command()
+def download(url:str=typer.Argument(...,help="The Youtube URL to download the music from.")):
+    """
+    Download video audio stream and output a clean, tagged MP3 file.
+    """
+    try:
+        ffmpeg_dir=ensure_ffmpeg_installed()
+
+    except Exception as e:
+        console.print(f"[bold red]Error ensuring FFmpeg is installed: {e}[/bold red]")
+        raise typer.Exit(code=1)
+    
+    console.print(f"[bold cyan] Scanning metadata for the provided URL: {url} [/bold cyan]")
+
+
+    ydl_opts={
+        'format':'bestaudio/best',
+        'outtmpl':'%(title)s.%(ext)s',
+        'ffmpeg_location':ffmpeg_dir,
+        'postprocessors':[
+            {
+                'key': 'FFmpegExtractAudio',
+                'preferredcodec': 'mp3',
+                'preferredquality': '320',
+            },
+            {
+                'key': 'EmbedThumbnail',
+            },
+            {
+                'key': 'FFmpegMetadata',
+            }
+        ],
+        'writethumbnail': True,
+        'quiet': True,
+        'no_warnings': True,
+    }
+
+    try:
+        with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+            info_dict=ydl.extract_info(url, download=False)
+            title=info_dict.get('title','Unknown Track')
+
+            console.print(f"[bold green] 🎵 Target:[/] {title}")
+
+            with console.status("[bold blue] Processing and converting audio strean... This may take a moment.",spinner="dots"):
+                ydl.download([url])
+                console.print(f"[bold green]✅ Download and conversion completed successfully![/bold green]")
+        
+        console.print(f"\n[bold green]📦 Distribution Ready![/] Saved '[italic]{title}.mp3[/]' to current working directory.")
+    except Exception as e:
+        console.print(f"[bold red]Error during download or conversion: {e}[/bold red]")
+        raise typer.Exit(code=1)
+
+if __name__=='__main__':
+    app()

musicmandu-1.0.0/src/musicmandu.egg-info/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.4
+Name: musicmandu
+Version: 1.0.0
+Summary: A production-grade YouTube music downloader CLI
+Author: Milan Prajapati
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: yt-dlp>=2023.0.0
+Requires-Dist: ffmpeg-downloader>=0.1.0
+
+# 🎵 musicmandu
+
+`musicmandu` is a production-grade, zero-configuration command-line interface (CLI) tool written in Python. It allows users to seamlessly download high-quality audio from YouTube videos and automatically process them into fully tagged, album-art-embedded MP3 files.
+
+---
+
+## ✨ Features
+
+- **Zero Manual Dependencies:** Automatically detects, downloads, and caches the correct system-specific FFmpeg binaries at runtime—even when Windows user paths contain spaces.
+- **High-Quality Audio:** Downloads the best available audio stream and converts it into a clean 192 kbps MP3 file.
+- **Rich Metadata Integration:** Automatically extracts and embeds metadata such as the title and creator, then downloads and embeds the video's high-resolution thumbnail as album art.
+- **Sleek Visual Feedback:** Uses `Rich` console components to replace noisy console output with clean status spinners and styled messages.
+
+---
+
+## 🚀 Installation & Prerequisites
+
+`musicmandu` runs on **Windows, macOS, and Linux**.
+
+### 1. Requirements
+
+- Python 3.8 or later
+
+### 2. Set Up the Project
+
+Clone or navigate to the project directory, then install the required Python packages:
+
+```bash
+pip install typer rich yt-dlp ffmpeg-downloader
+```
+
+---
+
+## 🛠 Usage & Commands
+
+Run the CLI using standard Python execution syntax:
+
+```bash
+python main.py [COMMAND] [ARGUMENTS] [FLAGS]
+```
+
+### 1. Greet Users (`greet`)
+
+Test the CLI setup or display a custom greeting.
+
+```bash
+# Standard greeting
+python main.py greet Milan
+
+# Formal greeting
+python main.py greet "Mr. Wayne" --formal
+```
+
+### 2. Download Tracks (`download`)
+
+Download audio and save a formatted MP3 file in the current working directory.
+
+```bash
+python main.py download "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
+```
+
+### 3. View Built-in Help
+
+Display automatically generated command descriptions, arguments, and flags.
+
+```bash
+python main.py --help
+python main.py download --help
+```
+
+---
+
+## ⚙️ Architecture & Under the Hood
+
+The application relies on three core frameworks to provide a seamless user experience:
+
+- **Typer:** Powers command parsing, argument handling, flags, and dynamically generated help screens.
+- **Rich:** Manages styled terminal output, layout, and responsive loading indicators.
+- **yt-dlp and ffmpeg-downloader:** Handle the download and processing pipeline, including metadata extraction, high-bitrate audio retrieval, thumbnail downloading, and FFmpeg-based MP3 conversion.
+
+### Runtime Dependency Sandbox
+
+When the `download` command is invoked, the application runs a gatekeeper function named `ensure_ffmpeg_installed`.
+
+If a valid FFmpeg installation cannot be found in the system path, the application downloads and caches a platform-specific FFmpeg binary. It then maps the binary into the current process environment without modifying the user's global system configuration.
+
+---
+
+## 📝 License
+
+Distributed under the MIT License. See `LICENSE` for more information.
+
+---
+
+## 💡 Project Idea
+
+A useful next feature would be a download history log that records previously downloaded songs.

musicmandu-1.0.0/src/musicmandu.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+src/musicmandu/__init__.py
+src/musicmandu/main.py
+src/musicmandu.egg-info/PKG-INFO
+src/musicmandu.egg-info/SOURCES.txt
+src/musicmandu.egg-info/dependency_links.txt
+src/musicmandu.egg-info/requires.txt
+src/musicmandu.egg-info/top_level.txt

musicmandu-1.0.0/src/musicmandu.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

musicmandu-1.0.0/src/musicmandu.egg-info/requires.txt

@@ -0,0 +1,4 @@
+typer>=0.9.0
+rich>=13.0.0
+yt-dlp>=2023.0.0
+ffmpeg-downloader>=0.1.0

musicmandu-1.0.0/src/musicmandu.egg-info/top_level.txt

@@ -0,0 +1 @@
+musicmandu