mooze 1.0.0__py3-none-any.whl

mooze/downloader.py

@@ -0,0 +1,105 @@
+import yt_dlp
+import urllib.request
+import json
+import re
+from typing import Any
+
+def get_spotify_query(url: str) -> str:
+    """Uses a Googlebot disguise to extract both the song title AND the artist."""
+    clean_url = url.split('?')[0]
+    
+    try:
+        headers = {
+            'User-Agent': 'Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)'
+        }
+        req = urllib.request.Request(clean_url, headers=headers)
+        html = urllib.request.urlopen(req).read().decode('utf-8')
+        
+        title_match = re.search(r'<title>(.*?)</title>', html, re.IGNORECASE)
+        if title_match:
+            raw_title = title_match.group(1)
+            clean_title = raw_title.replace('| Spotify', '').replace('- song and lyrics by', ' ').replace('- song by', ' ').replace('- single by', ' ')
+            if clean_title.strip():
+                return clean_title.strip()
+    except Exception:
+        pass 
+        
+    try:
+        oembed_url = f"https://open.spotify.com/oembed?url={clean_url}"
+        req = urllib.request.Request(oembed_url, headers={'User-Agent': 'Mozilla/5.0'})
+        response = urllib.request.urlopen(req).read().decode('utf-8')
+        data = json.loads(response)
+        
+        if "title" in data and "author_name" in data:
+            return f"{data['title']} {data['author_name']}"
+        elif "title" in data:
+            return data["title"]
+    except Exception:
+        pass
+        
+    raise ValueError("Could not translate Spotify link. Try typing the song name instead!")
+
+def download_song(search_query: str, save_location: str, format_choice: str, progress_callback=None):
+    
+    if "spotify.com" in search_query:
+        search_query = get_spotify_query(search_query)
+
+    codec = "mp3"
+    quality = "192"
+    embed_art = True 
+    
+    # 1. Parse the custom syntax (e.g. ".flac, 192")
+    try:
+        parts = format_choice.split(",")
+        if len(parts) == 2:
+            codec = parts[0].strip()[1:].lower()  # Removes the '.' and forces lowercase
+            # Extract just the digits in case they accidentally typed "192kbps"
+            quality_str = ''.join(filter(str.isdigit, parts[1]))
+            if quality_str:
+                quality = quality_str
+    except Exception:
+        pass  # Fallback to mp3 defaults if parsing catastrophically fails
+
+    # 2. Prevent FFmpeg crashes by disabling image art for specific containers
+    if codec in ["wav", "flac", "opus", "ogg"]:
+        embed_art = False 
+        
+    def my_hook(d):
+        if d['status'] == 'downloading':
+            downloaded = d.get('downloaded_bytes', 0)
+            total = d.get('total_bytes') or d.get('total_bytes_estimate', 0)
+            if progress_callback and total > 0:
+                progress_callback(downloaded, total)
+
+    postprocessors: list[dict[str, Any]] = [{
+        'key': 'FFmpegExtractAudio',
+        'preferredcodec': codec,
+        'preferredquality': quality,
+    }]
+    
+    if embed_art:
+        postprocessors.append({
+            'key': 'FFmpegThumbnailsConvertor',
+            'format': 'jpg',
+        })
+        postprocessors.append({
+            'key': 'EmbedThumbnail',
+        })
+        
+    postprocessors.append({
+        'key': 'FFmpegMetadata',
+        'add_metadata': True,
+    })
+
+    options: Any = {
+        'format': 'bestaudio/best',
+        'outtmpl': f'{save_location}/%(title)s.%(ext)s',
+        'default_search': 'ytsearch1:',
+        'noplaylist': True,
+        'writethumbnail': embed_art, 
+        'progress_hooks': [my_hook], 
+        'postprocessors': postprocessors,
+    }
+    
+    with yt_dlp.YoutubeDL(options) as ydl:
+        ydl.download([search_query])

mooze/main.py

@@ -0,0 +1,316 @@
+from textual.app import App, ComposeResult
+from textual.widgets import Header, Footer, Input, Button, TextArea, Label, ProgressBar, TabbedContent, TabPane, Collapsible
+from textual.containers import Horizontal, Vertical
+from textual import on, work, events
+from textual.binding import Binding
+from .downloader import download_song 
+import os
+import shutil
+import json
+import sys
+import subprocess
+
+CONFIG_FILE = os.path.expanduser("~/.mooze_settings.json")
+
+class StaticHeader(Header):
+    def on_click(self, event: events.Click):
+        event.stop()
+        event.prevent_default()
+
+def load_settings():
+    if os.path.exists(CONFIG_FILE):
+        try:
+            with open(CONFIG_FILE, "r") as f:
+                return json.load(f)
+        except Exception:
+            pass
+    return {}
+
+def save_settings(format_choice, save_location, theme_choice):
+    try:
+        with open(CONFIG_FILE, "w") as f:
+            json.dump({
+                "format": format_choice, 
+                "save_location": save_location,
+                "theme": theme_choice
+            }, f)
+    except Exception:
+        pass
+
+class MoozeApp(App):
+    TITLE = "Mooze"
+    COMMAND_PALETTE_BINDING = ""
+
+    CSS = """
+    #main-area { height: 1fr; margin: 1; }
+    
+    /* FIXED: Changed from 1fr to auto so it hugs the search inputs tightly */
+    #tabs { height: auto; }
+    #single-tab, #batch-tab { padding: 1 2; height: auto; }
+    
+    #single-search-input { margin-bottom: 1; }
+    
+    #batch-label { margin-bottom: 1; color: $text-muted; }
+    #batch-search-input { height: auto; min-height: 3; max-height: 12; }
+    
+    #download-settings { margin-top: 1; height: auto; }
+    #options-row { height: auto; align: left middle; padding-top: 1; }
+    #options-row Input { width: 1fr; margin: 0 1; }
+    
+    .download-btn { width: 100%; margin-top: 1; }
+    #my-progress-bar { height: auto; margin: 1 2; display: none; }
+    
+    #options-row Input.error, #single-search-input.error, #batch-search-input.error { border: tall red; }
+    """
+
+    BINDINGS = [
+        Binding("d", "quit", "Quit Mooze"),
+        Binding("s", "save_png", "Screenshot (.png)"),
+        Binding("k", "toggle_footer", "Toggle Keys Help"),
+        Binding("escape", "remove_focus", "Deselect", show=False),
+        Binding("alt+p", "command_palette", "Palette", show=False),
+        Binding("ctrl+p", "command_palette", "Palette", show=False),
+        Binding("backslash", "command_palette", "Palette", show=False),
+    ]
+
+    def compose(self) -> ComposeResult:
+        yield StaticHeader(show_clock=False)
+        
+        with Vertical(id="main-area"):
+            with TabbedContent(id="tabs"):
+                with TabPane("Single Download", id="single-tab"):
+                    yield Input(placeholder="Paste a Spotify link or search for a song here...", id="single-search-input")
+                    
+                with TabPane("Batch Download", id="batch-tab"):
+                    yield Label("Paste your list of Spotify links (One per line):", id="batch-label")
+                    yield TextArea(id="batch-search-input")
+            
+            with Collapsible(title="Download Settings (Format & Save Path)", id="download-settings"):
+                with Horizontal(id="options-row"):
+                    yield Input(placeholder="Format (e.g. .flac, 192)", id="format-input")
+                    yield Input(placeholder="Save Path (e.g. C:/Music)", id="save-location")
+            
+            yield Button("Start Download", variant="success", id="download-btn", classes="download-btn")
+            yield ProgressBar(id="my-progress-bar")
+        
+        yield Footer()
+
+    def on_mount(self):
+        settings = load_settings()
+        
+        if "theme" in settings and settings["theme"]:
+            self.theme = str(settings["theme"])
+        else:
+            self.theme = "textual-dark"
+            
+        if "format" in settings and settings["format"]:
+            self.query_one("#format-input", Input).value = settings["format"]
+            
+        if "save_location" in settings and settings["save_location"]:
+            self.query_one("#save-location", Input).value = settings["save_location"]
+
+    @on(events.MouseDown)
+    def handle_background_click(self, event: events.MouseDown):
+        widget, _ = self.screen.get_widget_at(event.screen_x, event.screen_y)
+        if widget and widget.id in ("main-area", "options-row", "single-tab", "batch-tab", "download-settings"):
+            self.set_focus(None)
+
+    def action_remove_focus(self):
+        self.set_focus(None)
+        
+    def action_toggle_footer(self):
+        footer = self.query_one(Footer)
+        footer.display = not footer.display
+
+    # =========================================================================
+    # COMMAND PALETTE
+    # =========================================================================
+    def _apply_and_save_theme(self, theme_name: str):
+        self.theme = theme_name
+        fmt = self.query_one("#format-input", Input).value
+        loc = self.query_one("#save-location", Input).value
+        save_settings(fmt, loc, theme_name)
+        self.notify(f"Theme updated to {theme_name}", severity="information")
+
+    def action_theme_dark(self): self._apply_and_save_theme("textual-dark")
+    def action_theme_light(self): self._apply_and_save_theme("textual-light")
+    def action_theme_solarized_dark(self): self._apply_and_save_theme("solarized-dark")
+    def action_theme_solarized_light(self): self._apply_and_save_theme("solarized-light")
+    def action_theme_dracula(self): self._apply_and_save_theme("dracula")
+    def action_theme_nord(self): self._apply_and_save_theme("nord")
+    def action_theme_monokai(self): self._apply_and_save_theme("monokai")
+
+    def action_clear_inputs(self):
+        self.query_one("#single-search-input", Input).value = ""
+        self.query_one("#batch-search-input", TextArea).text = ""
+        self.notify("All inputs cleared.", severity="information")
+
+    def action_open_download_folder(self):
+        path = self.query_one("#save-location", Input).value
+        if not path or not os.path.exists(path):
+            self.notify("The save folder does not exist yet!", severity="error")
+            return
+        try:
+            if sys.platform == "win32": os.startfile(path)
+            elif sys.platform == "darwin": subprocess.call(["open", path])
+            else: subprocess.call(["xdg-open", path])
+        except Exception as e:
+            self.notify(f"Could not open folder: {e}", severity="error")
+
+    # =========================================================================
+    # DOWNLOAD LOGIC & STRICT VALIDATION
+    # =========================================================================
+
+    @on(Button.Pressed)
+    def start_downloading(self, event: Button.Pressed):
+        if event.button.id != "download-btn":
+            return
+            
+        format_input = self.query_one("#format-input", Input)
+        save_location = self.query_one("#save-location", Input)
+        single_input = self.query_one("#single-search-input", Input)
+        batch_input = self.query_one("#batch-search-input", TextArea)
+        
+        format_input.remove_class("error")
+        save_location.remove_class("error")
+        single_input.remove_class("error")
+        batch_input.remove_class("error")
+        
+        has_error = False
+        
+        raw_format = format_input.value.strip()
+        is_valid_format = False
+        
+        if raw_format.startswith(".") and "," in raw_format:
+            parts = raw_format.split(",")
+            ext = parts[0].strip()[1:] 
+            try:
+                bitrate_str = ''.join(filter(str.isdigit, parts[1]))
+                bitrate = int(bitrate_str) if bitrate_str else 0
+                
+                if 92 <= bitrate <= 320 and ext.isalnum():
+                    is_valid_format = True
+                    format_input.value = f".{ext.lower()}, {bitrate}"
+            except ValueError:
+                pass
+
+        if not is_valid_format:
+            format_input.add_class("error")
+            has_error = True
+            self.notify("Format must be '.ext, bitrate' (e.g. .mp3, 320). Bitrate limit: 92-320.", severity="error", timeout=6)
+            self.query_one("#download-settings", Collapsible).collapsed = False
+            
+        if save_location.value.strip() == "":
+            save_location.add_class("error")
+            has_error = True
+            self.query_one("#download-settings", Collapsible).collapsed = False
+            
+        active_tab = self.query_one("#tabs", TabbedContent).active
+        is_batch_mode = (active_tab == "batch-tab")
+        
+        if is_batch_mode:
+            raw_text = batch_input.text
+            if not raw_text.strip():
+                batch_input.add_class("error")
+                has_error = True
+            songs_to_download = raw_text.strip().split("\n")
+        else:
+            raw_text = single_input.value
+            if not raw_text.strip():
+                single_input.add_class("error")
+                has_error = True
+            songs_to_download = [raw_text.strip()]
+            
+        if has_error:
+            if is_valid_format: 
+                self.notify("Oops! Please fill out all required fields.", severity="error")
+            return
+            
+        save_settings(format_input.value, save_location.value, self.theme)
+            
+        progress_bar = self.query_one("#my-progress-bar", ProgressBar)
+        progress_bar.display = True
+        progress_bar.update(total=100, progress=0)
+        
+        self.notify("Starting your download process! Please wait...")
+        self.run_engine(songs_to_download, save_location.value, format_input.value, is_batch_mode)
+
+    def update_progress_ui(self, downloaded, total):
+        progress_bar = self.query_one("#my-progress-bar", ProgressBar)
+        progress_bar.update(total=total, progress=downloaded)
+
+    @work(thread=True)
+    def run_engine(self, songs, save_path, audio_format, is_batch):
+        try:
+            def progress_callback(downloaded, total):
+                self.app.call_from_thread(self.update_progress_ui, downloaded, total)
+
+            if is_batch and len(songs) > 1:
+                working_path = os.path.join(save_path, "Mooze_Temp_Batch")
+                os.makedirs(working_path, exist_ok=True)
+            else:
+                working_path = save_path
+
+            for song in songs:
+                if song.strip(): 
+                    self.app.call_from_thread(self.update_progress_ui, 0, 100)
+                    download_song(song.strip(), working_path, audio_format, progress_callback)
+            
+            if is_batch and len(songs) > 1:
+                zip_filename = os.path.join(save_path, "Mooze_Batch_Archive")
+                shutil.make_archive(zip_filename, 'zip', working_path)
+                shutil.rmtree(working_path) 
+                
+            self.app.call_from_thread(self.finish_download, True, "All downloads completed successfully!")
+        except Exception as e:
+            self.app.call_from_thread(self.finish_download, False, str(e))
+            
+    def finish_download(self, success: bool, message: str):
+        progress_bar = self.query_one("#my-progress-bar", ProgressBar)
+        progress_bar.display = False
+        if success:
+            self.notify(message, title="Success!")
+        else:
+            self.notify(f"Engine Error: {message}", title="Oops!", severity="error")
+
+    # =========================================================================
+    # DPI-AWARE SCREENSHOT TOOL
+    # =========================================================================
+    def action_save_png(self):
+        try:
+            from PIL import ImageGrab
+            import sys
+            
+            self.notify("Capturing screenshot...", title="Processing")
+            filename = "mooze_screenshot.png"
+            
+            if sys.platform == "win32":
+                import ctypes
+                from ctypes import wintypes
+                
+                user32 = ctypes.windll.user32
+                user32.SetProcessDPIAware()
+                
+                hwnd = user32.GetForegroundWindow()
+                rect = wintypes.RECT()
+                user32.GetWindowRect(hwnd, ctypes.byref(rect))
+                
+                bbox = (rect.left, rect.top, rect.right, rect.bottom)
+                screenshot = ImageGrab.grab(bbox=bbox)
+            else:
+                screenshot = ImageGrab.grab()
+                
+            screenshot.save(filename)
+            self.notify(f"Saved: {filename}", title="Screenshot", severity="information")
+            
+        except ImportError:
+            self.notify("Missing dependency! Run: pip install pillow", severity="error", timeout=10)
+        except Exception as e:
+            self.notify(f"Screenshot failed: {str(e)}", title="Error", severity="error", timeout=15)
+
+def start():
+    app = MoozeApp()
+    app.run()
+
+if __name__ == "__main__":
+    start()

mooze-1.0.0.dist-info/METADATA

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: mooze
+Version: 1.0.0
+Summary: A modern, TUI-based Spotify and YouTube audio downloader.
+Author-email: Reyhan Janus <reyhanjanus@gmail.com>
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Environment :: Console
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: textual>=0.38.1
+Requires-Dist: yt-dlp>=2023.10.13
+Requires-Dist: pillow>=10.0.0
+Dynamic: license-file
+
+# 🎵 Mooze
+
+
+<!-- PROJECT BADGES -->
+
+<div align="left">
+  <img src="https://img.shields.io/badge/Python-3.10+-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python Version" />
+  <img src="https://img.shields.io/badge/UI-Textual%20TUI-22C55E?style=flat-square&logo=gnuterminal&logoColor=white" alt="Textual TUI" />
+  <img src="https://img.shields.io/badge/Engine-yt--dlp-FF0000?style=flat-square&logo=youtube&logoColor=white" alt="yt-dlp Engine" />
+  <img src="https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-4B5563?style=flat-square" alt="Platform Support" />
+  <img src="https://img.shields.io/badge/License-MIT-F59E0B?style=flat-square&logo=opensourceinitiative&logoColor=white" alt="MIT License" />
+</div>
+
+---
+
+![1784285736694](image/README/1784285736694.png)
+
+---
+
+## ✨ Features
+
+* **Dual Download Modes:**
+  * **Single Mode:** Paste a Spotify track link or type a raw search query (e.g., "Coldplay Yellow").
+  * **Batch Mode:** Paste a list of multiple Spotify links (one per line) to download them all at once. Batch downloads are automatically zipped into a neat archive!
+* **Smart Spotify Translation:** Bypasses web-scrapers using oEmbed and Googlebot masking to accurately extract Track + Artist data.
+* **Audiophile Quality:** Choose your preferred output:
+  * MP3 - High Quality (320kbps)
+  * MP3 - Normal (128kbps)
+  * WAV - Best Quality (Lossless)
+* **Modern Terminal UI:** Built with Textual, featuring mouse support, smooth toggle switches, and background asynchronous workers to keep the UI perfectly responsive while downloading.
+
+---
+
+## 🛠️ Prerequisites
+
+Mooze uses `yt-dlp` under the hood, which requires **FFmpeg** to convert video files into clean MP3/WAV audio.
+
+**Windows:**
+
+```PowerShell
+winget install ffmpeg
+```
+
+**MacOS:**
+
+```PowerShell
+brew install ffmpeg
+```
+
+**Linux:**
+
+```PowerShell
+sudo apt install ffmpeg
+```
+
+*(Note: Restart your terminal after installing FFmpeg so your system recognizes it.)*
+
+---
+
+## 🚀 Installation
+
+Because Mooze is packaged professionally, you can install it globally on your system.
+
+1. Clone the repository:
+
+```Shell
+git clone [https://github.com/X0fx/mooze.git](https://github.com/X0fx/mooze.git)
+cd mooze
+```
+
+2. Install the application:
+
+```Shell
+pip install -e .
+```
+
+---
+
+## 📖 User Manual
+
+Once installed, simply type `mooze` in any terminal to launch the dashboard.
+
+### 📥 Single Song Download
+
+1. Ensure the **Batch Mode** switch is toggled  **OFF** .
+2. In the input box, paste a **Spotify Track Link** (e.g., `https://open.spotify.com/track/...`) OR type a search term (e.g., `Mozart Requiem`).
+3. Select your desired audio format from the dropdown menu.
+4. Type your save folder path (e.g., `C:/Users/YourName/Downloads` or just `./` for the current folder).
+5. Click  **Search & Download** .
+
+### 📦 Batch Downloading
+
+1. Toggle the **Batch Mode** switch to  **ON** . The UI will dynamically expand.
+2. Paste multiple Spotify links into the text area. **You must put exactly one link per line.**
+3. Select your audio format and your save location.
+4. Click  **Download Batch** .
+
+*Note: Mooze will create a temporary folder, process all your songs, compress them into a `Mooze_Batch_Archive.zip` file in your save directory, and clean up the temporary files automatically.*
+
+---
+
+## ⚠️ Disclaimer
+
+This tool is for educational purposes and personal use only. It relies on publicly available APIs and YouTube search mechanisms. Please respect digital rights and support the artists you listen to.

mooze-1.0.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+mooze/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mooze/downloader.py,sha256=3Jv3nB480d4473S-Xjl4IKIcaAN_WIhoxMcTK9TpSeM,3782
+mooze/main.py,sha256=jCzY2Avp4FgpWlLRIqq8Npq9FAZSZKxyjJWmhBECY5c,13387
+mooze-1.0.0.dist-info/licenses/LICENSE,sha256=c8SqFGEYyHRkmRWsNinAhXoOJ56ZheunEtDI9PAij6o,1166
+mooze-1.0.0.dist-info/METADATA,sha256=pQceWg0GDKdAAXbhVd0sVoZpi2qX5zkbpjTzM02YUsI,4170
+mooze-1.0.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+mooze-1.0.0.dist-info/entry_points.txt,sha256=2b9tg0wc46rks9LCHFdqEge1vF04eeJfvoha44sDJOA,43
+mooze-1.0.0.dist-info/top_level.txt,sha256=YXLb673Zm6qyE--gy9GdKkvflfmOFyVkCg9pzfDA-6c,6
+mooze-1.0.0.dist-info/RECORD,,

mooze-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

mooze-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mooze = mooze.main:start

mooze-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,25 @@
+MIT License
+
+Copyright (c) 2026 X0fx
+
+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
+<<<<<<< HEAD
+SOFTWARE.
+=======
+SOFTWARE.
+>>>>>>> 0978b1d7cfdb5680d7cb2ca9e75957e063ab97c0

mooze-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+mooze