/datmusic-api

Alternative for VK Audio API

Primary LanguagePHPGNU General Public License v2.0GPL-2.0

datmusic-api

This is new api for datmusic which uses directly m.vk.com (not api) to get audio data.

I made this because VK disabled their public Audio API access.

How it works

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

The app logins to site using credentials from .env or config file (multiple accounts supported) and saves cookies in cache for re-using. Then it searches songs with given query in vk website (currently from mobile version, m.vk.com) and parses it to an array. It will save parsed data in cache and will return JSON.

Search

Search results are cached for 24 hours by default.

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

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. 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.

In web version of VK, there is no page similar to audio.get, so we can only serve and stream mp3 files that are shown by search function (it searches from cache). But if using S3 as for caching mp3 files, it will search from there.

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 me@alashov.com 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/>.