{"id":15107991,"url":"https://github.com/mewforest/vk-music-import","last_synced_at":"2026-03-05T07:01:51.298Z","repository":{"id":40515559,"uuid":"478461435","full_name":"mewforest/vk-music-import","owner":"mewforest","description":"Импорт плейлистов в VK Музыку из Spotify и других сервисов","archived":false,"fork":false,"pushed_at":"2025-06-14T11:19:08.000Z","size":1195,"stargazers_count":62,"open_issues_count":2,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-14T12:28:03.654Z","etag":null,"topics":["import","music","playlist","spotify","tracklist","vk"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mewforest.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,"zenodo":null}},"created_at":"2022-04-06T08:02:08.000Z","updated_at":"2025-06-14T11:19:12.000Z","dependencies_parsed_at":"2025-04-23T16:10:12.649Z","dependency_job_id":"86988e19-11d2-45e5-b167-e6d15e3bd555","html_url":"https://github.com/mewforest/vk-music-import","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/mewforest/vk-music-import","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mewforest%2Fvk-music-import","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mewforest%2Fvk-music-import/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mewforest%2Fvk-music-import/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mewforest%2Fvk-music-import/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mewforest","download_url":"https://codeload.github.com/mewforest/vk-music-import/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mewforest%2Fvk-music-import/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30113111,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T03:40:26.266Z","status":"ssl_error","status_checked_at":"2026-03-05T03:39:15.902Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["import","music","playlist","spotify","tracklist","vk"],"created_at":"2024-09-25T21:43:37.087Z","updated_at":"2026-03-05T07:01:51.276Z","avatar_url":"https://github.com/mewforest.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# vk-music-import\n\nПрограмма для переноса плейлистов из Spotify и текстовых треклистов в VK Музыку.\n\n![Untitled Diagram drawio-3](https://user-images.githubusercontent.com/15357833/161931217-9c374cf8-749a-4966-b3f5-4e8a85194572.png)\n\nПреимущества:\n\n- **Позволяет быстро импортировать плейлисты из Spotify в VK Музыку**\n- Импортирует даже неточные по названию треки\n- Имеет доступ только к аудиозаписям, данные никуда не \"утекают\"\n- Поддерживает большие плейлисты (более 1000 треков)\n- Позволяет импортировать также обычные текстовые списки треков в VK Музыку\n- Умеет обходить капчу\n\n---\n## Скриншоты\n\n\u003cimg style=\"float: left; height: 250px\" src=\"https://github.com/mewforest/vk-music-import/assets/15357833/0e0832cf-03a4-44d3-a082-a781458a5a87\"\u003e\n\u003cimg style=\"float: left; height: 250px\" src=\"https://github.com/mewforest/vk-music-import/assets/15357833/9c06eb70-61f1-440e-83fd-50d3234b73a2\"\u003e\n\u003cimg style=\"float: left; height: 250px\" src=\"https://github.com/mewforest/vk-music-import/assets/15357833/30db41d3-6886-49c9-a711-9a2b04a44954\"\u003e\n\n## Как запустить? (для обычных пользователей)\n\nИнструкция по использованию на Windows:\n\n- Скачайте и распакуйте \n  архив ([vk-music-import-vX.X_win32.zip](https://github.com/mewforest/vk-music-import/releases))\n  в любую папку\n- Запустите исполняемый файл и следуйте инструкциям:\n\n![2022-04-08_12h22_59](https://user-images.githubusercontent.com/15357833/167272239-55fc04eb-27c1-40bc-abe9-596390c64459.png)\n\n**Более подробная инструкция на\nDTF:** [Переносим плейлисты из Spotify в VK Музыку (подробное руководство)](https://dtf.ru/u/292194-mew-forest/1152260-perenosim-pleylisty-iz-spotify-v-vk-muzyku-podrobnoe-rukovodstvo)\n.\n\n## Как запустить? (для продвинутых пользователей)\n\n1. Убедитесь, что у вас установлен Python 3.8+.\n2. Установите зависимости:\n   ```\n   pip install -r requirements.txt\n   ```\n3. Запустите скрипт и следуйте инструкциям (если некоторые библиотеки не устанавливаются - игнорируйте это, часть библиотек \nиспользуется только для компиляции win32 с помощью pyinstaller - об этом в другом разделе):\n   ```\n   python vk-music-import.py\n   ```\n4. После переноса треков, скрипт сгенерирует отчет и выведет ссылку на плейлисты с импортированными треками.\n\n## Перенос плейлистов из Apple Music\n\n1. В приложении Музыка на Mac выберите плейлист в боковом меню, затем выберите «Файл» \u003e «Медиатека» \u003e «Экспортировать плейлист». Выберите формат «Простой Текст».\n2. В файле настроек (`config.env`, лежит в папке с программой) с помощью блокнота выключите режим spotify: `SPOTIFY_MODE=\"0\"`\n3. Аналогично предыдущему шагу включите режим Apple Music: `APPLE_MODE=\"1\"`\n4. Запустите скрипт, поместив экспортированный файл в папку со скриптом (**ВАЖНО**: файл должен называться `tracklist.csv`):\n  ```\n  python vk-music-import.py\n  ```\n\nВажно: данный режим экспериментальный и может не поддерживаться полностью.\n\n## Как перенести музыку из других сервисов?\n\nЧтобы перенести музыку из сторонних сервисов (YouTube, Apple Music, Яндекс Музыка и т.д.), вам необходимо будет экспортировать оттуда треклист (текстовой файл с названиями треков). Это можно сделать с помощью стороннего сервиса [TuneMyMusic](https://www.tunemymusic.com/ru/):\n\n1. Перейдите на сайт [TuneMyMusic](https://www.tunemymusic.com/ru/) и нажмите кнопку «Давайте приступим».\n2. Выберите сервис, из которого вы хотите перенести музыку, и авторизуйтесь в нем.\n3. Выберите плейлист для переноса, нажав кнопку «Загрузить из вашей учетной записи».\n4. На странице «Выберите целевую платформу» нажмите кнопку «Файл» и скачайте его в формате .txt.\n5. Нажмите «Начать перенос музыки».\n6. Сохраните файл на свой компьютер, а затем переместите его в папку с данной программой и переименуйте в `tracklist.txt`.\n7. В файле настроек (`config.env`, лежит в папке с программой) с помощью блокнота выключите режим spotify: `SPOTIFY_MODE=\"0\"`\n8. Готово, запускайте скрипт!\n\n*Инструкция частично заимствована [отсюда](https://zvuk.com/lp/howto)*.\n\n### Альтернативы\n\n- Яндекс Музыка: [расширение для Google Chrome](https://chrome.google.com/webstore/detail/yamutools-%D0%BD%D0%BE%D0%B2%D1%8B%D0%B5-%D1%84%D1%83%D0%BD%D0%BA%D1%86%D0%B8%D0%B8-%D0%B4/dgjneghdfaeajjemeklgmbojeeplehah) (могут быть неточности из-за формата экспорта [#5](https://github.com/mewforest/vk-music-import/issues/5)).\n- YouTube Музыка: сервис [yt.spotya.ru](https://yt.spotya.ru/).\n- Apple Music, Deezer, Amazon и другие: вместо [TuneMyMusic](https://www.tunemymusic.com/ru/) можете воспользоваться конкурентом - [Soundiiz](https://soundiiz.com/).\n\n## Как создать плейлист из ссылок на треки во Вконтакте\n\nНа любой трек во ВКонтакте можно получить прямую ссылку, если вы создадите список таких ссылок, то их также можно будет добавить в плейлист\nс помощью данной утилиты. Это может быть полезно, если вы создаете плейлисты в стороннем приложении для прослушивания музыки,\nнапример, в AIMP с использованием плагина [VK Plugin](https://www.aimp.ru/forum/index.php?topic=64170.0).\n\nЧтобы перейти в режим импорта из списка ссылок, в `config.env` отключите режим Spotify: `SPOTIFY_MODE=\"0\"` и включите\nрежим `VK_LINKS_MODE=\"1\"`. Теперь скрипт будет добавлять треки по ссылкам из файла `tracklist.txt` минуя поиск. Вот как\nдолжен выглядеть этот список:\n\n```\nhttps://vk.com/audio570484580_456249918_30a6c863d7cb56d834\nhttps://vk.com/audio570484580_456245588_3c170a3340106a374a\nhttps://vk.com/audio570484580_456245614_4bb21fb36173e3c61b\nhttps://vk.com/audio570484580_456254608_7784e1bddd07c3289f\n```\n\n### Как получить список ссылок на музыку в AIMP-е\n\n1. Установить [VK Plugin](https://www.aimp.ru/forum/index.php?topic=64170.0) в AIMP\n2. Правой кнопкой мыши по списку треков \"Экспорт треклиста\"\n3. Появится окошко с настройками экспорта, в поле \"Форматная строка\" написать `%Link` и кликнуть \"ОК\"\n4. Готово! Треклист можно сохранять как `tracklist.txt`, предварительно удалив из него лишние строки в самом начале файла.\n\n## Настройки\n\n## Описание настроек\n\n| Параметр                | Описание                                                                                                   | Значение по умолчанию |\n|-------------------------|------------------------------------------------------------------------------------------------------------|-----------------------|\n| `VK_TOKEN`              | Токен для доступа к VK API**                                                                               | `\"\"`                  |\n| `BYPASS_CAPTCHA`        | Включить обход капчи автоматически (если отключить, будет предложено вводить капчу каждый раз вручную)     | `1`                   |\n| `SPOTIFY_MODE`          | Включить режим импорта из Spotify                                                                          | `1`                   |\n| `APPLE_MODE`            | Включить режим импорта из Apple Music                                                                      | `0`                   |\n| `VK_LINKS_MODE`         | Включить режим импорта из списка ссылок на треки во Вконтакте (ссылки должны быть в файле `tracklist.txt`) | `0`                   |\n| `REVERSE`               | Добавлять треки в обратном порядке (от новых к старым)                                                     | `1`                   |\n| `STRICT_SEARCH`         | Искать только точные совпадения по исполнителю                                                             | `0`                   |\n| `ADD_TO_LIBRARY`        | Добавлять треки в мои аудиозаписи                                                                          | `0`                   |\n| `ADD_TO_GROUP_ID`       | Добавлять треки в сообщество с указанным ID. Если пусто, то опция выключена.                               | ``                    |\n| `TIMEOUT_AFTER_ERROR`   | Задержка после ошибки (в секундах)*                                                                        | `10`                  |\n| `TIMEOUT_AFTER_CAPTCHA` | Задержка после капчи (в секундах)*                                                                         | `30`                  |\n| `TIMEOUT_AFTER_SUCCESS` | Задержка после успешного импорта (в секундах)*                                                             | `1`                   |\n\n*Только для beta-версии.\n** Ссылка для получения токена [здесь](https://oauth.vk.com/oauth/authorize?client_id=6121396\u0026scope=audio,offline\u0026redirect_uri=https://oauth.vk.com/blank.html\u0026display=page\u0026response_type=token\u0026revoke=1\u0026slogin_h=23a7bd142d757e24f9.93b0910a902d50e507\u0026__q_hash=fed6a6c326a5673ad33facaf442b3991\n).\n\n\n### Добавление в мои аудиозаписи\n\nПо-умолчанию треки переносятся в плейлист без добавления в раздел \"мои аудиозаписи\". Чтобы включить добавление музыки в свою\nмедиатеку ВКонтакте, в `config.env` включите соответственный пункт: `ADD_TO_LIBRARY=\"1\"`. \n\n**Используйте с осторожностью:** ВКонтакте не проверяет трек на наличие в аудиозаписях, так что при импорте возможны дубликаты.\n\n### Импорт музыки из треклиста\n\nПо-умолчанию включен импорт треков из плейлиста Spotify, чтобы перейти в режим импорта из треклиста, в `config.env`\nотключите режим Spotify: `SPOTIFY_MODE=\"0\"`. Теперь скрипт будет искать треки из файла `tracklist.txt` (его нужно\nсоздать самостоятельно в папке со скриптом), который должен содержать список треков, разделенных переносом, например:\n\n```\nKhalid - Better\nBillie Eilish - i love you\n```\n\n\u003e Если дефисы не проставлены, скрипт проставит их автоматически после первого слова.\n\n### Треки в обратном порядке\n\nПо-умолчанию все плейлисты добавляются в обратном порядке (от новых к старым). Чтобы это отключить, в `config.env`\nотключите режим обратного порядка: `REVERSE=\"0\"`.\n\n### Строгий поиск\n\nПо-умолчанию скрипт ищет неточные совпадения для треков и также их переносит, побочный эффект этого: в вашу медиатеку\nмогут попасть ремиксы и bassboosted-версии. Чтобы разрешить перенос только точных совпадений по исполнителю,\nв `config.env` включите строгий режим: `STRICT_SEARCH=\"1\"`.\n\n### Добавление в сообщество (группу)\n\nЧтобы добавить треки в сообщество (группу), вы должны быть её администратором. В `config.env` добавьте строчку: \n`ADD_TO_GROUP_ID=\"123456789\"`. Вместо`123456789` укажите ID сообщества ([как узнать id группы в VK](https://vk.com/faq18062)), \nв которое вы хотите добавить треки.\n\n## Возможные проблемы и их решения\n\n### Обход капчи не работает на macOS на M1\n\nЭто происходит из-за проблем с установкой onnx-runtime.\n\n- **Решение 1**: запустите скрипт через Python x64 с помощью Rosetta.\n- **Решение 2**: отключить распознавание капчи и вводить ответы вручную. Для этого закомментируйте строчку\n  импорта `import onnxruntime as rt` в `vk-music-import.py` (можете удалить строчки, где эта библиотека используется) и выключите распознавание капчи в\n  файле `config.env`: `BYPASS_CAPTCHA=\"0\"`.\n\n\n### Не работает обход капчи\n\n- Увеличьте значение `CAPTCHA_TIMEOUT` в `config.env` (по-умолчанию 30 секунд)*.\n- Отключите автоматический обход капчи в `config.env`: `BYPASS_CAPTCHA=\"0\"` и вводите ответы вручную.\n- Повторите попытку через некоторое время, возможно ВКонтакте временно заблокировал ваш аккаунт.\n\n### Слетела конфигурация по умолчанию\n\nВсе настройки хранятся в файле `config.env`, если он был удален или повредился, то его можно восстановить вручную, вставив настройки по умолчанию из [файла в репозитории](https://github.com/mewforest/vk-music-import/blob/main/config.env).\n\n\n## Компиляция программы\n\nВы можете скомпилировать данную утилиту самостоятельно, в том числе для своей операционной системы (в инструкции пример\nдля Windows).\n\n- Создайте виртуальное окружение и установите зависимости и Pyinstaller:\n  ```shell\n  python -m virtualenv venv\n  venv\\Scripts\\activate\n  pip install -r requirements.txt\n  pip install pyinstaller\n  ```\n- Запустите компиляцию (да, это больно):\n  ```shell\n  pyinstaller --onefile --icon=app.ico --add-binary=\"venv\\Lib\\site-packages\\onnxruntime\\capi\\onnxruntime_providers_shared.dll;.\\onnxruntime\\capi\" --windowed --hidden-import=PySide2  --hidden-import=tkinter .\\vk-music-import.py\n  ```\n- Скопируйте в папку `dist` файл с моделями капчи (`models`) и файл конфигурации (`config.env`):\n  ```shell\n  cp -r .\\models\\ .\\dist\\models\n  cp .\\config.env .\\dist\n  ```\n\n## Поддержка пользователей\n\n- **[Оставить запрос на фичу или сообщить о баге](https://github.com/mewforest/vk-music-import/issues/new/choose)**\n- [Поблагодарить разработчика](https://mewforest.github.io/donate/)\n\n## Полезный материал\n\n- [Айти заметки](https://t.me/mewnotes) - телеграм-канал автора сервиса.\n- [Spotya](https://spotya.ru/) - сервис для переноса музыки из Spotify в Яндекс Музыку, некоторые метаданные о\n  плейлистах я собираю с его API.\n- [vkCaptchaBreaker](https://github.com/Defasium/vkCaptchaBreaker/) - модель для решения капчи ВК взята из данного\n  репозитория\n- [VK API Reference](https://vodka2.github.io/vk-audio-token/) - описание методов VK API для доступа к аудиозаписям.\n\n## Альтернативные решения\n\n- [Официальный сервис \"Перенос Музыки\"](https://vk.com/app8116845) - Умеет переносить пользовательскую библиотеку из резервных копий Spotify\n\n## Условия пользования\n\nАвтор не несет ответственности за любые действия, которые предпринимаете с данным ПО, вы делаете всё на свой страх и\nриск. Учитывайте, что данный метод импортирования музыки не является официальным, но банов за его использования пока не\nбыло.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmewforest%2Fvk-music-import","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmewforest%2Fvk-music-import","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmewforest%2Fvk-music-import/lists"}