Project is deprected because VK blocked access to audios via API

vnehm

vnehm is a console tool, which downloads and adds to your iTunes library (if you use macOS) your VK audios in convenient way.

(click to zoom)

---

DISCLAIMER

For personal use only

vnehm developer doesn't responsible for any illegal usage of this program

---

Description

vnehm is a console tool written in Go. It can download your VK audios and add to iTunes, if you use macOS.

vnehm wasn't tested on Windows machine, so it can be very buggy on it. I'll be very thankful, if you will report any bug.

If you have ideas to improve vnehm, issues and pull requests are always welcome! Also, if you have difficulties with installation/configuration/usage of vnehm, don't hesitate to write an issue. I will answer as soon as possible.

Installation

Install via go command:

$ go get -u github.com/bogem/vnehm

or you can download and install binary from latest release.

Configuration

First of all, you should configure vnehm:

• Create a file .vnehmconfig in your home directory

• Write in it configuration, i.e. set three variables in YAML format:

dlFolder - filesystem path to download folder, where will be downloaded all tracks. By default, your audios are being downloaded to your home directory

itunesPlaylist - name of iTunes playlist, where will be added all tracks (if you're using macOS). By default, your audios are not being added to iTunes

Example:

dlFolder: /Users/bogem/Music
itunesPlaylist: iPod

• Execute vnehm auth to authorize

Don't worry if you become the message, what you mustn't copy the link from address bar. vnehm is only downloading and searching audios and it hasn't got any permissions to access your private data like messages, friends and etc. All permissions, which has vnehm, is access to audios. You can see it, when you authorize in your browser with the link, what give you vnehm for authorizing.

Usage Examples

Type vnehm help to list of all available commands or vnehm help COMMAND for specific command.

Also commands may be abbreviated to one symbol length. For example, you can input vnehm s instead of vnehm search.

Get list of audios and download selected

$ vnehm

Download last audio

$ vnehm get

Download last 3 audios

$ vnehm get 3

Download second audio and don't add it to iTunes playlist

$ vnehm get -o 1 -i ''

Download audios from the post

$ vnehm get https://vk.com/wall20942729_1722

Search for audios and download them

$ vnehm search nasa

FAQ

Q: How can I add track to iTunes' music library, but not to any playlist?

A: It depends on language you're using on your Mac. The name of your iTunes' music library you can see here:

For example, english users should use vnehm get -i Music, russian users - vnehm get -i Музыка.

TODO

• Make tests
• Upload to homebrew
• Use built-in downloader instead of curl

License

MIT