Metadata-Version: 2.1
Name: awdible
Version: 0.2.4
Summary: Just a free version of Audible
Home-page: https://alexandregazagnes.github.io/awdible/
License: GPL-3.0
Keywords: python,music,tool,utils,youtube
Author: AlexandreGazagnes
Author-email: alex@gazagnes.net
Maintainer: AlexandreGazagnes
Maintainer-email: alex@gazagnes.net
Requires-Python: >=3.9, !=2.7.*, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*, !=3.6.*, !=3.7.*, !=3.8.*
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Other Environment
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: beautifulsoup4 (>=4.12.2,<5.0.0)
Requires-Dist: cleo (>=2.1.0,<3.0.0)
Requires-Dist: ffmpeg-python (>=0.2.0,<0.3.0)
Requires-Dist: python-dotenv (>=1.0.1,<2.0.0)
Requires-Dist: pytube (>=15.0.0,<16.0.0)
Requires-Dist: requests (>=2.31.0,<3.0.0)
Project-URL: Changelog, https://alexandregazagnes.github.io/awdible/CHANGELOG/
Project-URL: Documentation, https://alexandregazagnes.github.io/awdible/
Project-URL: Issues, https://github.com/AlexandreGazagnes/awdible/issues
Project-URL: Repository, https://github.com/AlexandreGazagnes/awdible/tree/main
Description-Content-Type: text/markdown

![image](./docs/assets/img/image.png)
[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
![Python](https://img.shields.io/badge/python-3.10.x-green.svg)
![Repo Size](https://img.shields.io/github/repo-size/AlexandreGazagnes/awdible)
[![PEP8](https://img.shields.io/badge/code%20style-pep8-orange.svg)](https://www.python.org/dev/peps/pep-0008/)
[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)
![Coverage](https://github.com/AlexandreGazagnes/awdible/blob/main/docs/assets/img/cov.svg?raw=true)
![Tests](https://github.com/AlexandreGazagnes/awdible/actions/workflows/tests.yaml/badge.svg)
![Statics](https://github.com/AlexandreGazagnes/awdible/actions/workflows/statics.yaml/badge.svg)
![Doc](https://github.com/AlexandreGazagnes/awdible/actions/workflows/docs.yaml/badge.svg)
![Pypi](https://github.com/AlexandreGazagnes/awdible/actions/workflows/publish.yaml/badge.svg)
![GitHub commit activity](https://img.shields.io/github/commit-activity/m/AlexandreGazagnes/awdible)

# Awdible

## About
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.

## Key Features

* Download music from youtube
* Convert music to mp3
* Find music from a list of songs names

## Installation

Using regular pip and venv tools :

```bash
python3 -m venv .venv
source .venv/bin/activate
pip install awdible
```

## Usage

### On line

Please visit [Awdible on Streamlit]("https://awdible.streamlit.app/") web app


### Local


As executable :

* ```awdible [youtube-url]``` standard usage

* ```awdible -o mp3 -d my/dest [youtube-url]``` standard usage

* ```awdible -f my_file.txt -o mp3 -d my/dest``` specify a file list of **youtube urls** and output format and destination folder

* ```awdible -f my_file.txt -o mp3 -s -d my/dest``` specify a file list ***song names** and output format and destination folder



As library :

```python
from awdible import Awdible
Awdible.download("https://www.youtube.com/watch?v=3y5A4paFOb4")
```

As web app :

* ```awdible gui``` : lunch local streamlit



## Documentation

Please visit [Documentation](https://alexandregazagnes.github.io/awdible/) page.


## Changelog, Roadmap and Releases

Please visit [Changelog, Roadmap and Releases](https://alexandregazagnes.github.io/awdible/CHANGELOG/) page.

## Troubleshooting

Please visit [Troubleshooting](https://alexandregazagnes.github.io/awdible/TROUBLESHOOTING/) page.


## Contributing

Please visit [Contributing](https://alexandregazagnes.github.io/awdible/CONTRIBUTING/) page.

