0.0
Repository is archived
No commit activity in last 3 years
No release in over 3 years
Download your VK playlist in one command
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

~> 4.4
 Project Readme

VK Music Loader

VK Music Loader is a simple CLI Ruby gem to download music from VK (ВКонта́кте) using easy and convenient way of authorization - Implicit Flow using mirror of VK Audio API This gem aimed at Ruby 2.0 or later.

Installation

$ gem install vk_music_loader

Usage

To login you will need create Standalone Application or use the author's application (default APP ID: 5377636) From December 16, 2016, the public API for working with audio files will be disabled. Existing methods for the audio section will be unavailable for calling, except for methods regarding audio file uploads. (source)

So you need to use a mirror of VK Audio API and buy an authentication key: http://api.xn--41a.ws/addmoney/. I think 1$ is enough for a long time (100k requests) for personal use or also you can write to me to share my key.

$ vk_music_loader -id USER_OR_GROUP_ID
$ vk_music_loader -q QUERY_SEARCH
  [ -key (or key, --key, -k) your_auth_key (need only enter the first time after it is saved) ]
  [ -count (or count, -count, --count, c, -c, --c) count_of_songs (default: 300) ]
  [ -folder (or -folder, --folder, path, -path, --path, -p) folder_path_to_download_music (default: 'music') ]
  [ -random (or  --random, shuffle, -shuffle, --shuffle, -r) shuffle_download_flag (default: false) ]

If the song is already in the folder, it will not be downloaded.

Usage examples

# Download all music from VK Public:
$ vk_music_loader -id -45172096

# Download 20 first songs from user in specified folder:
$ vk_music_loader -id 243556640 -с 20 -p '/Volumes/FLASHKA/music_in_da_bass_car'

# Download 4 random Eminem Song:
$ vk_music_loader -q 'Eminem' -c 4 -r

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/m1neral/vk_music_loader.

License

The gem is available as open source under the terms of the MIT License.