KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #claude-code #codex #cli #agent-skills #ai #dsh-plugin #mcp #windows #agent

ArtistMusic

★ 35 Open GitHub ↗

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Stars](https://img.shields.io/github/stars/elevenyts/ArtistMusic?style=for-the-badge&logo=starship&logoColor=white&color=A960FF&labelColor=0D1117)](https://github.com/elevenyts/ArtistMusic)
[![Forks](https://img.shields.io/github/forks/elevenyts/ArtistMusic?style=for-the-badge&logo=git&logoColor=white&color=7C3AED&labelColor=0D1117)](https://github.com/elevenyts/ArtistMusic)
[![Issues](https://img.shields.io/github/issues/elevenyts/ArtistMusic?style=for-the-badge&logo=github&logoColor=white&color=FF6B6B&labelColor=0D1117)](https://github.com/elevenyts/ArtistMusic/issues)
[![License](https://img.shields.io/badge/License-MIT-A960FF?style=for-the-badge&logo=opensourceinitiative&logoColor=white&labelColor=0D1117)](https://raw.githubusercontent.com/elevenyts/ArtistMusic/main/LICENSE)

<br>

[![Python](https://img.shields.io/badge/Python-3.10+-3776AB?style=for-the-badge&logo=python&logoColor=white&labelColor=0D1117)](https://python.org)
[![Pyrogram](https://img.shields.io/badge/Pyrogram-Latest-A960FF?style=for-the-badge&logo=telegram&logoColor=white&labelColor=0D1117)](https://pyrogram.org)
[![MongoDB](https://img.shields.io/badge/MongoDB-Database-47A248?style=for-the-badge&logo=mongodb&logoColor=white&labelColor=0D1117)](https://mongodb.com)
[![PyTgCalls](https://img.shields.io/badge/PyTgCalls-Voice_Chat-7C3AED?style=for-the-badge&logo=telegram&logoColor=white&labelColor=0D1117)](https://pytgcalls.github.io)

<br>

[![Telegram Channel](https://img.shields.io/badge/📢_Channel-Artistbots-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white&labelColor=0D1117)](https://t.me/Artistbots)
[![Support Group](https://img.shields.io/badge/💬_Support-ArtistMusic-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white&labelColor=0D1117)](https://t.me/Elevenytschats)

</div>

<br>

```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
                   ✦  ARTISTMUSIC MUSIC BOT  ✦
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

</div>

## 📖 Table of Contents

- [Overview](#-overview)
- [Feature Showcase](#-feature-showcase)
- [Requirements](#-requirements)
- [Environment Variables](#-environment-variables)
- [Deploy](#-deploy)
- [Commands](#-commands)
- [Security](#-security)
- [Support](#-support)
- [Credits](#-credits)

<br>

## 〔 ✦ 〕 Overview

> **ArtistMusic** is a next-generation Telegram Voice Chat Music Bot engineered for performance, stability, and scale.
> Built on **Pyrogram** · **PyTgCalls** · **MongoDB** — delivering crystal-clear audio with powerful admin tooling and multi-language support across global communities.

<br>

## 〔 ✦ 〕 Feature Showcase

### 🎵 Music Streaming
```
✦ High Quality Audio Streaming
✦ YouTube Search & Play
✦ Direct URL Playback
✦ Voice Chat Streaming
✦ Live Stream Support
✦ Playlist Management
✦ Auto Queue System
✦ Continuous Playback
✦ Fast Audio Processing
```

</td>
<td width="50%">

### 🎛 Admin Controls
```
✦ Pause / Resume Stream
✦ Skip Current Track
✦ Force Play (Skip Queue)
✦ Stop Playback
✦ Mute / Unmute Assistant
✦ Volume Control
✦ Queue Cleanup
✦ Seek Forward / Backward
✦ Loop Modes
```

</td>
</tr>
<tr>
<td width="50%">

### 👥 User Management
```
✦ Authorized Users System
✦ Sudo Users Panel
✦ Global Ban System
✦ User Statistics
✦ Blacklist Chat / User
✦ Owner Controls
✦ Admin-Only Play Mode
✦ Force Admin Mode
```

</td>
<td width="50%">

### 🤖 Bot Management
```
✦ Restart Command
✦ Broadcast System
✦ Maintenance Mode
✦ Live Logs Monitor
✦ Error Reporting
✦ Auto Restart Support
✦ MongoDB Integration
✦ Multi-Language Support
```

</td>
</tr>
</table>

<br>

## 〔 ✦ 〕 Requirements

| Component | Minimum Version / Note |
|:---|:---|
| Python | 3.10 or higher |
| FFmpeg | Latest stable release |
| MongoDB | Local instance or Atlas cluster |
| RAM | 512 MB minimum (1 GB+ recommended) |
| Telegram Account | For the assistant (string session) |

<br>

## 〔 ✦ 〕 Environment Variables

```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
         Create a  .env  file with these values
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

</div>

| Variable | Required | Description |
|:---|:---:|:---|
| `API_ID` | ✅ | Telegram API ID — [my.telegram.org](https://my.telegram.org) |
| `API_HASH` | ✅ | Telegram API Hash — [my.telegram.org](https://my.telegram.org) |
| `BOT_TOKEN` | ✅ | Bot Token — [@BotFather](https://t.me/BotFather) |
| `STRING_SESSION` | ✅ | Pyrogram String Session for assistant |
| `MONGO_DB_URI` | ✅ | MongoDB connection string |
| `LOGGER_ID` | ✅ | Telegram group ID for logs |
| `OWNER_ID` | ✅ | Your Telegram user ID |
| `ARTISTBOTS_API_URL` | ⚙️ | ArtistBots API endpoint |
| `ARTISTBOTS_KEY` | ⚙️ | API key — [@ArtistApibot](https://t.me/ArtistApibot) |
| `SUPPORT_CHAT` | 🔵 | Support group link (optional) |
| `SUPPORT_CHANNEL` | 🔵 | Updates channel link (optional) |
| `START_IMG` | 🔵 | Start message image URL (optional) |
| `PING_IMG` | 🔵 | Ping message image URL (optional) |
| `STRING_SESSION2` | 🔵 | Second assistant session (optional) |
| `STRING_SESSION3` | 🔵 | Third assistant session (optional) |

> ✅ Required · ⚙️ Recommended · 🔵 Optional

<br>

## 〔 ✦ 〕 Deploy

### ☁️ One-Click Deploy

[![Deploy on Render](https://img.shields.io/badge/Deploy_on-Render-46E3B7?style=for-the-badge&logo=render&logoColor=white&labelColor=0D1117)](https://render.com)
[![Deploy on Railway](https://img.shields.io/badge/Deploy_on-Railway-7C3AED?style=for-the-badge&logo=railway&logoColor=white&labelColor=0D1117)](https://railway.app)

</div>

<br>

<details>
<summary><b>🖥 Render — Step by Step</b></summary>

<br>

**1.** Fork this repository

**2.** Go to [render.com](https://render.com) → **New Web Service**

**3.** Connect your GitHub and select this repo

**4.** Set build & start commands:

```bash
# Build Command
pip install -U -r requirements.txt

# Start Command
bash start
```

**5.** Add all environment variables from the table above

**6.** Hit **Deploy** 🚀

</details>

<details>
<summary><b>🚂 Railway — Step by Step</b></summary>

<br>

**1.** Fork this repository

**2.** Create a new project at [railway.app](https://railway.app)

**3.** Connect your GitHub repo

**4.** Add environment variables

**5.** Deploy 🚀

</details>

<br>

```bash
# Update system
apt update && apt upgrade -y

# Install dependencies
apt install python3 python3-pip ffmpeg git -y

# Clone repo
git clone https://github.com/elevenyts/ArtistMusic
cd ArtistMusic

# Install requirements
pip3 install -U -r requirements.txt

# Configure variables
cp .env.example .env
nano .env

# Run the bot
bash start
# or
python -m ArtistMusic
```

</details>

<details>
<summary><b>🐳 Docker</b></summary>

<br>

```bash
# Build the image
docker build -t artistmusic .

# Run the container (pass your .env file)
docker run -d --env-file .env --name artistmusic artistmusic
```

</details>

<br>

## 〔 ✦ 〕 Commands

**🎵 Music**
```
/play    — Play audio
/vplay   — Play video
/cplay   — Channel play
/pause   — Pause stream
/resume  — Resume stream
/skip    — Skip track
/end     — End stream
/queue   — View queue
/loop    — Loop mode
/shuffle — Shuffle queue
```

</td>
<td width="33%">

**🛡 Admin**
```
/reload   — Refresh admins
/auth     — Authorize user
/unauth   — Remove auth
/authlist — View auth list
/seek     — Seek stream
/seekback — Seek backward
/mute     — Mute assistant
/unmute   — Unmute assistant
/volume   — Set volume
/stop     — Stop playback
```

</td>
<td width="33%">

**👑 Sudo / Owner**
```
/addsudo     — Add sudo user
/delsudo     — Remove sudo
/sudolist    — List sudos
/broadcast   — Send broadcast
/gban        — Global ban
/ungban      — Global unban
/maintenance — Toggle mode
/stats       — Bot statistics
/restart     — Restart bot
/logs        — View logs
```

</td>
</tr>
</table>

<br>

## 〔 ✦ 〕 Security

```
╔══════════════════════════════════════════════════════╗
║  ✦  KEEP THESE PRIVATE — NEVER SHARE PUBLICLY  ✦    ║
╠══════════════════════════════════════════════════════╣
║  ✗  BOT_TOKEN          ✗  STRING_SESSION             ║
║  ✗  MONGO_DB_URI       ✗  API_HASH                   ║
║  ✓  Use a separate Telegram account for assistant    ║
║  ✓  Keep the logger group private                    ║
║  ✓  Bot must be admin in group & logger group        ║
╚══════════════════════════════════════════════════════╝
```

</div>

<br>

## 〔 ✦ 〕 Support

**Facing an issue? Send a screenshot to our support group.**

<br>

[![ARTIST](https://files.catbox.moe/kcnahh.png)](https://t.me/Artistbots)

<br>

</div>

<br>

## 〔 ✦ 〕 Credits

Built on the shoulders of giants:

`Pyrogram` · `PyTgCalls` · `MongoDB` · `Telegram Bot API` · `ArtistBots`

<br>

```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
         Made with ❤️  by  Artist  ·  Powered by ArtistBots
                   © 2026 ArtistMusic · MIT License
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

</div>

ArtistMusic

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README