mirror/tomahawk
1
0
Fork 0
mirror of https://github.com/tomahawk-player/tomahawk.git synced 2025-08-29 00:30:04 +02:00
Code Issues Releases Wiki Activity

More clean ups.

Browse Source
This commit is contained in:
Christian Muehlhaeuser
2014-10-04 07:54:39 +02:00
parent 741ee123e8
commit c481280162
1 changed files with 16 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files

41
README.md
View File

@@ -1,27 +1,23 @@
TOMAHAWK # TOMAHAWK
========
WHAT TOMAHAWK IS ## WHAT TOMAHAWK IS
================
Tomahawk is a free multi-source and cross-platform music player. An application that can play not only your local files, but also stream from services like Spotify, Beats, SoundCloud, Google Music, YouTube and many others. You can even connect with your friends' Tomahawks, share your musical gems or listen along to them. Let the music play! Tomahawk is a free multi-source and cross-platform music player. An application that can play not only your local files, but also stream from services like Spotify, Beats, SoundCloud, Google Music, YouTube and many others. You can even connect with your friends' Tomahawks, share your musical gems or listen along to them. Let the music play!
![Tomahawk Screenshot](/data/screenshots/tomahawk-screenshot.png?raw=true) ![Tomahawk Screenshot](/data/screenshots/tomahawk-screenshot.png?raw=true)
HOW TOMAHAWK WORKS ## HOW TOMAHAWK WORKS
==================
Tomahawk is basically a **music metadata player**. At its core it decouples the metadata about a song from the source and reassembles it for each user based on their individual music accessibility and rights. In short, given the name of a song and artist Tomahawk will find the right source, for the right user at the right time. This fundamentally different approach to music enables a range of new music consumption and sharing experiences previously not possible. Tomahawk is basically a **music metadata player**. At its core it decouples the metadata about a song from the source and reassembles it for each user based on their individual music accessibility and rights. In short, given the name of a song and artist Tomahawk will find the right source, for the right user at the right time. This fundamentally different approach to music enables a range of new music consumption and sharing experiences previously not possible.
MUSIC SOURCES ## MUSIC SOURCES
=============
It continues to change and evolve, but at the time of this writing: It continues to change and evolve, but at the time of this writing:
* Local music (e.g. iTunes) library * Local music (e.g. iTunes) library
* Networked music libraries (other connected computers) * Networked music libraries (other connected computers)
Subscription Music Services Resolvers ### Subscription Music Services Resolvers
* Spotify * Spotify
* Beats Music * Beats Music
@@ -30,7 +26,7 @@ Subscription Music Services Resolvers
* Rdio (Android only) * Rdio (Android only)
* Deezer (Android only) * Deezer (Android only)
Free Streaming/Music Promotion Platforms ### Free Streaming/Music Promotion Platforms
* Soundcloud * Soundcloud
* Bandcamp * Bandcamp
@@ -38,7 +34,7 @@ Free Streaming/Music Promotion Platforms
* Jamendo * Jamendo
* Official.fm * Official.fm
Network/Cloud storage ### Network/Cloud storage
* Ampache * Ampache
* Owncloud * Owncloud
@@ -51,8 +47,7 @@ Packaged binary resolvers (.axes) are available: [here](http://teom.org/axes).
Source code (and examples) can be found in our [Resolver repository](https://github.com/tomahawk-player/tomahawk-resolvers). Source code (and examples) can be found in our [Resolver repository](https://github.com/tomahawk-player/tomahawk-resolvers).
DOWNLOAD TOMAHAWK ## DOWNLOAD TOMAHAWK
=================
You can download one of our nightly or stable builds: You can download one of our nightly or stable builds:
@@ -61,13 +56,10 @@ You can download one of our nightly or stable builds:
|**NIGHTLY** | [**nightly**](http://download.tomahawk-player.org/nightly/mac/Tomahawk-latest.dmg) | [**nightly**](http://download.tomahawk-player.org/nightly/windows/tomahawk-latest.exe) | *N/A* | |**NIGHTLY** | [**nightly**](http://download.tomahawk-player.org/nightly/mac/Tomahawk-latest.dmg) | [**nightly**](http://download.tomahawk-player.org/nightly/windows/tomahawk-latest.exe) | *N/A* |
|**STABLE** | [**v0.7**](http://download.tomahawk-player.org/Tomahawk-0.7.0.dmg) | [**v0.7**](http://download.tomahawk-player.org/tomahawk-0.7.0.exe) | [**v0.7**](http://www.tomahawk-player.org/download.html#linux) (various distros) | |**STABLE** | [**v0.7**](http://download.tomahawk-player.org/Tomahawk-0.7.0.dmg) | [**v0.7**](http://download.tomahawk-player.org/tomahawk-0.7.0.exe) | [**v0.7**](http://www.tomahawk-player.org/download.html#linux) (various distros) |
BUILD TOMAHAWK ## BUILD TOMAHAWK
==============
... or you can compile it yourself: ... or you can compile it yourself:
Compile:
$ mkdir build && cd build $ mkdir build && cd build
$ cmake .. $ cmake ..
$ make $ make
@@ -90,7 +82,7 @@ Compile:
* [Windows](http://wiki.tomahawk-player.org/index.php/Building_Windows_Binary) * [Windows](http://wiki.tomahawk-player.org/index.php/Building_Windows_Binary)
### Source-Code Documentation ### Developer Documentation
See our [doxygen documentation](http://dev.tomahawk-player.org/api/classes.html) See our [doxygen documentation](http://dev.tomahawk-player.org/api/classes.html)
@@ -114,7 +106,7 @@ Required dependencies:
* [Sparsehash](https://code.google.com/p/sparsehash/) * [Sparsehash](https://code.google.com/p/sparsehash/)
* [GnuTLS](http://gnutls.org/) * [GnuTLS](http://gnutls.org/)
The following dependencies are *optional* (but recommended): The following dependencies are optional (but *recommended*):
* [Jreen 1.0.5](http://qutim.org/jreen/) (1.1.0 will fail, 1.1.1 is fine) * [Jreen 1.0.5](http://qutim.org/jreen/) (1.1.0 will fail, 1.1.1 is fine)
* [Snorenotify](https://github.com/Snorenotify/Snorenotify/) * [Snorenotify](https://github.com/Snorenotify/Snorenotify/)
@@ -128,21 +120,20 @@ Third party libraries that we ship with our source:
* [SPMediaKeyTap](https://github.com/nevyn/SPMediaKeyTap/) * [SPMediaKeyTap](https://github.com/nevyn/SPMediaKeyTap/)
* [kdSingleApplicationGuard](http://www.kdab.com/) * [kdSingleApplicationGuard](http://www.kdab.com/)
SUPPORT TOMAHAWK ## SUPPORT TOMAHAWK
================
* [Open Issues](https://bugs.tomahawk-player.org/secure/Dashboard.jspa) * [Open Issues](https://bugs.tomahawk-player.org/secure/Dashboard.jspa)
* [Translations](https://www.transifex.com/projects/p/tomahawk/) * [Translations](https://www.transifex.com/projects/p/tomahawk/)
* [Donate](https://flattr.com/thing/169312/Tomahawk) * [Donate](https://flattr.com/thing/169312/Tomahawk)
GET HELP ## GET HELP
========
* [Support & Feedback](http://tomahawk.uservoice.com) * [Support & Feedback](http://tomahawk.uservoice.com)
* Chat with Us (IRC): #tomahawk (on Freenode) * Chat with Us (IRC): #tomahawk (on Freenode)
* [Twitter](http://twitter.com/tomahawk) * [Twitter](http://twitter.com/tomahawk)
* [Facebook](http://facebook.com/tomahawkplayer) * [Facebook](http://facebook.com/tomahawkplayer)
SCREENSHOTS ## SCREENSHOTS
===========
BROWSE FRIENDS' MUSIC & LISTEN ALONG BROWSE FRIENDS' MUSIC & LISTEN ALONG