Frequently Asked Questions (FAQ)
Network issues
Because music services have regional restrictions, Murglar has built-in proxies in different regions.
Murglar has automatic proxy configuration (General settings → Configure proxy automatically) that picks optimal proxy settings for all services, based on your current region, the services you use and whether you have subscriptions. Note that automatic configuration determines your current region by your device's IP address. So if you're using a VPN, the settings will use the region of your VPN server rather than where you actually are.
If automatic configuration doesn't solve the issue, set up a proxy manually using the info below:
Regional restrictions of music services
VKontakte, Yandex Music, Zvuk — most tracks or the service itself are only available from CIS IPs (if you don't have a service subscription)
If you are outside the CIS, use the Russia proxy
If you are in Ukraine, use the Moldova proxy
SoundCloud — some tracks have restrictions
Use the United Kingdom proxy
Deezer — the free tier is only available in some regions
Use the United Kingdom proxy
Proxy settings for different purposes
In settings, you can fine-tune which proxy applies to which service if auto-setup gets it wrong, or you want to override it:
General settings → Proxy for Murglar server — murglar.app, GitHub for downloading updates
General settings → Proxy for lyrics/cover providers — iTunes, MusixMatch, Genius and cover CDNs of music services
Music service settings → Proxy for login and API — the service's API and its website for web login
Music service settings → Proxy for content — the service's track content CDNs
Issues with logging into service accounts
Whenever possible, log into services using "Login with web", and first make sure the service's proxy in settings is set appropriately (see the section above about network issues and regional restrictions).
Also remember that logging in via social buttons (including Google) doesn't work — first log into the music service account in the official app or on the website, link a regular email and password in your account settings, and only then log into Murglar with them.
On Android, make sure you have the latest update of the Android System WebView installed. If it's missing from Google Play (which can happen on older devices) and Murglar still warns that your version is outdated, try installing WebView from apkmirror, and ensure the installed WebView is selected on your device in "Developer options" → "WebView implementation".
If web login still doesn't work (black screen on desktop, unable to update WebView, won't proceed to the next step, the auth page looks broken, or you can't pass a captcha), then you can log into each service using tokens/cookies copied from Murglar on another device/platform, or obtain them as follows:
VKontakte
Log into your account in a browser at vk.ru
Open https://oauth.vk.ru/authorize?client_id=7793118&scope=offline,audio,friends,groups,wall&response_type=token and grant access
After a while you'll be redirected to a white page with a warning text, but the address bar will contain an
access_tokenparameter likevk1.a.***************Copy the token value (between
access_token=and&expires_in, the&at the end is not a part of the token) — this will be "Token 1"Repeat steps 2–4 but open https://oauth.vk.ru/authorize?client_id=6463690&scope=offline,audio,friends,groups,wall&response_type=token — this will give you "Token 2"
Paste both tokens into the corresponding fields in "Login with token" in Murglar
Yandex Music
Log into your account in a browser at music.yandex.ru
Open https://oauth.yandex.ru/authorize?response_type=token&client_id=23cabbbdc6cd418abb4b39c32c41195d and grant access
After a while you'll be redirected to Yandex Music's homepage, but the address bar will contain an
access_tokenparameter likey0__*****-*********Copy the token value (between
access_token=and&token_type, the&at the end is not a part of the token) and paste it into the "Token" field in "Login with token" in Murglar
SoundCloud
Log into your account in a desktop browser at soundcloud.com
Open Developer Tools (F12 in Chrome)
Open the "Applications" tab at the top
In the left pane select "Cookies" → "https://soundcloud.com"
On the right, find the oauth_token field in the table
Copy the oauth_token value and paste it into the "Token" field in "Login with token" in Murglar
Deezer
Log into your account in a desktop browser at deezer.com
Open Developer Tools (F12 in Chrome)
Open the "Applications" tab at the top
In the left pane select "Cookies" → "https://www.deezer.com"
On the right, find the arl field
Copy the arl value and paste it into the "arl cookie" field in "Cookie login" in Murglar
Zvuk
Log into your account in a browser at zvuk.com
Open https://zvuk.com/api/tiny/profile — you'll see a JSON response
Find the token field in the response, like
"token":"a3004**********************60f35"Copy the alphanumeric token value without quotes and paste it into the "Token" field in "Login with token" in Murglar
WebDav
To log into Mail.ru Cloud or Yandex Disk, you need an app password rather than your account password:
Known issues with music services
Yandex Music
In "My Vibe" the track "Promo code Upgrade" may loop:
Yandex Music ran several ban waves for using mods that bypass Yandex Plus subscription.
There is no way to bypass this limitation. The only options are to pay for a subscription (activate a promo code) or create a new Yandex Music account.
SoundCloud
Likes are temporarily disabled because they didn't work due to the security system used by SoundCloud — DataDome Captcha
Murglar Android
Player stops or stutters when the screen is locked
Make sure ALL power-saving optimizations available in your device's firmware are disabled for Murglar — background activity settings/auto-start/lock in recents/anything else.
If you use Murglar's integration with other players, ensure restrictions are disabled for both the player and Murglar itself.
You can find more details at DontKillMyApp and in your device's threads on XDA.
Cache gets completely wiped periodically
Murglar never deletes a cache on its own (except when it hits the configured maximum cache size — in that case the tracks least recently played are removed first).
If you are facing this, your firmware has some kind of "optimization manager" or there's a third-party app that cleans cache (e.g., SD Maid).
To fix it, add Murglar to exclusions or disable automatic cache cleaning entirely — most of the time it causes more harm than good.
If you can't fix the "optimizer" settings, go to Murglar "Settings" → "Cache" → "Cache folder" → select "As data" instead of "As cache".
Downloaded tracks aren't in the cache
They're not supposed to be.
Murglar can download and cache:
Downloading saves files to a chosen folder in the file system for later playback in other players and other actions
Caching (what many official music apps incorrectly call "downloading") saves files to the app cache in a specially optimized format for later playback in Murglar or through integration with other players without an internet
So if you plan to listen in third-party players — use downloading, and if you want to listen in Murglar or another player via integration with Murglar — use caching.
The down arrow icon in Murglar means downloading; the floppy disk icon is caching or its state (filled icon — the track is fully cached, hollow — partially).
Murglar does not use downloaded files as cache, because tracks are downloaded to various paths (depending on templates) into a user-accessible folder where user can delete/move/rename tracks. As a result, the app has no control over track integrity and metadata and cannot use them as cache.
Can't select a download folder; on download get "Grant permissions" or "Reselect download folder" error
If in "Settings" → "Downloader" → "Folder selection method" you see "FileIO" and the item is greyed out, your firmware is missing the system "Files" component (com.android.documentsui or com.google.android.documentsui).
Possible reasons:
You disabled the "Files" app in device settings or via ADB — in that case simply enable it back
You're using a device with incomplete firmware where "Files" weren't present (this happens with some Chinese car head units and TV boxes). In that case try to install "Files" that are appropriate for your Android version and device brand:
Integration with third-party players
Murglar provides a document provider through which third-party players can access your library in music services.
Supported players and how to enable integration
Poweramp
The best player with full integration support
In Poweramp go to "Settings" → "Library" → "Music Folders"
Tap "Add folder or storage" → "Continue"
Open the side menu (by swiping from the left edge or tapping the hamburger icon at the top left) and select the required service with the Murglar icon
Tap "Select" (or "Use this folder") at the bottom → "Allow" — the selected service will appear in the folder list
Important! Uncheck the service item
Expand the service item and select only the sections you need (otherwise scanning will take a very long time, especially if you select artists)
Tap "Save and scan" and wait for the scan to complete
AIMP
Almost all functionality is supported, except seeking
Launch AIMP and in any playlist tap the "+" button at the bottom → "Add files" → tap "+" at the top → "Local folder"
Open the side menu (by swiping from the left edge or tapping the hamburger icon at the top left) and select the required service with the Murglar icon
Tap "Select" (or "Use this folder") at the bottom → "Allow"
The service folder will now be visible on the "Home screen"
BubbleUPnP
Content can be played, but there is no detailed metadata, covers or proper list sorting
In BubbleUPnP go to "Settings" → "Local and cloud" → "Storages and mount points" → "Mount point" → "Pick a Folder"
Open the side menu (by swiping from the left edge or tapping the hamburger icon at the top left) and select the required service with the Murglar icon
Tap "Select" (or "Use this folder") at the bottom → "Allow"
The new mount point will now be visible in the "Library"
Neutron Music Player
Content can be played, but integration is almost unusable — numbers instead of names, no metadata or covers, etc.
In Neutron go to "Settings" → "Media Library" → "Sources"
Tap the "+" button at the bottom → "File System" → "+"
Open the side menu (by swiping from the left edge or tapping the hamburger icon at the top left) and select the required service with the Murglar icon
Tap "Select" (or "Use this folder") at the bottom → "Allow"
Open the newly added storage and choose the required folders inside
Tap "✓" at the bottom and wait for the scan to complete
Other players may also be supported if they can work correctly with SAF (Storage Access Framework)
Players designed for local content usually work in the most straightforward way — start scanning the entire folder hierarchy, pulling the content of all tracks to parse tags. That's fine for local storage, but unacceptable for clouds/streaming.
For proper integration, a player should:
do not request track content for anything other than playback
read tag data from the provider's metadata, not from track content
preferably not scan the entire library at once, but only when the user opens a specific folder
If the points above aren't followed, it causes hierarchical pulling of the entire contents (both metadata and content) from the music service.
In theory, such a process might eventually finish successfully, but it will take a very long time and in the end the entire service content will end up cached on the device.
In the worst case, some players don't support working with anything other than the local file system at all, which leads to errors.
If your player doesn't support integration, consider contacting its developer and suggesting full support for SAF document providers.
Android Auto
To make Murglar available in Android Auto, you need to enable developer mode and the "Unknown sources" toggle in Android Auto settings on your phone (this is an Android Auto limitation for any app not from Google Play), or install Murglar via KingInstaller.
Murglar Desktop
Murglar doesn't detect an installed VLC
Ensure you have VLC 3.x of the correct architecture installed (most often x64, or arm64 if you have an ARM-based MacBook)
Ensure Murglar was fully restarted after installing VLC — not just closing the window, but also exiting from the tray if minimize-to-tray is enabled (it is by default)
If the above didn't help, just reboot your computer.
VKontakte tracks don't play and keep skipping endlessly
The cause may be a missing GlobalSign ECC OV SSL CA 2018 certificate on your system.
To fix it, install the certificate (example for Windows):
Double-click to open it
Click "Install Certificate" → "Local Machine" → "Place all certificates in the following store" → "Browse" → "Trusted Root Certification Authorities" (second in the list) → OK → Next → Yes
Running in portable mode
By default Murglar stores user data in the user profile folder.
If you need to run Murglar in portable mode, you can do so with the --portable argument (directory containing the Murglar executable will be used as the data folder) or --portable <path to folder> (the specified folder will be used).
Misc
What formats are available in music services
VKontakte
MP3 128–320 kbps, depending on who uploaded the track (users or labels) and in what quality
Yandex Music
MP3 192 kbps/AAC 192 kbps are always available
With a Yandex Plus subscription you get MP3 320 kbps/AAC 256 kbps/FLAC
SoundCloud
MP3 128 kbps is always available
With a SoundCloud Go+ subscription you get AAC 256 kbps
If the author allowed downloading, the original file uploaded by the author will be available — MP3/AAC/WAV/FLAC/OGG/etc.
Deezer
MP3 128 kbps is always available
With a Deezer Premium subscription (or Murglar Pass) you get MP3 320 kbps
With a Deezer Hi-Fi subscription (or Murglar Pass) you get FLAC
Zvuk
MP3 128 kbps is always available
With a Prime subscription you get MP3 320 kbps/FLAC
WebDAV
The original file uploaded to the cloud is always available
"All sources exhausted"
When downloading or playing tracks, Murglar tries to get content from the music service in the maximum (or chosen in settings) quality. If it's unavailable, Murglar tries the next lower-quality source, and so on, until it gets content or runs out of sources — that results in the "All sources exhausted" error.
Possible reasons:
You're trying to access a track that's unavailable in your region (i.e., your IP region; see the section above about content availability and proxies) — change your region via proxy/VPN
Your service authorization is outdated — relogin into the music service account
The track is completely unavailable in the music service, e.g., removed at the request of the right owner/regulator — you'll have to look for this track in other services
"Device limit exceeded for this account"
The app limits one account to 6 active devices.
If you personally use your Murglar account in good faith and are sure you've used fewer devices over the last 2 months — write to email badmannersteam@gmail.com or Telegram @badmannersteam.
In your message, specify that you hit the limit and include your username or the email of your Murglar account. We'll check and reset the limit.
How to enable scrobbling to Last.fm?
Install the Last.fm app.
Murglar on Android, Windows and Linux sends all metadata to the system media session, so any scrobbler capable of reading from it will work.
Will there be?..
Support for new music services:
YouTube Music, Tidal and Qobuz — yes, in development
Spotify, Apple Music — not soon (if ever), due to technical issues and risk of account bans
Beatport, Bandcamp, Amazon Music and many others — not planned for now, but anyone is welcome to write a plugin — see the Plugin Documentation
iOS version — no, due to distribution issues and iOS limitations
Android TV version — there won't be a separate version, but we'll try to adapt the main Android version for comfortable control with a remote
Release in Flatpak/Snap/AUR/other repos — no. If you want to create and maintain such a release — you can (just let us know)
Bit-perfect output and crossfade — no, until ExoPlayer/VLC add support for it
Chromecast and UPnP/DLNA support — yes
Creating and editing playlists — yes
Export of lists from services (and possibly import/migration) — yes
Export/import of settings/logins — yes
Support for multiple accounts per service — yes