Metadata-Version: 2.1
Name: V2Mp3
Version: 0.0.1
Summary: Compact video-to-audio convertion tool built with YouTube video/audio download functionality.
Home-page: https://github.com/schlopp96/V2Mp3
Author: schlopp96
Author-email: schloppdaddy@gmail.com
License: UNKNOWN
Keywords: youtube to mp3 video file convert converter download python py python3 audio
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: End Users/Desktop
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Description-Content-Type: text/markdown
License-File: LICENSE

# V2Mp3

## About

**_V2Mp3_** is a compact video-to-audio convertion tool built with _**YouTube**_ video/audio download functionality.

- Convert locally stored video files _**(of any [formatting supported by `ffmpeg`](https://ffmpeg.org/general.html#Video-Codecs) such as: *.mp4, *.avi,\*.mov, etc)**_ to _**.mp3**_ audio.

- Download _**YouTube**_ videos as _**\*.mp4**_ files.

- Download _**YouTube**_ audio as _**\*.mp3**_ files.

---

## Usage

### Using _**V2Mp3**_ is generally straightforward, with directions and tooltips built in to the GUI describing what to do if you're confused

---

### **First Containing Frame**

- Contains the section for conversion of your local video files.
- Use the "Browse" button to choose a video file you wish to convert to audio.
- Once you've chosen a video, click the "**Convert**" button at the bottom of the first frame.
- The text output window at the bottom of the application window will display whether or not the conversion was successful.
- Newly converted \*.mp3 audio files can be found within the `"./audio"` folder, inside the _**V2Mp3**_ installation directory:
  - `"./path/to/V2Mp3/audio"`

### **Second Containing Frame**

- Home to the _**YouTube**_ download section
- Enter your desired _**YouTube**_ video's URL address in the input field.
  - Also works with _**YouTube Music**_ addresses.
- Choose whether to download the video as normal, or just the audio from the video.
- Once ready, click the "**Download**" button to begin.
- You can find your downloaded videos within the `"./video"` folder, inside the _**V2Mp3**_ installation directory:
  - `"./path/to/V2Mp3/video"`

### Quick Loot at V2Mp3

![alt](..\V2Mp3\docs\v2mp3_photo.png)

---

## Installation

### Using pip

> _Easiest_ method. Highly recommended over manual installation.

- Run the following to install:

```python
    pip install V2Mp3
```

- You should now be able to import `V2Mp3` directly to your application.

---

### Manual Installation

> _Not_ recommended.

1. Download source code from the [V2Mp3 GitHub repo](https://github.com/schlopp96/V2Mp3).

2. Extract contents of the containing `**.zip` file to desired install location.

3. Navigate to directory containing extracted contents, and open said folder within a terminal.

4. Enter `pip install -r requirements.txt` to install all dependencies for this package.

5. Finally, 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:

   - `"path/to/python/Lib/site-packages/HERE"`

6. Done!

---

## Contact

- 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:

  - `schloppdaddy@gmail.com`

---


