Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vanyasem/vk-songs

Downloads VK songs
https://github.com/vanyasem/vk-songs

downloader python vk vk-api vk-music vk-songs vkontakte vkontakte-api

Last synced: 2 months ago
JSON representation

Downloads VK songs

Awesome Lists containing this project

README

        

VK Songs
========
![Python 3.5, 3.6, 3.7](https://img.shields.io/pypi/pyversions/vk_songs.svg)
[![PyPI](https://img.shields.io/pypi/v/vk-songs.svg)](https://pypi.python.org/pypi/VK-Songs)
[![AUR](https://repology.org/badge/version-for-repo/aur/vk-songs.svg)](https://aur.archlinux.org/packages/vk-songs)
[![Travis](https://img.shields.io/travis/vanyasem/VK-Songs.svg)](https://travis-ci.org/vanyasem/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