{"id":31942273,"url":"https://github.com/irahorecka/youtube2audio","last_synced_at":"2025-10-14T09:41:45.565Z","repository":{"id":50160100,"uuid":"259381546","full_name":"irahorecka/youtube2audio","owner":"irahorecka","description":"GUI application to download YouTube videos as annotated MP3 or MP4 files","archived":false,"fork":false,"pushed_at":"2025-05-16T18:31:15.000Z","size":22669,"stargazers_count":162,"open_issues_count":3,"forks_count":30,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-05-16T19:41:46.688Z","etag":null,"topics":["annotated-mp3-files","convert-youtube-videos","desktop-application","ffmpeg","mp3","mp4","pyqt5","video","youtube"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/irahorecka.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,"zenodo":null}},"created_at":"2020-04-27T15:59:28.000Z","updated_at":"2025-05-16T18:31:18.000Z","dependencies_parsed_at":"2023-01-31T20:01:44.782Z","dependency_job_id":"aea41d2f-9738-420e-bc28-e64a302d65f5","html_url":"https://github.com/irahorecka/youtube2audio","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/irahorecka/youtube2audio","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/irahorecka%2Fyoutube2audio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/irahorecka%2Fyoutube2audio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/irahorecka%2Fyoutube2audio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/irahorecka%2Fyoutube2audio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/irahorecka","download_url":"https://codeload.github.com/irahorecka/youtube2audio/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/irahorecka%2Fyoutube2audio/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279018626,"owners_count":26086404,"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","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["annotated-mp3-files","convert-youtube-videos","desktop-application","ffmpeg","mp3","mp4","pyqt5","video","youtube"],"created_at":"2025-10-14T09:41:40.639Z","updated_at":"2025-10-14T09:41:45.558Z","avatar_url":"https://github.com/irahorecka.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **youtube2audio**\n\n![Version](https://img.shields.io/badge/version-v2024.09.26-orange)\n[![Python 3.7+](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/)\n[![Licence](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/irahorecka/youtube2audio/main/LICENSE)\n\nA desktop GUI application to download YouTube videos as annotated MP3 or MP4 files.\n\u003cbr\u003e\n\u003cbr\u003e\n![Application Interface](docs/youtube2audio.png)\n\u003chr\u003e\n\n## Using the application\n\nPaste 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.\n\nThis 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.\n\nWatch the \u003ca href=\"https://i.imgur.com/6gAdznH.mp4\"\u003evideo demo\u003c/a\u003e for more information.\n\u003chr\u003e\n\n## Running the application\n\n1) Clone GitHub repository\n2) ```pip install -r requirements.txt --upgrade```\n3) ```python main.py```\n\nCheck \u003cb\u003eTroubleshooting\u003c/b\u003e if you encounter any trouble running / using the application or downloading MP3 files. If undocumented exceptions occur, please file the issue in \u003ca href=\"https://github.com/irahorecka/YouTube2Audio/issues\"\u003eissues\u003c/a\u003e.\n\u003chr\u003e\n\n## Troubleshooting\n\nIf 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.\n\nTo troubleshoot this (if you're using macOS), go to Macintosh HD \u003e Applications \u003e Python3.7 folder (or whatever version of python you're using) \u003e double click on ```Install Certificates.command``` file. This should do the trick.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Firahorecka%2Fyoutube2audio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Firahorecka%2Fyoutube2audio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Firahorecka%2Fyoutube2audio/lists"}