{"id":13826663,"url":"https://github.com/schlopp96/V2Mp3","last_synced_at":"2025-07-09T00:34:24.199Z","repository":{"id":37023460,"uuid":"467787028","full_name":"schlopp96/V2Mp3","owner":"schlopp96","description":"Compact video-to-audio conversion tool with built-in YouTube video/audio download functionality. Currently only compatible with Windows-based systems.","archived":false,"fork":false,"pushed_at":"2024-07-16T05:36:37.000Z","size":435,"stargazers_count":4,"open_issues_count":8,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2024-10-30T15:50:44.897Z","etag":null,"topics":["audio-video-downloader","conversion","ffmpeg","file-conversion","file-format-converter","gui","pysimplegui","python-gui","video-to-audio","windows-desktop-application","youtube","youtube-audio-downloader","youtube-dl","youtube-to-mp3-converter","youtube-video-downloader"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/schlopp96.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-03-09T05:16:25.000Z","updated_at":"2024-04-27T09:08:07.000Z","dependencies_parsed_at":"2024-07-16T08:08:31.923Z","dependency_job_id":null,"html_url":"https://github.com/schlopp96/V2Mp3","commit_stats":{"total_commits":41,"total_committers":1,"mean_commits":41.0,"dds":0.0,"last_synced_commit":"c7402ba36e654d094cfb9a83b50fd8ef502f67dc"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schlopp96%2FV2Mp3","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schlopp96%2FV2Mp3/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schlopp96%2FV2Mp3/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/schlopp96%2FV2Mp3/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/schlopp96","download_url":"https://codeload.github.com/schlopp96/V2Mp3/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224528701,"owners_count":17326405,"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":["audio-video-downloader","conversion","ffmpeg","file-conversion","file-format-converter","gui","pysimplegui","python-gui","video-to-audio","windows-desktop-application","youtube","youtube-audio-downloader","youtube-dl","youtube-to-mp3-converter","youtube-video-downloader"],"created_at":"2024-08-04T09:01:42.185Z","updated_at":"2024-11-20T05:30:57.479Z","avatar_url":"https://github.com/schlopp96.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# V2Mp3\n\n![Logo](./img/V2Mp3_Logo.png)\n\n---\n\n## About\n\n**_`V2Mp3`_** is a simple, compact video-to-audio conversion tool with built-in _**YouTube**_ video/audio download functionality.\n\n- Convert locally stored video files _**([of any file-format supported by `ffmpeg`](https://ffmpeg.org/general.html#Video-Codecs))**_ to _**.mp3**_ audio.\n\n  - A few of these formats include:\n    - .aiff\n    - .avi\n    - .flv\n    - .gif\n    - .mov\n    - .mpg\n    - .mp4\n    - .ogv\n    - .qt\n    - .wmv\n    - many others.\n\n- Download _**YouTube**_ videos as _**.mp4**_ files.\n\n- Download _**YouTube**_ audio as _**.mp3**_ files.\n\n---\n\n## Installation\n\n### Using pip\n\n\u003e _Easiest_ method. **Highly recommended over manual installation.**\n\n- Run the following to install using `pip`:\n\n  ```shell\n  pip install V2Mp3\n  ```\n\n- You should now be able to import/run _**`V2Mp3`**_ within your python environment by entering the following:\n\n  ```python\n  \u003e\u003e\u003e from V2Mp3 import v2mp3\n  \u003e\u003e\u003e v2mp3() # open program window.\n  ...\n  ```\n\n- Done!\n\n---\n\n### Manual Installation\n\n\u003e _Not_ recommended.\n\n1. Start by doing one of two things:\n\n   - _**A.**_ Download source code **\\*.zip** archive from the V2Mp3 GitHub repo [\"releases\"](https://github.com/schlopp96/V2Mp3/releases/latest) tab, and extract the contents to your desired installation directory.\n   - _**B.**_ Clone the repo with the git client of your choice by entering the following command:\n     - `git clone https://github.com/schlopp96/V2Mp3/releases/latest/`\n\n2. Navigate to directory containing extracted contents, and open said directory within a terminal.\n\n3. Install all dependencies for this package by entering the following command:\n\n   - `pip install -r requirements.txt`\n\n4. **(OPTIONAL)**\n   - Move the _**`V2Mp3-vx.x.x`**_ directory to your global Python 3rd-party package installation directory to be able to import _**V2Mp3**_ like any other module:\n     - `\"path/to/python/Lib/site-packages/HERE\"`\n\n- You should now be able to import/run _**V2Mp3**_ within your python environment by entering the following:\n\n```python\n  \u003e\u003e\u003e from V2Mp3 import v2mp3\n  \u003e\u003e\u003e v2mp3() # open program window.\n...\n```\n\n- Done!\n\n---\n\n## Usage\n\n\u003e Using _**`V2Mp3`**_ is generally straightforward, with directions and tooltips built in to the GUI describing what to do if you're confused.\n\n- You can quickly start _**`V2Mp3`**_ using this simple CLI command:\n\n```shell\n  v2mp3\n```\n\n- Other ways to start V2Mp3 include:\n\n  - Entering `python -m V2Mp3` in a terminal.\n  - Importing _**`V2Mp3`**_ in a python environment and calling _`V2Mp3.v2mp3()`_ from within that environment (as illustrated above).\n  - Opening `\"~/V2Mp3/main.pyw\"` from a file explorer.\n\n---\n\n## Structure\n\n### **First Containing Frame**\n\n- Home to the _**YouTube**_ download section\n- Enter your desired _**YouTube**_ video's URL address in the input field.\n  - Also works with _**YouTube Music**_ addresses.\n- Choose whether to download the video as normal, or just the audio from the video.\n- Once ready, click the \"**Download**\" button to begin.\n- You can find your downloaded videos within the _**V2Mp3**_ installation directory:\n  - `\"~/V2Mp3/downloads/videos\"`\n\n### **Second Containing Frame**\n\n- Contains the section for conversion of your local video files.\n- Use the \"Browse\" button to choose a video file you wish to convert to audio.\n- Once you've chosen a video, click the \"**Convert File**\" button at the bottom of the first frame.\n- The text output window at the bottom of the application window will display whether or not the conversion was successful.\n- Newly converted .mp3 audio files can be found within the _**V2Mp3**_ installation directory:\n  - `\"~/V2Mp3/downloads/audio\"`\n\n### Quick Look at _**`V2Mp3`**_\n\n![V2Mp3](./img/v2mp3_gui.png)\n\n---\n\n## Coming Soon\n\n- **\\*.exe** program build so that a Python env isn't necessary to run **_V2Mp3_**.\n\n---\n\n## Contact\n\n- If you have any questions, comments, or concerns that cannot be addressed through the [project's GitHub repository](https://github.com/schlopp96/V2Mp3), please feel free to contact me through my email address:\n\n  - `schloppdaddy@gmail.com`\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fschlopp96%2FV2Mp3","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fschlopp96%2FV2Mp3","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fschlopp96%2FV2Mp3/lists"}