Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

119 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

𝗕π—₯π—’π—žπ—˜π—‘ ✘ π— π˜‚π˜€π—Άπ—°

πŸš€ Deploy for Free on Render

Follow the video tutorial below to deploy this project on Render in just a few minutes.

Watch Deployment Tutorial

β–Ά Watch Deployment Guide

𝗦𝗔𝗬 𝗑𝗒 𝗧𝗒 π—§π—›π—œπ—¦ π—˜π—₯π—₯𝗒π—₯... πŸ‘‡πŸ»

ERROR:[youtube] 
    5rOiW_xY-kc:Sign in to confirm you’re not a bot. This helps protect our community. Learn more

A high-performance, cookie-free Telegram Music Bot engineered for stability, scalability, and clean audio streaming.

Zero Browser Cookies β€’ Optimized Streaming β€’ Production-Ready Architecture


Overview

Broken ✘ Music is a professionally engineered Telegram music bot designed to operate without browser cookies, reducing account risk, avoiding session leaks, and ensuring consistent playback across cloud environments.

The project is built with long-term maintainability in mind and follows modern deployment practices suitable for VPS, Docker, and managed cloud platforms.

This repository is intended for developers, DevOps users, and Telegram bot operators who value reliability and security.


Before You Begin (Important)

  • This repository must be forked before deployment.
  • If you find this project useful, you may optionally ⭐ star the repository to support ongoing development.
  • You are responsible for complying with Telegram ToS, YouTube policies, and local laws.

Core Features

  • Cookie-free playback (no browser session dependency)
  • Custom YouTube API support
  • Stable voice chat streaming
  • Cloud-friendly (Heroku / Render / Railway / VPS / Docker)
  • Clean separation of configuration and code
  • Designed to prevent accidental credential exposure

Security & Exposure Warnings

⚠️ Read carefully before deployment

  • Never commit .env files or API keys to GitHub.
  • Do not expose your MongoDB URI, Telegram Bot Token, or Session String publicly.
  • Do not share private API endpoints or keys in public groups.
  • Rotate credentials immediately if you suspect exposure.
  • Use environment variables only β€” avoid hardcoding secrets.
  • Public forks are visible; review your fork settings carefully.

Failure to follow these practices can lead to:

  • Bot hijacking
  • Database compromise
  • API abuse
  • Permanent Telegram account limitations

Configuration (Environment Variables)

Set the following variables in your .env file or cloud dashboard:

API_ID=                  # Get from https://my.telegram.org β†’ API Development Tools
API_HASH=                # Get from https://my.telegram.org β†’ API Development Tools

BOT_TOKEN=               # Create a bot via @BotFather β†’ /newbot β†’ Copy the bot token

LOGGER_ID=               # Telegram Group where logs will be sent.
# Add @Miss_YumiPro_Bot (or any ID bot) and use /id in the group/channel.

MONGO_DB_URI=            # Create a free cluster on https://www.mongodb.com/cloud/atlas
# Database β†’ Connect β†’ Drivers β†’ Copy the MongoDB connection URI.

OWNER_ID=                # Your Telegram User ID.
# DM @Miss_YumiPro_Bot and send /id.

STRING_SESSION=          # Generate your Pyrogram V2 String Session using a trusted session generator.

API_KEY=          # Obtain from Telegram Channels @BrokenXNetwork1 or @AboutBrokenX
 

Note: GET Your API_KEY For Free From HERE


Deployment Notes DEPLOYMENT.md

  • Fork the repository before deploying.
  • Use VPS or Docker for best long-term stability.
  • Heroku / Render / Railway are supported but may have platform limitations.
  • Ensure ffmpeg is installed in all environments.

This project is designed to run continuously and should be supervised using:

  • tmux
  • systemd
  • Docker restart policies
  • For More Information Read DEPLOYMENT

Maintenance Guidelines

  • Keep dependencies updated.
  • Monitor logs regularly.
  • Avoid unnecessary plugins or unofficial patches.
  • Test changes locally before pushing to production.
  • Backup your database periodically.

Donations & Support

If this project saves you time or helps your workflow, donations are appreciated but never required.

Crypto Donation Addresses:

  • USDT (ERC-20):
    0x77fA3b4Fe38BB044bB6B6be188afEefa20102Cd5

  • Ethereum (ETH):
    0x77fA3b4Fe38BB044bB6B6be188afEefa20102Cd5

  • Bitcoin (Taproot):
    bc1p0efsee8tnfpfyh3yn37dsa0l3kqz8kxpvkcg2pw8cpudv2gqdu7se2763d

  • Bitcoin (SegWit):
    bc1qg5cu2nw6xurn0yrnkkggdh3n33nwmau9l0enrx

  • USDT (TRON):
    TLubBHjRNvgudX8Y4PwMrR5sKm1ohV9cxB

  • TON:
    UQAMQuNzshrJc2k1yC58St3J8wGnhiDMNrLxyc55Nu8bFfyi


Disclaimer

This project is provided as-is, without warranty of any kind.
The author is not responsible for misuse, policy violations, or damages resulting from deployment or modification.

By using this software, you agree that you are solely responsible for how it is operated.


Β© 2025 Broken ✘ Network β€” All Rights Reserved

About

π—”π——π—©π—”π—‘π—–π—˜π—— π— π—¨π—Ÿπ—§π—œπ—™π—¨π—‘π—–π—§π—œπ—’π—‘ π—§π—˜π—Ÿπ—˜π—šπ—₯𝗔𝗠 π— π—¨π—¦π—œπ—– 𝗕𝗒𝗧 π—ͺπ—œπ—§π—›π—’π—¨π—§ π—–π—’π—’π—žπ—œπ—˜π—¦ 𝗔𝗑𝗗 π—¬π—’π—¨π—§π—¨π—•π—˜ π—œπ—£ 𝗕𝗔𝗑 𝗒π—₯ 𝗬𝗧 π——π—Ÿπ—£ π—˜π—₯π—₯𝗒π—₯

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages