Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nshib00/wiffy
VK music downloader app.
https://github.com/nshib00/wiffy
customtkinter gui-app music-downloader python vk vk-music-downloader
Last synced: about 1 month ago
JSON representation
VK music downloader app.
- Host: GitHub
- URL: https://github.com/nshib00/wiffy
- Owner: nshib00
- License: mit
- Created: 2024-02-24T12:33:07.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-08-28T10:06:17.000Z (3 months ago)
- Last Synced: 2024-09-26T21:42:34.585Z (about 2 months ago)
- Topics: customtkinter, gui-app, music-downloader, python, vk, vk-music-downloader
- Language: Python
- Homepage:
- Size: 24.6 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
#  Wiffy
Приложение для скачивания аудиозаписей с профиля ВК через сайт [kissvk.com.](https://kissvk.com/)
Для парсинга данных с сайта Wiffy использует Selenium и драйвер Chrome.
## Возможности
- Получение данных об аудиозаписях со страницы ВК через kissvk.com (в том числе ссылки для скачивания).
- Сохранение данных об аудио пользователя в JSON-файле → нет необходимости каждый раз искать аудио заново.
- Скачивание аудио по ранее собранным ссылкам.
- Выбор количества аудио для скачивания (от 1 до всех сохраненных).
## Скриншоты
## Как установить (для Windows)
- [Перейдите на страницу релиза](https://github.com/nshib00/wiffy/releases/latest). Инструкция по скачиванию и необходимые файлы находится там.
_Примечание._ Для корректной работы программы не выносите exe-файл приложения из папки. Создайте ярлык файла в удобном для вас месте.
## Как запустить через Python
Программа использует инструмент для управления зависимости **Poetry** вместо pip.
_Если Poetry нет на вашем компьютере, установите через pip:_
```
pip install poetry
```
Выполните в консоли:
```
git clone https://github.com/nshib00/wiffy.git
cd wiffy
poetry shell
poetry install --no-root
```
Далее необходимо скачать расширение **Adblocker Ultimate** для браузера Chrome. Оно необходимо для блокировки рекламных окон при парсинге.
Скачать можно из релизов проекта [по ссылке](https://github.com/nshib00/wiffy/releases/download/v0.4.3/extensions.zip) или с помощью утилиты `curl`:
```
curl -L -O https://github.com/nshib00/wiffy/releases/download/v0.4.3/extensions.zip
```
Распакуйте zip-архив в корень проекта, должна появиться папка `extensions` с файлом `Adblocker-Ultimate.crx`.
Затем из корня проекта запустите главный файл приложения:
```
python main.py
```
При запуске в первый раз может быть установлен движок браузера Chrome. Это необходимо для работы библиотеки Selenium.
## Основные используемые библиотеки
- **Selenium** - парсинг страниц с аудиозаписями.
- **BeautifulSoup** - парсинг собранного контента в формате HTML.
- **Requests** - скачивание найденных аудиозаписей.
- **CustomTkinter** - графический интерфейс.
- **Black**, **isort**, **flake8** - стилизация и форматирование кода.
## Примечания
- При скачивании треков (после авторизации парсером на kissvk) **в ВК придет уведомление о входе в аккаунт**. Это нормально, поскольку для доступа к трекам через kissvk необходима авторизация через ВК. Авторизация выполняется парсером автоматически.
- **Не рекомендуется** выполнять поиск треков **много раз подряд**, так как ВК может посчитать подобную активность подозрительной. **Возможна блокировка авторизации** на kissvk на несколько часов.
- Ссылки на треки действуют некоторое время (до нескольких дней), поэтому если список треков не требуется обновлять, то пользуйтесь списком уже сохраненных треков.
- Если будут возникать ошибки при скачивании треков, запустите парсер снова (кнопка **"Найти треки из ВК"**). Так обновится список сохраненных треков и ссылки на все аудиозаписи.
- Скорее всего, будет найдено меньше аудиозаписей, чем у вас есть в ВК. Это свзяно с тем, что часть аудио может быть заблокирована в ВК по разным причинам. Заблокированные аудио **не отображаются в kissvk**, а значит, не могут быть собраны парсером и в дальнейшем скачаны.
## Решение возможных проблем
1. Если при первом запуске возникает данная ошибка:
```
FileNotFoundError: [Errno 2] No such file or directory: ''
```
то программа не увидела файл `.env`. Если файл появился в проекте при первом запуске, перезапустите приложение. Если нет, создайте файл `.env` вручную в корне проекта.
2. Если парсер не может вставить ваш номер телефона / email в форму авторизации, пропишите в файле `.env`
следующий параметр:
```
VK_LOGIN=<номер телефона или email, привязанный к ВК>
```
## Лицензия
В проекте используется лицензия [MIT](https://github.com/nshib00/wiffy/blob/main/LICENSE).