README.md

VK Songs

vk-songs is a command-line application written in Python that downloads VK audio files. Use responsibly.

Features

• Scrape user's music
• Scrape community's music
• Scrape albums
• Embedding support

Install

Arch GNU/Linux

For the stable version:

$ trizen -S vk-songs

For the git version:

$ trizen -S vk-songs-git

Other distros

For the stable version:

$ pip3 install vk-songs --upgrade --user

For the git version:

$ pip3 install git+https://github.com/vanyasem/VK-Songs.git --upgrade --user

Usage

Just run the app, it's interactive

$ vk-songs

Note: If running from PyCharm, make sure to check "Emulate terminal in output console" in your Run configuration.

Contributing

1. Check open issues or open a new one to start a discussion around your idea or a bug you found
2. Fork the repository and make your changes
3. Send a pull request

Futurelog

• Qt5 GUI
• Embedding how-to
• Configuration (file mask, log level, destination, ID3 tagging)
• Session caching
• User ID decoding
• Download albums to separate folders
• AppImage
• Windows EXE
• MacOS Build