https://github.com/issamansur/kaisa

Welcome in musical world with Kai'Sa discord bot
https://github.com/issamansur/kaisa

bot discord discord-bot discord-py github github-codespaces hacktoberfest learn music music-bot

Last synced: about 1 year ago
JSON representation

Welcome in musical world with Kai'Sa discord bot

• Host: GitHub
• URL: https://github.com/issamansur/kaisa
• Owner: issamansur
• License: mit
• Created: 2023-08-29T04:46:14.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2023-10-13T19:35:29.000Z (over 2 years ago)
• Last Synced: 2025-03-29T06:51:18.087Z (about 1 year ago)
• Topics: bot, discord, discord-bot, discord-py, github, github-codespaces, hacktoberfest, learn, music, music-bot
• Language: Python
• Homepage: https://discord.com/api/oauth2/authorize?client_id=1147834135918956577&permissions=2150664192&scope=bot%20applications.commands
• Size: 513 KB
• Stars: 5
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Kai'Sa [K/DA]

## Содержание:

0. [Пригласить бота на сервер](https://discord.com/api/oauth2/authorize?client_id=1147834135918956577&permissions=2150664192&scope=bot%20applications.commands)

1. [Вступление](#intro)

2. [Начало работы](#start)

3. [Команды бота](#commands)

4. [Задачи](#tasks)

5. [Зависимости](#requirements)

## 🎵 Добро пожаловать в мир музыки с "Кайсой из К/DA"! 🎵 

🎧 Познакомьтесь с вашим новым музыкальным спутником, который перенесет вас в мир магии и музыки, как это делают Кайсы из K/DA! Наш бот - это не просто музыкальный бот, это настоящий артист, создающий уникальную атмосферу на вашем сервере Discord.

✨ Почему выбрать именно нас:

- 🎶 Бескрайний музыкальный опыт: Наш бот предоставляет доступ к миллионам треков самых разных жанров. От хип-хопа до классики, от K-Pop до рок-н-ролла - у нас есть всё!

- 🤖 Интуитивный интерфейс управления: Наш бот прост в использовании, даже если вы новичок в Discord. Управление музыкой - это легко!

- 🎵 Собственные плейлисты: Создавайте свои собственные музыкальные плейлисты и делитесь ими с друзьями!

- 🌟 Поддержка текстовых и голосовых команд: Вы можете управлять музыкой, даже не выходя из голосового чата!

🎉 Присоединяйтесь к нам и окунитесь в мир музыки и развлечений, напоминающий невероятные выступления Кайсы из K/DA на большой сцене! Наслаждайтесь звуками и создавайте незабываемые моменты на своем сервере Discord с музыкальным ботом "Кайса из К/DA"! 🎶💃🎤

Не упустите шанс добавить этого бота на свой сервер и создать уникальную атмосферу для ваших друзей и сообщества! 🚀🎵

## Начало работы (пример от партнёра) 

### 1. Пригласите бота [по ссылке](https://discord.com/api/oauth2/authorize?client_id=1147834135918956577&permissions=2150664192&scope=bot%20applications.commands).

![invite](source/img/invite.png)

### 2. Пропишите `/register`. 

**Внимание!** Сообщение должно быть отправлено админом гильдии/сервера

### 3. Перейдите в лс с ботом.

![register1](source/img/register.png)

### 4. Скопируйте строку и вставьте в поле ввода. Если текст не превратился сразу в команду - просто нажмите Enter.

![auth1](source/img/auth1.png)

### 5. Введите Телефон, Пароль и нажмите Enter.

![auth2](source/img/auth2.png)

![auth3](source/img/auth3.png)

### 6. При необходимости введите код двухфакторной авторизации или капчи.

![captcha](source/img/captcha.png)

![2fa](source/img/2fa.png)

### 7. Если всё успешно - сервис готов. Иначе заново вернитесь к **Пункту 4**

### 8. Используйте команды ниже для использования сервиса. Примеры результатов:

`/search-album` Три дня дождя

![Search album query](source/img/saq.png)

![Search album answer](source/img/saa.png)

`/list`

`/repeat ALL`

![Res](source/img/res.png)

## Команды 

  

    Команды управления ботом

    Команды управления аккаунтом пользователя

  

  

    ✅ /ping

    ✅ /register

  

  

    ⌛ /help

    ✅ /unregister

  

  

    ✅ /report

    ✅ /auth [id гильдии] [логин/телефон] [пароль]

  

  

    Команды поиска и воспроизведения музыки

    Команды управления воспроизведением музыки

  

  

    ✅ /search [название/автор песни]

    ✅ /list

  

  

    ✅ /search-album [название плейлиста (исполнителя)]

    ✅ /repeat [OFF | ONE | ALL]

  

  

    ✅ /search-playlist [название плейлиста (пользователя)]

    ✅ /skip

  

  

    ⌛ Soon...

    ✅ /quit

  

## Задачи: 

### Общее:

- ✅ Воспроизведение и интерактивность с голосовыми каналами

- ✅ Интеграция `vkpymusic` для доступа к аудио и плейлистам

- ✅ Работа с аудио

- ✅ СКАЧИВАНИЕ!!!

- ✅ Работа с плейлистами

### Очередь треков:

- ✅ Своя очередь для каждой группы

- ✅ Очередь треков (синхронная)

- ⌛ Очередь асинхронная (с использованием `asyncio.Queue` или иначе)

### Токены VK API:

- ✅ Сохранение API токенов для каждой гильдии/сервера

- ✅ Автоматическое переподключение сервиса вместо /register

- ❌ Проверка валидности API токена

### Прочее:

- ⌛ Редизайн и правки

- ⌛ Документация и комментарии к коду

- ⌛ Тестирование и отладка

### Возможное и невозможное:

- ❌ Дополнительные функции для управления плейлистами

- ❌ Интеграция с другими музыкальными сервисами

- ❌ Работоспособность на 100%

## Зависимости 

Для работы проекта требуется установить следующие зависимости:

- `aiohttp`: библиотека для работы с запросами/установками.

- `discord.py`: библиотека для работы с Discord API.

- `discord.py[Voice]`: библиотека для работы с голосовыми каналами Discord.

- `PyNaCl`: библиотека для воспроизведения аудио.

- `vkpymusic`: моя собственная библиотека для работы с музыкой в ВКонтакте.

- `ffmpeg`: утилита для работы с аудио-потоками.