{"id":13824948,"url":"https://github.com/AlexandreGazagnes/awdible","last_synced_at":"2025-07-08T20:32:36.475Z","repository":{"id":216264139,"uuid":"740873433","full_name":"AlexandreGazagnes/awdible","owner":"AlexandreGazagnes","description":"Awdible - Just the best free version of audible. Awdible is a free and open-source software that allows you to download music from youtube and convert it to mp3.  The idea is to provide a free version of awdible.","archived":false,"fork":false,"pushed_at":"2024-04-28T12:03:56.000Z","size":5782,"stargazers_count":7,"open_issues_count":25,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-06-17T15:04:02.796Z","etag":null,"topics":["api","audio","beginner-friendly","downloader","learning","learning-by-doing","mp3","python","scraper","scraping","streamlit","tool","video","youtube","youtube-api","youtube-dl","youtube-downloader"],"latest_commit_sha":null,"homepage":"https://alexandregazagnes.github.io/awdible/","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/AlexandreGazagnes.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","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},"funding":{"github":null,"patreon":"AlexandreGazagnes"}},"created_at":"2024-01-09T08:43:10.000Z","updated_at":"2024-07-01T12:02:07.000Z","dependencies_parsed_at":"2024-01-09T09:48:52.627Z","dependency_job_id":"60fbe544-a859-4372-991f-ec0cd4328d51","html_url":"https://github.com/AlexandreGazagnes/awdible","commit_stats":null,"previous_names":["alexandregazagnes/audible","alexandregazagnes/awdible"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/AlexandreGazagnes/awdible","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexandreGazagnes%2Fawdible","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexandreGazagnes%2Fawdible/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexandreGazagnes%2Fawdible/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexandreGazagnes%2Fawdible/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlexandreGazagnes","download_url":"https://codeload.github.com/AlexandreGazagnes/awdible/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlexandreGazagnes%2Fawdible/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264343772,"owners_count":23593788,"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":["api","audio","beginner-friendly","downloader","learning","learning-by-doing","mp3","python","scraper","scraping","streamlit","tool","video","youtube","youtube-api","youtube-dl","youtube-downloader"],"created_at":"2024-08-04T09:01:12.438Z","updated_at":"2025-07-08T20:32:34.035Z","avatar_url":"https://github.com/AlexandreGazagnes.png","language":"Python","funding_links":["https://patreon.com/AlexandreGazagnes"],"categories":["Python"],"sub_categories":[],"readme":"![image](https://github.com/AlexandreGazagnes/awdible/blob/main/docs/assets/img/image.png?raw=true)\n[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n![Python](https://img.shields.io/badge/python-3.10.x-green.svg)\n![Repo Size](https://img.shields.io/github/repo-size/AlexandreGazagnes/awdible)\n[![PEP8](https://img.shields.io/badge/code%20style-pep8-orange.svg)](https://www.python.org/dev/peps/pep-0008/)\n[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)\n\u003c!-- ![Coverage](https://github.com/AlexandreGazagnes/awdible/blob/main/docs/assets/img/cov.svg?raw=true) --\u003e\n![Tests](https://github.com/AlexandreGazagnes/awdible/actions/workflows/tests.yaml/badge.svg)\n![Statics](https://github.com/AlexandreGazagnes/awdible/actions/workflows/statics.yaml/badge.svg)\n![Doc](https://github.com/AlexandreGazagnes/awdible/actions/workflows/docs.yaml/badge.svg)\n\u003c!-- ![Pypi](https://github.com/AlexandreGazagnes/awdible/actions/workflows/publish.yaml/badge.svg) --\u003e\n![GitHub commit activity](https://img.shields.io/github/commit-activity/m/AlexandreGazagnes/awdible)\n\n# Awdible - Just the best free version of audible\n\n## About\nAwdible is a free and open-source software, app and python package that allows you to download music from youtube and convert it to mp3.\n\nThe idea is to provide a free version of audible.\n\n## Key Features\n\n* Download music / audiobook from youtube\n* Convert music / audiobook to mp3 / wave / flac (...) *need ffmpeg installed*\n* Automaticly crop a long audio file to a specific duration ie 60 minutes\n* Find music / audiobook from a list of songs / audiobook names : Waka Waka, Happy, Harry potter and the philosopher's stone, (...) *need specific api keys*\n* Add specfic context about a file such as live, album, or title\n\n\n## Installation\n\nUsing regular pip and venv tools :\n\n```bash\npython3 -m venv .venv\nsource .venv/bin/activate\npip install awdible\n```\n\n\n## Third party dependencies\n\n### FFmpeg\n\nPlease note that you should to have [ffmpeg](https://ffmpeg.org/) installed on your system to use certain features of Awdible.\n\nOn Ubuntu, Debian, Linux Mint (...) you can install it with the following command :\n```bash\nsudo apt update\nsudo apt install ffmpeg -y \n```\n\nOn fedora, Red Hat, CentOS (...) you can install it with the following command :\n```bash\nsudo dnf install ffmpeg\n```\n\nOn MacOs, you can install it with the following command :\n```bash\nbrew install ffmpeg\n```\n\nPlease check that the ffmpeg command is available in your terminal.\n\n```bash\nffmpeg -version\n```\n\nIf you have any issues with ffmpeg, please visit the [ffmpeg](https://ffmpeg.org/) website.\n\n**It is possible not to have ffmpeg installed** but in such case, you will not be able to convert the downloaded files to mp3, wave, flac, etc.\n\n### External api\n\nSome features of Awdible require external api keys, specially the `-s` option.\n\n\nyou must have a set up your **[youtube rapid api](https://rapidapi.com/herosAPI/api/youtube-data8)** account. \n\nYou need to add in your environment variables or export directly from a terminal the following :\n\n```bash\nexport RAPID_API_KEY=\"*********\"\nexport RAPID_API_HOST=\"youtube-data8.p.rapidapi.com\"\n```\n\n### Internet connection\n\nLast but not least, Please not that a valid internet connection is required to use ```Awdible```.\n\n\n## Usage\n\n\n### Local\n\n\n\n#### As executable\n\n\nStandard usage, download and convert to mp3 :\n\n```shell\nawdible [youtube-url] \n``` \n\nSpecify a destination folder : \n```shell\nawdible -d my/dest [youtube-url]\n``` \nSpecify a file list song  / audibooks **urls** and specify destination folder : \n```shell\nawdible -f my_file.txt -d my/dest\n``` \n\nThe my_file.txt file must contain one youtube url per line.\nmy_file.txt example :\n```\nhttps://www.youtube.com/watch?v=3y5A4paFOb4\nhttps://www.youtube.com/watch?v=3y5A4paFOb4\nhttps://www.youtube.com/watch?v=3y5A4paFOb4\n```\nSpecify a file list song  / audibooks **ids** and specify destination folder : \n```shell\nawdible -f my_file.txt -d my/dest -p\n``` \nThe my_file.txt file must contain one youtube id per line.\nmy_file.txt example :\n```shell\n3y5A4paFOb4\n3y5A4paFOb4\n3y5A4paFOb4\n```\nSpecify a file list song / audiooks **names** (not just yourube url) and specify destination folder :\n```shell\nawdible -f my_file.txt -s -d my/dest\n``` \n\nThe my_file.txt file must contain one youtube id per line.\nmy_file.txt example :\n```shell\nwaka waka shakira\nStand by me\nSomewhere over the rainbow\n```\n\n⚠️ **WARNING** ⚠️\n\nPlease note that for the `-s` option, you must have a set up your **[youtube rapid api](https://rapidapi.com/herosAPI/api/youtube-data8)** account. \n\nYou need to add in your environment variables or export directly from a terminal the following :\n\n```bash\nexport RAPID_API_KEY=\"*********\"\nexport RAPID_API_HOST=\"youtube-data8.p.rapidapi.com\"\n```\n\n\n#### As library\n\n\n```python\nfrom awdible import Awdible\n\nurl = \"https://www.youtube.com/watch?v=3y5A4paFOb4\"\nawdible = Awdible(url)\nawdible.run()\n\n# or\n\nurls = [\n    \"https://www.youtube.com/watch?v=3y5A4paFOb4\",\n    \"https://www.youtube.com/watch?v=3y5A4paFOb4\",\n    \"https://www.youtube.com/watch?v=3y5A4paFOb4\"\n    ]\n\nawdible = Awdible(urls)\nawdible.run()\n```\n\n#### As web app\n\nLaunch local streamlit : \n\n```shell\nawdible gui \n``` \n\n### On line\n\nThe on line web app is temporarily unavailable. \n\nIt will be available in the `0.3.0` release.\n\n\n## Documentation\n\nPlease visit [Documentation](https://alexandregazagnes.github.io/awdible/) page.\n\n\n## Updates\n\n\nPlease visit the : \n* [Changelog](https://alexandregazagnes.github.io/awdible/changelog) page \n* [Roadmap](https://github.com/AlexandreGazagnes/awdible/projects?query=is%3Aopen) page\n* [Release](https://github.com/AlexandreGazagnes/awdible/releases) page\n* [Issues](https://github.com/AlexandreGazagnes/awdible/issues) page\n\n\n\n## Contributing\n\nAwdible is an open-source project and we are always looking for more people to contribute to its development.\n\nIt could be by adding new features, fixing bugs, improving the documentation, or any other way you see fit.\n\nAny help is welcome, and we will do our best to help you get started.\n\nAny feedback is also welcome.\n\nPlease visit [Contributing](https://alexandregazagnes.github.io/awdible/contributing/) page.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAlexandreGazagnes%2Fawdible","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FAlexandreGazagnes%2Fawdible","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FAlexandreGazagnes%2Fawdible/lists"}