{"id":22959547,"url":"https://github.com/issamansur/kaisa","last_synced_at":"2025-04-19T07:19:44.363Z","repository":{"id":191328476,"uuid":"684415450","full_name":"issamansur/KaiSa","owner":"issamansur","description":"Welcome in musical world with Kai'Sa discord bot","archived":false,"fork":false,"pushed_at":"2023-10-13T19:35:29.000Z","size":525,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-29T06:51:18.087Z","etag":null,"topics":["bot","discord","discord-bot","discord-py","github","github-codespaces","hacktoberfest","learn","music","music-bot"],"latest_commit_sha":null,"homepage":"https://discord.com/api/oauth2/authorize?client_id=1147834135918956577\u0026permissions=2150664192\u0026scope=bot%20applications.commands","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/issamansur.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-08-29T04:46:14.000Z","updated_at":"2024-10-04T23:31:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"feea1517-cee6-4404-bf4a-4a85073c7ac8","html_url":"https://github.com/issamansur/KaiSa","commit_stats":null,"previous_names":["issamansur/lux_ui"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/issamansur%2FKaiSa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/issamansur%2FKaiSa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/issamansur%2FKaiSa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/issamansur%2FKaiSa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/issamansur","download_url":"https://codeload.github.com/issamansur/KaiSa/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249638230,"owners_count":21304303,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","discord","discord-bot","discord-py","github","github-codespaces","hacktoberfest","learn","music","music-bot"],"created_at":"2024-12-14T18:19:01.111Z","updated_at":"2025-04-19T07:19:44.346Z","avatar_url":"https://github.com/issamansur.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kai'Sa [K/DA]\n## Содержание:\n0. [Пригласить бота на сервер](https://discord.com/api/oauth2/authorize?client_id=1147834135918956577\u0026permissions=2150664192\u0026scope=bot%20applications.commands)\n1. [Вступление](#intro)\n2. [Начало работы](#start)\n3. [Команды бота](#commands)\n4. [Задачи](#tasks)\n5. [Зависимости](#requirements)\n\n## 🎵 Добро пожаловать в мир музыки с \"Кайсой из К/DA\"! 🎵 \u003ca name=\"intro\"\u003e\u003c/a\u003e\n\n🎧 Познакомьтесь с вашим новым музыкальным спутником, который перенесет вас в мир магии и музыки, как это делают Кайсы из K/DA! Наш бот - это не просто музыкальный бот, это настоящий артист, создающий уникальную атмосферу на вашем сервере Discord.\n\n✨ Почему выбрать именно нас:\n- 🎶 Бескрайний музыкальный опыт: Наш бот предоставляет доступ к миллионам треков самых разных жанров. От хип-хопа до классики, от K-Pop до рок-н-ролла - у нас есть всё!\n- 🤖 Интуитивный интерфейс управления: Наш бот прост в использовании, даже если вы новичок в Discord. Управление музыкой - это легко!\n- 🎵 Собственные плейлисты: Создавайте свои собственные музыкальные плейлисты и делитесь ими с друзьями!\n- 🌟 Поддержка текстовых и голосовых команд: Вы можете управлять музыкой, даже не выходя из голосового чата!\n\n🎉 Присоединяйтесь к нам и окунитесь в мир музыки и развлечений, напоминающий невероятные выступления Кайсы из K/DA на большой сцене! Наслаждайтесь звуками и создавайте незабываемые моменты на своем сервере Discord с музыкальным ботом \"Кайса из К/DA\"! 🎶💃🎤\n\nНе упустите шанс добавить этого бота на свой сервер и создать уникальную атмосферу для ваших друзей и сообщества! 🚀🎵\n\n## Начало работы (пример от партнёра) \u003ca name=\"start\"\u003e\u003c/a\u003e\n\n### 1. Пригласите бота [\u003cb\u003eпо ссылке\u003c/b\u003e](https://discord.com/api/oauth2/authorize?client_id=1147834135918956577\u0026permissions=2150664192\u0026scope=bot%20applications.commands).\n![invite](source/img/invite.png)\n\n### 2. Пропишите `/register`. \n**Внимание!** Сообщение должно быть отправлено админом гильдии/сервера\n\n### 3. Перейдите в лс с ботом.\n![register1](source/img/register.png)\n\n### 4. Скопируйте строку и вставьте в поле ввода. Если текст не превратился сразу в команду - просто нажмите Enter.\n![auth1](source/img/auth1.png)\n\n### 5. Введите \u003ci\u003eТелефон\u003c/i\u003e, \u003ci\u003eПароль\u003c/i\u003e и нажмите Enter.\n![auth2](source/img/auth2.png)\n![auth3](source/img/auth3.png)\n\n### 6. При необходимости введите код двухфакторной авторизации или капчи.\n![captcha](source/img/captcha.png)\n![2fa](source/img/2fa.png)\n\n### 7. Если всё успешно - сервис готов. Иначе заново вернитесь к **Пункту 4**\n\n### 8. Используйте команды ниже для использования сервиса. Примеры результатов:\n\n`/search-album` Три дня дождя\n\n![Search album query](source/img/saq.png)\n\n![Search album answer](source/img/saa.png)\n\n`/list`\n\n`/repeat ALL`\n\n![Res](source/img/res.png)\n\n## Команды \u003ca name=\"commands\"\u003e\u003c/a\u003e\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cb\u003eКоманды управления ботом\u003c/b\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cb\u003eКоманды управления аккаунтом пользователя\u003c/b\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e✅ /ping\u003c/td\u003e\n    \u003ctd\u003e✅ /register\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e⌛ /help\u003c/td\u003e\n    \u003ctd\u003e✅ /unregister\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e✅ /report\u003c/td\u003e\n    \u003ctd\u003e✅ /auth [id гильдии] [логин/телефон] [пароль]\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cb\u003eКоманды поиска и воспроизведения музыки\u003c/b\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cb\u003eКоманды управления воспроизведением музыки\u003c/b\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e✅ /search [название/автор песни]\u003c/td\u003e\n    \u003ctd\u003e✅ /list\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e✅ /search-album [название плейлиста (исполнителя)]\u003c/td\u003e\n    \u003ctd\u003e✅ /repeat [OFF | ONE | ALL]\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e✅ /search-playlist [название плейлиста (пользователя)]\u003c/td\u003e\n    \u003ctd\u003e✅ /skip\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e⌛ Soon...\u003c/td\u003e\n    \u003ctd\u003e✅ /quit\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## Задачи: \u003ca name=\"tasks\"\u003e\u003c/a\u003e\n### Общее:\n- ✅ Воспроизведение и интерактивность с голосовыми каналами\n- ✅ Интеграция `vkpymusic` для доступа к аудио и плейлистам\n- ✅ Работа с аудио\n- ✅ СКАЧИВАНИЕ!!!\n- ✅ Работа с плейлистами\n\n### Очередь треков:\n- ✅ Своя очередь для каждой группы\n- ✅ Очередь треков (синхронная)\n- ⌛ Очередь асинхронная (с использованием `asyncio.Queue` или иначе)\n\n### Токены VK API:\n- ✅ Сохранение API токенов для каждой гильдии/сервера\n- ✅ Автоматическое переподключение сервиса вместо /register\n- ❌ Проверка валидности API токена\n\n### Прочее:\n- ⌛ Редизайн и правки\n- ⌛ Документация и комментарии к коду\n- ⌛ Тестирование и отладка\n\n### Возможное и невозможное:\n- ❌ Дополнительные функции для управления плейлистами\n- ❌ Интеграция с другими музыкальными сервисами\n- ❌ Работоспособность на 100%\n\n## Зависимости \u003ca name=\"requirements\"\u003e\u003c/a\u003e\nДля работы проекта требуется установить следующие зависимости:\n\n- `aiohttp`: библиотека для работы с запросами/установками.\n- `discord.py`: библиотека для работы с Discord API.\n- `discord.py[Voice]`: библиотека для работы с голосовыми каналами Discord.\n- `PyNaCl`: библиотека для воспроизведения аудио.\n- `vkpymusic`: моя собственная библиотека для работы с музыкой в ВКонтакте.\n- `ffmpeg`: утилита для работы с аудио-потоками.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fissamansur%2Fkaisa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fissamansur%2Fkaisa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fissamansur%2Fkaisa/lists"}