Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/AlexandreGazagnes/awdible
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.
https://github.com/AlexandreGazagnes/awdible
api audio beginner-friendly downloader learning learning-by-doing mp3 python scraper scraping streamlit tool video youtube youtube-api youtube-dl youtube-downloader
Last synced: 3 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/AlexandreGazagnes/awdible
- Owner: AlexandreGazagnes
- License: gpl-3.0
- Created: 2024-01-09T08:43:10.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-04-28T12:03:56.000Z (7 months ago)
- Last Synced: 2024-07-24T07:47:10.192Z (4 months ago)
- Topics: api, audio, beginner-friendly, downloader, learning, learning-by-doing, mp3, python, scraper, scraping, streamlit, tool, video, youtube, youtube-api, youtube-dl, youtube-downloader
- Language: Python
- Homepage: https://alexandregazagnes.github.io/awdible/
- Size: 5.51 MB
- Stars: 7
- Watchers: 4
- Forks: 4
- Open Issues: 25
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
[](https://www.gnu.org/licenses/gpl-3.0)
[](https://www.python.org/dev/peps/pep-0008/)
[](https://python-poetry.org/)
# Awdible - Just the best free version of audible
## About
Awdible is a free and open-source software, app and python package that allows you to download music from youtube and convert it to mp3.
The idea is to provide a free version of audible.
## Key Features
* Download music / audiobook from youtube
* Convert music / audiobook to mp3 / wave / flac (...) *need ffmpeg installed*
* Automaticly crop a long audio file to a specific duration ie 60 minutes
* Find music / audiobook from a list of songs / audiobook names : Waka Waka, Happy, Harry potter and the philosopher's stone, (...) *need specific api keys*
* Add specfic context about a file such as live, album, or title
## Installation
Using regular pip and venv tools :
```bash
python3 -m venv .venv
source .venv/bin/activate
pip install awdible
```
## Third party dependencies
### FFmpeg
Please note that you should to have [ffmpeg](https://ffmpeg.org/) installed on your system to use certain features of Awdible.
On Ubuntu, Debian, Linux Mint (...) you can install it with the following command :
```bash
sudo apt update
sudo apt install ffmpeg -y
```
On fedora, Red Hat, CentOS (...) you can install it with the following command :
```bash
sudo dnf install ffmpeg
```
On MacOs, you can install it with the following command :
```bash
brew install ffmpeg
```
Please check that the ffmpeg command is available in your terminal.
```bash
ffmpeg -version
```
If you have any issues with ffmpeg, please visit the [ffmpeg](https://ffmpeg.org/) website.
**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.
### External api
Some features of Awdible require external api keys, specially the `-s` option.
you must have a set up your **[youtube rapid api](https://rapidapi.com/herosAPI/api/youtube-data8)** account.
You need to add in your environment variables or export directly from a terminal the following :
```bash
export RAPID_API_KEY="*********"
export RAPID_API_HOST="youtube-data8.p.rapidapi.com"
```
### Internet connection
Last but not least, Please not that a valid internet connection is required to use ```Awdible```.
## Usage
### Local
#### As executable
Standard usage, download and convert to mp3 :
```shell
awdible [youtube-url]
```
Specify a destination folder :
```shell
awdible -d my/dest [youtube-url]
```
Specify a file list song / audibooks **urls** and specify destination folder :
```shell
awdible -f my_file.txt -d my/dest
```
The my_file.txt file must contain one youtube url per line.
my_file.txt example :
```
https://www.youtube.com/watch?v=3y5A4paFOb4
https://www.youtube.com/watch?v=3y5A4paFOb4
https://www.youtube.com/watch?v=3y5A4paFOb4
```
Specify a file list song / audibooks **ids** and specify destination folder :
```shell
awdible -f my_file.txt -d my/dest -p
```
The my_file.txt file must contain one youtube id per line.
my_file.txt example :
```shell
3y5A4paFOb4
3y5A4paFOb4
3y5A4paFOb4
```
Specify a file list song / audiooks **names** (not just yourube url) and specify destination folder :
```shell
awdible -f my_file.txt -s -d my/dest
```
The my_file.txt file must contain one youtube id per line.
my_file.txt example :
```shell
waka waka shakira
Stand by me
Somewhere over the rainbow
```
⚠️ **WARNING** ⚠️
Please note that for the `-s` option, you must have a set up your **[youtube rapid api](https://rapidapi.com/herosAPI/api/youtube-data8)** account.
You need to add in your environment variables or export directly from a terminal the following :
```bash
export RAPID_API_KEY="*********"
export RAPID_API_HOST="youtube-data8.p.rapidapi.com"
```
#### As library
```python
from awdible import Awdible
url = "https://www.youtube.com/watch?v=3y5A4paFOb4"
awdible = Awdible(url)
awdible.run()
# or
urls = [
"https://www.youtube.com/watch?v=3y5A4paFOb4",
"https://www.youtube.com/watch?v=3y5A4paFOb4",
"https://www.youtube.com/watch?v=3y5A4paFOb4"
]
awdible = Awdible(urls)
awdible.run()
```
#### As web app
Launch local streamlit :
```shell
awdible gui
```
### On line
The on line web app is temporarily unavailable.
It will be available in the `0.3.0` release.
## Documentation
Please visit [Documentation](https://alexandregazagnes.github.io/awdible/) page.
## Updates
Please visit the :
* [Changelog](https://alexandregazagnes.github.io/awdible/changelog) page
* [Roadmap](https://github.com/AlexandreGazagnes/awdible/projects?query=is%3Aopen) page
* [Release](https://github.com/AlexandreGazagnes/awdible/releases) page
* [Issues](https://github.com/AlexandreGazagnes/awdible/issues) page
## Contributing
Awdible is an open-source project and we are always looking for more people to contribute to its development.
It could be by adding new features, fixing bugs, improving the documentation, or any other way you see fit.
Any help is welcome, and we will do our best to help you get started.
Any feedback is also welcome.
Please visit [Contributing](https://alexandregazagnes.github.io/awdible/contributing/) page.