VkMusic

vk_music gem is a library to work with audios on popular Russian social network

Add this line to your application's Gemfile:

gem 'vk_music'

And then execute:

$ bundle

Or install it using gem:

$ gem install vk_music

You can take a look on documentation at rubydoc.

Firstly, it is required to create new VkMusic::Client instance and provide login credentials:

client = VkMusic::Client.new(username: "+79991234567", password: "password")

You can search audios using Client#find:

audios = client.find("Acid Spit - Mega Drive")

You can also search for playlists using same method:

playlists = client.find("Jazz", type: :playlist)

You can load playlist audios with Client#playlist

playlist = client.playlist(url: "link")

You can load profile audios with Client#audios

playlist = client.audios(owner_id: 8024985)

You can load audios from profile wall with Client#wall

playlist = client.wall(owner_id: 8024985)

You can load up to 10 audios attached to some post. Those audios will be returned as array:

audios = client.post(url: "link")

You can get up to 50 top audios of particular artist:

audios = client.artist(url: "link")

To get audio URL you should go through following chain:

1. Get audio ID
2. Get audio encrypted URL
3. Get audio decrypted URL

Usually most of audios already go with ID. Getting encrypted URL requires additional request to web, so it is performed with Client#update_urls, which will mutate provided array of audios:

client.update_urls(audios_array)

After this you can get decrypted URL using Audio#url

Feel free to add features. However, please make sure all your code is covered with tests.

This gem uses rspec and vcr for easy testing. Be careful, though, running rspec in clean repo may result in lot of requests to web and rate limiting or ban

Bug reports and pull requests are welcome on GitHub at https://github.com/fizvlad/vk-music-rb/issues.

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