surge200/datmusic-api

Alternative for VK Audio API

datmusic-api vk-api

This branch contains a wrapper for VK API.

VK's private audio API's can be used only with tokens from official apps or special third party apps (for ex. Kate mobile). User agent of that app must be used when talking to VK when using such tokens.

How it works

It's written using Lumen, micro web framework by Laravel

The wrapper searches via API, caches the results. Tries to recover from captchas. Everything else is same as in original datmusic-api.

How to get tokens

See https://github.com/vodka2/vk-audio-token

Search

Search results are cached for 24 hours by default.

https://example.com/search?q={query}&page={page}

In vk-api branch, you can get errors in search responses. Captchas are the only recoverable errors. Example captcha error response:

{
  "status": "error",
  "error": {
    "message": "Captcha!",
    "captcha_index": 1,
    "captcha_id": 123456789,
    "captcha_img": "https://url-to-captcha"
  }
}

Client app will need to show captcha_img to user, and then retry search request with 3 additional queries:

1. captcha_index returned captcha index.
2. captcha_id returned captcha id.
3. captcha_key user's answer to shown captcha_img captcha.

https://example.com/search?q={query}&page={page}&captcha_index={captcha index}&captcha_id={captcha id}&captcha_key={captcha answer}

Downloads & Streams

https://example.com/dl/{search_hash}/{audio_hash} (force download with proper file name (Artist - Title.mp3))

https://example.com/stream/{search_hash}/{audio_hash} (redirects to mp3 file)

https://example.com/bytes/{search_hash}/{audio_hash} (returns file size of mp3 in bytes)

Bitrate converting

Default convertable bitrates are: 64, 128, 192 You need to install ffmpeg to your server to make it work and change path to binary in config file.

https://example.com/dl/{search_hash}/{audio_hash}/{bitrate} https://example.com/stream/{search_hash}/{audio_hash}/{bitrate}

Hashing

Search hash calculated by request params (query and page). Audio hash calculated by audio id and owner id. Default hashing algorithm is crc32. I chose this because of speed, short length, and I didn't need cryptographic hashing. You can change it in config if you want.

Cache

As far as I know, mp3 urls of VK songs are valid only for 24 hours. So we can cache search results only for 24 hours.

By default, when using S3 as storage, mp3 files can be cached forever (as long as mp3 file is present in bucket).

Default caching driver is files. Thanks to Laravel Cache system, it can be easily configured to different cache drivers. Redis cache driver is configured. Just change driver and set credentials in .env.

Using with S3 Storage

You can enable or disable S3 storage option in config file (enabled by default).

When it's enabled, mp3 files will be downloaded to s3 bucket instead of local disk.

Download/stream links will be redirected to S3 servers.

Deployment

Follow instructions described in here. or see short version in this comment;

Please browse code or open an issue to understand more.

Open an issue or contact me at [email protected] for help with deployment.

License

Copyright (C) 2017  Alashov Berkeli

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.