Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kernoeb/Telegramusic
Python Telegram Bot to download music from Deezer and YouTube (Heroku, Docker)
https://github.com/kernoeb/Telegramusic
bot deezer deezer-api docker heroku python python3 telegram telegram-bot youtube youtube-dl
Last synced: 3 months ago
JSON representation
Python Telegram Bot to download music from Deezer and YouTube (Heroku, Docker)
- Host: GitHub
- URL: https://github.com/kernoeb/Telegramusic
- Owner: kernoeb
- License: mpl-2.0
- Created: 2020-09-27T08:46:52.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2024-08-01T21:32:13.000Z (3 months ago)
- Last Synced: 2024-08-01T23:00:33.043Z (3 months ago)
- Topics: bot, deezer, deezer-api, docker, heroku, python, python3, telegram, telegram-bot, youtube, youtube-dl
- Language: Python
- Homepage:
- Size: 62.5 KB
- Stars: 67
- Watchers: 5
- Forks: 49
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
Telegramusic
A Telegram bot to download music from Deezer and YouTube
## Disclaimer
:warning: For educational purposes only (or for free music)
Please don't use this for illegal stuff.
It's **against Deezer's terms of service**.
## Information
You should probably use Docker way to install the bot, or follow the steps listed in the Dockerfile.
As indicated in the Dockerfile there's a temporary patch to avoid the "FLAC issue" from the deezer download library.
## Translations
Your native language is not in the `langs.json` file ? Just make a pull request or pm me !
## Usage
- Get an `arl` cookie on Deezer for `DEEZER_TOKEN` (see [this repo](https://github.com/nathom/streamrip/wiki/Finding-Your-Deezer-ARL-Cookie))
- Create a bot on Telegram and grab a token with [Bot Father](https://t.me/botfather) (`TELEGRAM_TOKEN`)
- Activate `Inline Mode` on BotFather for the bot you just created
----
Search for music in `inline mode` :
```
@xxxxxxx_bot (album|track|artist)
```
or send a Deezer / YouTube link
----
## Configuration
### Docker
#### Prerequisites
- Docker ([Linux installation](https://docs.docker.com/engine/install/ubuntu/) and [Linux post-installation steps](https://docs.docker.com/engine/install/linux-postinstall/))
- Docker compose (should be included in the Docker installation)
Create a `token.env` file with the following content, replacing the values with your own tokens :
```
DEEZER_TOKEN=abcdefghijklmnoxxxxxxxxxxxx
TELEGRAM_TOKEN=123456789:ABCDEFGHIJKLMNOPQRSTUVWXYZ
BOT_LANG=fr
```
If you need to add `cookies` for YouTube, add the following line :
> "Sign in to confirm you’re not a bot. This helps protect our community. Learn more."
> Please note that your account may be banned if you use this feature.
```
COOKIES_PATH=/path/to/cookies.txt
```
Then run :
```bash
./update.sh
```
or directly :
```bash
git pull && docker-compose up -d --build
```
### Local usage
- Add `DEEZER_TOKEN` and `TELEGRAM_TOKEN` as variable environment
- python3.9 -m pip install -r requirements.txt
- python3.9 main.py
(You should use a `venv`)