e6akl4k

            ░██████             ░██       ░██    ░████   ░██
           ░██   ░██            ░██       ░██   ░██ ██   ░██
 ░███████  ░██        ░██████   ░██    ░██░██  ░██  ██   ░██    ░██
░██    ░██ ░███████        ░██  ░██   ░██ ░██ ░██   ██   ░██   ░██
░█████████ ░██   ░██  ░███████  ░███████  ░██ ░█████████ ░███████
░██        ░██   ░██ ░██   ░██  ░██   ░██ ░██      ░██   ░██   ░██
 ░███████   ░██████   ░█████░██ ░██    ░██░██      ░██   ░██    ░██

A self-hosted Telegram bot for downloading music from streaming services

English | Русский

English

e6akl4k is a self-hosted Telegram bot for finding and downloading music. Send it a song name or a link, choose the format, and receive the finished audio directly in Telegram.

Title searches use YouTube. Supported audio links, including Newgrounds tracks, are downloaded directly from their source. It also supports albums, playlists, inline search, MP3, FLAC, M4A, OGG, download history, Telegram file caching, tracklist and cover export, and last.fm lists. Spotify, Apple Music, Deezer, Tidal, and Yandex Music links are used as search hints rather than direct audio sources.

Send a voice message with 5–20 seconds of music playing to recognize it through Shazam and receive the full song as MP3 320. Recordings of 3–60 seconds up to 2 MiB are accepted in private chat. An uncertain YouTube match is offered for selection. Docker includes recognition support; native setup uses Python and requirements-shazam.txt, with no Shazam API key.

For Newgrounds, send an audio page such as https://www.newgrounds.com/audio/listen/549479 and choose the format. Public audio tracks need no extra configuration or API key; title search still uses YouTube.

Try the public bot: @e6akl4k_bot

Host your own instance

Use a Debian or Ubuntu server with root or sudo access:

Create a Telegram bot with @BotFather and copy its token.
Clone and deploy the project:

git clone https://github.com/v0dol4zik/e6akl4k.git
cd e6akl4k
chmod +x bootstrap.sh deploy.sh rollback.sh
BOT_TOKEN='your-bot-token' ./bootstrap.sh
./deploy.sh

bootstrap.sh installs Docker and prepares persistent storage. YouTube may require a Netscape-format cookies file on VPS hosts; pass it during setup with COOKIES_FILE=/path/to/cookies.txt.

To update the bot later:

git pull --ff-only origin main
./deploy.sh

Русский

e6akl4k — self-hosted Telegram-бот для поиска и скачивания музыки. Отправь ему название песни или ссылку, выбери формат и получи готовый аудиофайл прямо в Telegram.

Поиск по названию работает через YouTube. Поддерживаемые аудиоссылки, включая треки Newgrounds, скачиваются напрямую с исходного сервиса. Он также поддерживает альбомы, плейлисты, inline-поиск, MP3, FLAC, M4A, OGG, историю загрузок, Telegram-кэш, экспорт треклистов и обложек и списки last.fm. Ссылки Spotify, Apple Music, Deezer, Tidal и Яндекс Музыки используются как подсказки для поиска, а не как прямые источники аудио.

Отправь в личный чат голосовое с 5–20 секундами звучащей музыки: бот распознает песню через Shazam и пришлёт полный трек в MP3 320. Принимаются записи от 3 до 60 секунд размером до 2 МиБ. Если совпадение на YouTube сомнительное, бот предложит выбрать версию. В Docker всё уже установлено; для нативного запуска нужны Python и requirements-shazam.txt, ключ Shazam не требуется.

Для Newgrounds пришли страницу аудиотрека, например https://www.newgrounds.com/audio/listen/549479, и выбери формат. Для публичных треков не нужны дополнительные настройки или API-ключ; поиск по названию по-прежнему работает через YouTube.

Попробовать публичного бота: @e6akl4k_bot

Как захостить свой инстанс

Нужен сервер с Debian или Ubuntu и доступом root или sudo:

Создай Telegram-бота через @BotFather и скопируй его токен.
Склонируй и разверни проект:

git clone https://github.com/v0dol4zik/e6akl4k.git
cd e6akl4k
chmod +x bootstrap.sh deploy.sh rollback.sh
BOT_TOKEN='токен-твоего-бота' ./bootstrap.sh
./deploy.sh

bootstrap.sh установит Docker и подготовит постоянное хранилище. На VPS YouTube может потребовать cookies в формате Netscape; их можно передать при установке через COOKIES_FILE=/путь/к/cookies.txt.

Для последующего обновления:

git pull --ff-only origin main
./deploy.sh

Name		Name	Last commit message	Last commit date
assets		assets
docs		docs
.dockerignore		.dockerignore
.env.example		.env.example
.gitattributes		.gitattributes
.gitignore		.gitignore
.gitlab-ci.yml		.gitlab-ci.yml
CHANGELOG.md		CHANGELOG.md
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
admin.go		admin.go
admin_test.go		admin_test.go
app_state.go		app_state.go
archive.go		archive.go
bootstrap.sh		bootstrap.sh
bot_ui.go		bot_ui.go
bot_ui_test.go		bot_ui_test.go
buildinfo.go		buildinfo.go
config.go		config.go
config_test.go		config_test.go
cookie_alert.go		cookie_alert.go
cookie_alert_test.go		cookie_alert_test.go
cookie_check.go		cookie_check.go
cookie_check_test.go		cookie_check_test.go
cover.go		cover.go
deploy.sh		deploy.sh
disk_budget.go		disk_budget.go
disk_budget_test.go		disk_budget_test.go
docker-compose.yml		docker-compose.yml
download_trace.go		download_trace.go
downloader.go		downloader.go
downloader_test.go		downloader_test.go
error_digest.go		error_digest.go
error_report.go		error_report.go
error_report_actions.go		error_report_actions.go
error_report_actions_test.go		error_report_actions_test.go
error_report_store.go		error_report_store.go
error_report_test.go		error_report_test.go
export.go		export.go
export_sources.go		export_sources.go
export_test.go		export_test.go
go.mod		go.mod
go.sum		go.sum
health.go		health.go
health_test.go		health_test.go
inline.go		inline.go
inline_handlers.go		inline_handlers.go
inline_test.go		inline_test.go
lastfm.go		lastfm.go
lastfm_test.go		lastfm_test.go
locales.go		locales.go
locales_test.go		locales_test.go
main.go		main.go
main_test.go		main_test.go
media_metrics.go		media_metrics.go
newgrounds.go		newgrounds.go
newgrounds_extractor.py		newgrounds_extractor.py
newgrounds_guard_test.go		newgrounds_guard_test.go
newgrounds_test.go		newgrounds_test.go
notify.go		notify.go
notify_test.go		notify_test.go
playlist_pipeline_test.go		playlist_pipeline_test.go
recognition.go		recognition.go
recognition_test.go		recognition_test.go
requirements-shazam.txt		requirements-shazam.txt
resolver.go		resolver.go
rollback.sh		rollback.sh
runtime.go		runtime.go
scheduler.go		scheduler.go
scheduler_test.go		scheduler_test.go
search_rank.go		search_rank.go
search_rank_test.go		search_rank_test.go
shazam.go		shazam.go
shazam_recognize.py		shazam_recognize.py
shazam_test.go		shazam_test.go
size_limit.go		size_limit.go
size_limit_test.go		size_limit_test.go
status_monitor.go		status_monitor.go
status_monitor_test.go		status_monitor_test.go
store.go		store.go
store_test.go		store_test.go
support_notice.go		support_notice.go
support_notice_test.go		support_notice_test.go
telegram_client.go		telegram_client.go
telegram_client_test.go		telegram_client_test.go
telegram_server.go		telegram_server.go
telegram_server_test.go		telegram_server_test.go
tracklist.go		tracklist.go
tracklist_test.go		tracklist_test.go
update_dispatcher.go		update_dispatcher.go
update_dispatcher_test.go		update_dispatcher_test.go
upload_progress.go		upload_progress.go
upload_progress_test.go		upload_progress_test.go
workflows.go		workflows.go
workflows_test.go		workflows_test.go
yandex-relay.example.json		yandex-relay.example.json

Navigation Menu

Repository navigation

About

Repository files navigation

e6akl4k

A self-hosted Telegram bot for downloading music from streaming services

English

Host your own instance

Русский

Как захостить свой инстанс

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

e6akl4k

A self-hosted Telegram bot for downloading music from streaming services

English

Host your own instance

Русский

Как захостить свой инстанс

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages