# Makie — AI-Powered Music Bot


## English

**Makie** is a next-generation Discord music bot that combines AI technology with a multi-bot pool system, ensuring your server always has music playing without worrying about bot availability.

### Key Features

#### Music Playback
- Play music from YouTube, Spotify, SoundCloud, and more via Lavalink
- Full queue management: skip, shuffle, loop (song/queue), volume control
- Beautiful Now Playing cards rendered with custom canvas UI

#### AI Autoplay — Never Run Out of Music
- When the queue ends, AI automatically analyzes your listening vibe and queues the next track
- Powered by Gemini AI to find songs that match your taste
- Toggle easily with `!autoplay on/off`

#### AI Lyrics & Song Finder
- Search and display song lyrics with `!lyrics`
- Realtime Lyrics — synced lyrics that follow along with the currently playing track
- Find a song from just a few words of its lyrics with `!ifind`

#### 24/7 Mode
- Bot stays in your voice channel around the clock, auto-reconnects after restarts
- Combined with Autoplay — music never stops

#### Smart Recommendations
- `!dexuat` — AI analyzes the current track and suggests similar songs
- Add recommended songs to queue with just one button click

#### Multi-Bot Pool — Serve Multiple Channels at Once
- Automatic bot assignment per voice channel
- Multiple voice groups in one server can listen to music simultaneously
- Smart error handling: clear messages when bots are busy or unavailable

#### Stats & Profile
- Community leaderboard of the hottest tracks with `!top`
- Personal profile: total listens, friends who listen together, favorite tracks

#### Kawaii Canvas UI
- Every response is rendered as a custom-designed canvas image
- Clean, readable fonts with cute pastel aesthetic
- Built-in pagination for long content — no more wall-of-text embeds

#### Multi-Language
- Supports Vietnamese and English
- Customize language per server or per user

### Commands

| Command | Description |
|---------|-------------|
| `!play <name/URL>` | Play a song |
| `!skip` | Skip current track |
| `!queue` | View the queue |
| `!nowplaying` | Show what's playing |
| `!pause` / `!resume` | Pause or resume playback |
| `!loop song/queue/off` | Set loop mode |
| `!shuffle` | Shuffle the queue |
| `!volume <0-200>` | Adjust volume |
| `!stop` | Stop and clear queue |
| `!leave` | Disconnect from voice |
| `!autoplay on/off` | Toggle AI autoplay |
| `!lyrics <song>` | Search song lyrics |
| `!ifind <lyrics>` | Find song by lyrics |
| `!dexuat` | AI song recommendations |
| `!247 on/off` | Toggle 24/7 mode |
| `!top` | Community top tracks |
| `!profile` | Your listening profile |
| `!setprefix <prefix>` | Change server prefix |
| `!setlang vi/en` | Change language |
| `!help` | List all commands |

### Why Makie?
- **AI-Powered** — Doesn't just play music, understands your taste
- **Reliable** — Split-process architecture with auto-recovery
- **Beautiful** — Kawaii canvas UI, not boring text embeds
- **Scalable** — Multi-bot pool serves multiple voice channels at once

---

## Tiếng Việt

**Makie** là bot nghe nhạc Discord thế hệ mới, kết hợp công nghệ AI và hệ thống multi-bot pool giúp server của bạn luôn có nhạc mà không lo bot bận.

### Tính năng chính

#### Nghe nhạc chất lượng cao
- Phát nhạc từ YouTube, Spotify, SoundCloud và nhiều nguồn khác qua Lavalink
- Hàng đợi nhạc, lặp bài/lặp queue, trộn bài, chỉnh âm lượng
- Hiển thị Now Playing đẹp mắt với giao diện canvas riêng

#### AI Autoplay — Không bao giờ hết nhạc
- Khi hết bài trong queue, AI tự động phân tích vibe phiên nghe và đề xuất bài tiếp theo
- Sử dụng Gemini AI để tìm bài phù hợp nhất với gu nhạc của bạn
- Bật/tắt dễ dàng với `!autoplay on/off`

#### AI Lyrics & Tìm bài hát
- Tìm và hiển thị lời bài hát với `!lyrics`
- Realtime Lyrics — lời bài hát chạy theo nhạc đang phát
- Tìm bài hát bằng 1 đoạn lời với `!ifind`

#### Chế độ 24/7
- Bot ở lại voice channel 24/7, tự động kết nối lại khi server restart
- Kết hợp Autoplay — luôn có nhạc phát trong channel

#### Đề xuất thông minh
- `!dexuat` — AI phân tích bài đang phát và gợi ý bài tương tự
- Thêm bài gợi ý vào queue chỉ bằng 1 nút bấm

#### Multi-Bot Pool — Phục vụ nhiều kênh cùng lúc
- Hệ thống tự động phân bổ bot cho từng voice channel
- Nhiều nhóm voice trong 1 server có thể nghe nhạc đồng thời
- Thông báo rõ ràng khi bot bận hoặc chưa được mời

#### Thống kê & Profile
- Bảng xếp hạng bài hát hot nhất cộng đồng với `!top`
- Profile cá nhân: tổng số bài đã nghe, bạn bè nghe cùng, bài yêu thích

#### Giao diện Canvas Kawaii
- Mọi response đều hiển thị bằng hình ảnh canvas thiết kế riêng
- Font chữ dễ đọc, phong cách pastel dễ thương
- Hỗ trợ phân trang cho nội dung dài

#### Đa ngôn ngữ
- Hỗ trợ Tiếng Việt và English
- Tùy chỉnh ngôn ngữ cho từng server hoặc từng người dùng

### Danh sách lệnh

| Lệnh | Mô tả |
|-------|--------|
| `!play <tên/URL>` | Phát nhạc |
| `!skip` | Bỏ qua bài hiện tại |
| `!queue` | Xem hàng đợi |
| `!nowplaying` | Xem bài đang phát |
| `!pause` / `!resume` | Tạm dừng / Tiếp tục |
| `!loop song/queue/off` | Lặp bài / lặp queue |
| `!shuffle` | Trộn hàng đợi |
| `!volume <0-200>` | Chỉnh âm lượng |
| `!stop` | Dừng phát và xóa queue |
| `!leave` | Rời voice channel |
| `!autoplay on/off` | Bật/tắt AI tự phát |
| `!lyrics <bài hát>` | Tìm lời bài hát |
| `!ifind <lời bài>` | Tìm bài bằng lời |
| `!dexuat` | AI đề xuất bài tương tự |
| `!247 on/off` | Bật/tắt chế độ 24/7 |
| `!top` | BXH bài hát hot nhất |
| `!profile` | Xem profile nghe nhạc |
| `!setprefix <prefix>` | Đổi prefix server |
| `!setlang vi/en` | Đổi ngôn ngữ |
| `!help` | Danh sách tất cả lệnh |

### Tại sao chọn Makie?
- **AI-powered** — Không chỉ phát nhạc, còn hiểu gu nhạc của bạn
- **Ổn định** — Kiến trúc split-process, tự phục hồi khi gặp sự cố
- **Đẹp** — Canvas UI kawaii, không phải text embed nhàm chán
- **Đa bot** — Nhiều nhóm nghe nhạc cùng lúc, không lo bot bận


Makie Mew

Makie is a multi-bot Discord music bot with AI-powered autoplay, personal music profiles, and seamless playback

Votando em Makie Mew

Quer nos ajudar?