{"id":25543842,"url":"https://github.com/kernferm/quantum-vine","last_synced_at":"2025-07-17T02:08:19.187Z","repository":{"id":273645372,"uuid":"920408135","full_name":"KernFerm/Quantum-Vine","owner":"KernFerm","description":null,"archived":false,"fork":false,"pushed_at":"2025-01-22T05:10:12.000Z","size":279,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-22T06:22:14.469Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KernFerm.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-22T05:05:51.000Z","updated_at":"2025-01-22T05:10:15.000Z","dependencies_parsed_at":"2025-01-22T06:22:20.567Z","dependency_job_id":"9386516e-e851-40e7-8d60-b269d4b94bc2","html_url":"https://github.com/KernFerm/Quantum-Vine","commit_stats":null,"previous_names":["kernferm/quantum-vine"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KernFerm%2FQuantum-Vine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KernFerm%2FQuantum-Vine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KernFerm%2FQuantum-Vine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KernFerm%2FQuantum-Vine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KernFerm","download_url":"https://codeload.github.com/KernFerm/Quantum-Vine/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239799928,"owners_count":19699117,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-02-20T07:38:34.361Z","updated_at":"2025-07-17T02:08:19.181Z","avatar_url":"https://github.com/KernFerm.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Quantum-Vine 🌿\r\n\r\n**Quantum-Vine** is a next-generation audio downloader tool 🎵 that allows you to download and convert audio from YouTube 🎥 and Spotify 🎧 effortlessly. With support for metadata embedding 💾, playlist handling 📋, and high-quality audio output 🔊, Quantum-Vine is your all-in-one solution for creating an organized and enriched music library 📚.\r\n\r\n- [https://discord.gg/FxJd3PxXbc](https://discord.gg/FxJd3PxXbc)\r\n\r\n---\r\n\r\n## Features\r\n- 🎥 **YouTube Downloader**\r\n  - Downloads audio from individual YouTube videos or playlists.\r\n  - Converts audio to MP3 format at 192kbps.\r\n  - Automatically embeds metadata (e.g., title, artist, album).\r\n\r\n- 🎵 **Spotify Downloader**\r\n  - Downloads individual tracks or playlists from Spotify.\r\n  - Converts tracks to MP3 format with a customizable bitrate.\r\n\r\n- 🚀 **Easy to Use GUI**\r\n  - Modern interface using `ttkbootstrap` for a better user experience.\r\n  - Smooth progress tracking, log viewer, and intuitive input fields.\r\n\r\n- 🔧 **Dependencies Handled**\r\n  - Checks for required tools like FFmpeg.\r\n  - Automatically installs missing Python packages like `spotDL`.\r\n\r\n---\r\n\r\n## Installation\r\n\r\n### 1. Download ZIP:\r\n1. 📥 Click the green `\"Code\"` button at the top right of the repository page.\r\n2. 📂 Choose `\"Download ZIP\"` from the dropdown menu.\r\n3. 📁 This will download a `ZIP file` with the entire repository.\r\n\r\n### 2. Extract the ZIP File:\r\n1. 🗂 Find the downloaded `ZIP file` on your computer.\r\n2. 🔧 `Extract` it using your computer's built-in extraction tool or a third-party tool like `WinRAR` or `7-Zip`.\r\n\r\n### 3. Run the Script\r\n- **Double-click** `python3119.bat`\r\n- **Type `Y` and press Enter** to begin installation\r\n\r\n### 4. Python Installation 🐍\r\nIf Python **is not installed**, the script will:\r\n- Download \u0026 Install **Python 3.11.9**\r\n- Automatically **add Python to PATH**\r\n\r\n### 5. Install Required Dependencies\r\nMake sure Python is installed, then run:\r\n\r\n```bash\r\npip install -r requirements.txt\r\n```\r\n\r\n### 6. Install FFmpeg\r\n\r\n#### Option A: Install with `winget` (Recommended for Windows Users)\r\n\r\nRun this command in **Command Prompt** or **PowerShell** as Administrator:\r\n\r\n```bash\r\nwinget install --id Gyan.FFmpeg -e --source winget\r\n```\r\n- If you have issues with winget installing [Fixing Winget - Workaround CLICK HERE](https://github.com/KernFerm/winget-workaround)\r\n\r\n#### Option B: Install with Chocolatey (Alternative)\r\n\r\nFirst, install Chocolatey:\r\n\r\n```powershell\r\nSet-ExecutionPolicy Bypass -Scope Process -Force; \\\r\n[System.Net.ServicePointManager]::SecurityProtocol = \\\r\n[System.Net.ServicePointManager]::SecurityProtocol -bor 3072; \\\r\niex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))\r\n```\r\n\r\nThen install FFmpeg:\r\n\r\n```bash\r\nchoco install ffmpeg\r\n```\r\n\r\nMake sure FFmpeg is added to your system PATH.\r\n\r\n---\r\n\r\n## How to Use\r\n\r\n1. **Launch the Application**  \r\n   Run the `Quantum-Vine.py` script using Python to open the GUI.\r\n\r\n2. **Select the Appropriate Tab**  \r\n   - **YouTube Tab:** For downloading audio from YouTube videos and playlists.\r\n   - **Spotify Tab:** For downloading audio from Spotify albums or playlists.\r\n\r\n3. **Copy \u0026 Paste the URL**  \r\n   - Copy the URL from your browser (using **CTRL+C**).\r\n   - Click in the URL input field in the desired tab.\r\n   - Paste the URL using **CTRL+V**.\r\n\r\n4. **Start the Download**  \r\n   Click the **Download** button. The application will begin processing your request:\r\n   - **YouTube Downloads:** A percentage progress bar and log messages will show the progress of the download and conversion.\r\n   - **Spotify Downloads:** A percentage progress bar will display progress as the download proceeds (if available), along with status messages.\r\n\r\n5. **Find Your Files**  \r\n   Once the download and conversion are complete, your audio files will be stored in:\r\n   - `downloaded_audio/Youtube/` for YouTube downloads.\r\n   - `downloaded_audio/Spotify/` for Spotify downloads.\r\n\r\n## Example URL Formats\r\n\r\nUse the following URL formats for best results:\r\n\r\n- **YouTube Video:**  \r\n  `https://www.youtube.com/watch?v=...`\r\n\r\n- **Spotify Album:**  \r\n  `https://open.spotify.com/album/...`\r\n\r\n- **Spotify Playlist:**  \r\n  `https://open.spotify.com/playlist/...`\r\n\r\n\u003e **Important:** You must use **CTRL+V** to paste the URL that you copied from your browser.\r\n\r\n## Screenshot\r\n\r\n\u003cimg src=\"https://github.com/KernFerm/Quantum-Vine/blob/main/screenshot/image-1.png\" width=\"470\"\u003e\r\n\u003cimg src=\"https://github.com/KernFerm/Quantum-Vine/blob/main/screenshot/image-2.png\" width=\"470\"\u003e\r\n\r\n### To `download` another link simply just `highlight` the existing url and press the `Delete` key.\r\n\r\n## Troubleshooting\r\n\r\n- **Invalid URL:**  \r\n  Ensure that you paste a correct and complete URL. The application supports YouTube and Spotify URLs as shown above.\r\n  \r\n- **No Progress:**  \r\n  If the progress bar or log messages do not update, check your internet connection or try running the script as administrator.\r\n  \r\n- **FFmpeg Issues:**  \r\n  The application requires FFmpeg for converting audio to MP3. If FFmpeg is not found or you encounter issues:\r\n  - The application will attempt to download and install FFmpeg automatically.\r\n  - If automatic installation fails, you can manually download FFmpeg from [ffmpeg.org/download.html](https://ffmpeg.org/download.html) and follow the instructions to add it to your system PATH.\r\n\r\n## Additional Information\r\n\r\n- **Progress Indicators:**  \r\n  The application displays a percentage progress bar for both YouTube and Spotify downloads (if percentage data is available), so you know when the process is complete.\r\n\r\n- **Log Messages:**  \r\n  Real-time log messages in the GUI inform you of the current status, including any errors or progress updates.\r\n\r\n---\r\n\r\n## Requirements\r\n\r\n- `Python 3.11.9`\r\n- `FFmpeg` installed and added to PATH\r\n\r\n### Python Package Requirements\r\n```\r\npydub\r\nyt-dlp\r\nmutagen\r\nspotdl\r\npyarmor\r\nttkbootstrap\r\n```\r\n\r\n---\r\n\r\n## Known Limitations\r\n\r\n- You **must keep the console (CMD) window open**. Closing it may stop the application.\r\n- On some machines, GUI apps require this console for subprocess handling.\r\n\r\n---\r\n\r\n## Disclaimer\r\nQuantum-Vine is intended for personal use only. Please respect copyright laws and ensure you have the right to download and convert content.\r\n\r\n---\r\n\r\n## LICENSE\r\n\r\n### ***This project is proprietary and all rights are reserved by the author.***\r\n### ***Unauthorized copying, distribution, or modification of this project is strictly prohibited.***\r\n### ***Unless you have written permission from the Developer, [Bubbles The Dev](https://github.com/kernferm).***\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkernferm%2Fquantum-vine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkernferm%2Fquantum-vine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkernferm%2Fquantum-vine/lists"}