Skip to content
Resolver plugins for Tomahawk Player
C++ JavaScript Objective-C C Objective-C++ Python Other
Failed to load latest commit information.
4shared/content [4shared] API no longer returns mp3 URL, parse file page instead
8tracks/content Make descriptions more consistent. Add periods.
admin When making an .axe file, include iconWhite and iconBackground if ava…
amazon/content Get rid of ResolverCapability
ampache/content [ampache] Handle collection revisions. Use "add" instead of "updated"…
archive Get rid of ResolverCapability
authproxy [authproxy] Add basic Spotify handling
bandcamp Get rid of ResolverCapability
bandcampmobile/content [bandcampmobile] Promise => RSVP.Promise
beatsmusic Get rid of ResolverCapability
beets/content [beets] bump version
deezer-metadata/content Get rid of ResolverCapability
deezer/content Get rid of ResolverCapability
docs Add favicon and github to docs
examples Get rid of ResolverCapability
gmusic Get rid of ResolverCapability
hatchet-metadata/content [hatchet-metadata] Fix processing of playlist links in lookupUrl
jamendo/content [jamendo] Only resolve a maximum of 5 results per track
jazz-on-line s/\t/ /g
lastfm/content Get rid of ResolverCapability
muzebra * Renamed muzebra resolver.
netease/content [netease]Fix stream url. version bump
officialfm/content [officialfm] Complete rework. Moved over to 0.9 resolver API
prostopleer/content player resolver doesn't return anything when searching with unencoded…
qobuz/content [youtube] Always prepend underscore for internally used functions' names
rhapsody/content Get rid of ResolverCapability
soundcloud/content Get rid of ResolverCapability
spotify-metadata/content Get rid of ResolverCapability
spotify Get rid of ResolverCapability
subsonic/content [subsonic] Handle collection revisions. Fix fetching of tracks. Bump …
synology-audiostation/content Get rid of ResolverCapability
test [test] Split helper function into two
tidal/content Get rid of ResolverCapability
tomahawk-metadata/content [tomahawk-metadata] Updated to 0.9 resolver api
tomahk-metadata/content [tomahk-metadata] Fix parsing of track links. Bumped version to 0.2.2
tools Add tool to query the stream URL for (artist, track, album)
vibe3/content [vibe3] add link to search result page as icon click action
vkontakte/content Get rid of ResolverCapability
youtube-metadata/content Get rid of ResolverCapability
youtube/content [youtube]print regex source from regex object instead of copy-paste [zv]title->track
.gitignore Added IntelliJ specific files to .gitignore Fix link in Update Urllookup capabilities in chart.
bower.json Add bower package file
package.json Depend on node-tomahawkjs@0.3.4

Tomahawk Resolvers

Supported resolvers are distributed and updated automatically through Tomahawk's Settings dialog. To manually install a resolver either

After you have the files locally, open Tomahawk's preferences and from the "Services" tab click "Install from File" and select the .axe or .js file for the resolver you are installing.

Since March 2013 Tomahawk resolvers have switched to a new directory structure for easy packaging. Ideally, you should download nightly .axe files, if available.

For developer documentation, see


Not all resolvers feature the same capabilities, this is either due to the lacking capabilities of the service they connect to or that the capability is not yet implemented. Some of the features need authentication (e.g. being a premium subscriber to this service), some can be used without any subscription or authentication at all.

Available Capabilities:

  • Resolving: Given a tuple of Artist,Track (or a triple Artist,Album,Track) return a stream URL (and some metadata about it) so that one can play this track.
  • Search: (Fuzzily) find tracks, artists and albums on all services matching a query that can be streamed.
  • Open Artist URL: Given an URL about an artist of a service, return the information about that. (This opens the artist page in Tomahawk).
  • Open Album URL: Given an URL about an album of a service, return the information about that. (This opens the album page in Tomahawk).
  • Open Playlist: Given an URL about a playlist of a service, return the information about that. (This imports the playlist in Tomahawk if it was not previously imported)
  • Open Track URL: Given an URL about a track of a service, return the information about that. (This opens the track page in Tomahawk and plays it).
  • Collection: Browse the collection of music stored by the user in this service.


  • ✔ - Supports without authentication
  • :key: - Authentication required
  • ? - Unknown
  • ✘ - No support for this capability


  • Some services can search without being authenticated but only resolve after authentication. At the moment, we do not support this in Tomahawk but this may change in future.
Resolver Resolving Search Open Artist URL Open Album URL Open Playlist Open Track URL Collection
ampache :key: :key: :key:
beatsmusic :key: :key:
beets :key: :key: :key:
grooveshark :key: :key:
jazz-on-line ? ? ? ? ? ? ?
qobuz :key: :key:
spotify :key: :key: :key:
subsonic :key: :key: :key:
synology-audiostation :key: :key: :key:
Something went wrong with that request. Please try again.