https://github.com/irahorecka/youtube2audio

GUI application to download YouTube videos as annotated MP3 or MP4 files
https://github.com/irahorecka/youtube2audio

annotated-mp3-files convert-youtube-videos desktop-application ffmpeg mp3 mp4 pyqt5 video youtube

Last synced: 9 months ago
JSON representation

GUI application to download YouTube videos as annotated MP3 or MP4 files

• Host: GitHub
• URL: https://github.com/irahorecka/youtube2audio
• Owner: irahorecka
• License: mit
• Created: 2020-04-27T15:59:28.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2025-05-16T18:31:15.000Z (about 1 year ago)
• Last Synced: 2025-05-16T19:41:46.688Z (about 1 year ago)
• Topics: annotated-mp3-files, convert-youtube-videos, desktop-application, ffmpeg, mp3, mp4, pyqt5, video, youtube
• Language: Python
• Homepage:
• Size: 21.6 MB
• Stars: 162
• Watchers: 9
• Forks: 30
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# **youtube2audio**

![Version](https://img.shields.io/badge/version-v2024.09.26-orange)

[![Python 3.7+](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/)

[![Licence](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/irahorecka/youtube2audio/main/LICENSE)

A desktop GUI application to download YouTube videos as annotated MP3 or MP4 files.







![Application Interface](docs/youtube2audio.png)



## Using the application

Paste a YouTube playlist or video URL and load its content. Make edits to the table and click "Ask butler" (not shown in image above) to provide annotation hints to your videos. You can choose to download MP3 or MP4 files. Finally, select a download folder, download your videos, and just like that, you have nicely annotated audio files.

This application uses PyQt5 to provide the user interface and multithreading to execute calls asynchronously. The backend uses ```itunespy``` to suggest song annotations (i.e. "Ask butler"), ```pytube``` to download the YouTube video as an MP4 audio file, and FFmpeg to convert the MP4 file to MP3.

Watch the video demo for more information.



## Running the application

1) Clone GitHub repository

2) ```pip install -r requirements.txt --upgrade```

3) ```python main.py```

Check Troubleshooting if you encounter any trouble running / using the application or downloading MP3 files. If undocumented exceptions occur, please file the issue in issues.



## Troubleshooting

If the script completes instantly without downloading your video(s), you're probably experiencing an ```SSL: CERTIFICATE_VERIFY_FAIL``` exception. This fails to instantiate ```pytube.Youtube```, thus failing the download prematurely.

To troubleshoot this (if you're using macOS), go to Macintosh HD > Applications > Python3.7 folder (or whatever version of python you're using) > double click on ```Install Certificates.command``` file. This should do the trick.