strawberry-audio-player-win.../README.md

69 lines
2.3 KiB
Markdown
Raw Normal View History

2017-05-07 14:41:46 +02:00
Strawberry Music Player
2018-02-27 18:06:05 +01:00
=======================
README
2018-05-01 22:36:28 +02:00
------
2018-02-27 18:06:05 +01:00
2018-05-01 22:36:28 +02:00
Strawberry is a audio player and music collection organizer. It is a fork of Clementine created in 2013 with a diffrent goal.
It's written in C++ and Qt5. The name is inspired by the band Strawbs.
2018-02-27 18:06:05 +01:00
2018-05-01 22:36:28 +02:00
### Features:
2018-02-27 18:06:05 +01:00
* Play and organize music
* Native desktop notifications
* Playlists in multiple formats
2018-05-08 19:55:53 +02:00
* Edit tags on music files
2018-05-01 22:36:28 +02:00
* Fetch tags from MusicBrainz
2018-05-08 19:55:53 +02:00
* Album cover art from Lastfm, Musicbrainz, Discogs and Amazon
* Support for multiple backends
2018-05-08 19:55:53 +02:00
* Transfer music to iPod, iPhone, MTP or mass-storage USB player
2018-02-27 18:06:05 +01:00
You can obtain and view the sourcecode on github at: https://github.com/jonaski/strawberry
It has so far been tested on Linux and cross compiled for Windows. I have not had a chance to test it on Mac OS X since I don't have a mac.
2018-03-31 16:49:06 +02:00
Requirements
------------
To build Strawberry from source you need the following installed on your system:
* glib2, glib2-devel, git, cmake, make, gcc and gcc-c++
* protobuf and development packages
* boost development headers
2018-03-31 16:49:06 +02:00
2018-05-07 21:32:40 +02:00
* The following Qt5 components are required with additional development packages: Qt5Core, Qt5Widgets, Qt5Network, Qt5Sql, Qt5Xml, Qt5OpenGL, Qt5Concurrent, Qt5Test, 5X11Extras, Qt5WebKit, Qt5WebKitWidget and Qt5DBus.
2018-03-31 16:49:06 +02:00
* ALSA and libasound2 with development files
* SQLite3 with development files
2018-05-07 21:32:40 +02:00
* TagLib 1.8 or higher with development files
2018-05-08 19:55:53 +02:00
* libchromaprint with development files
2018-03-31 16:49:06 +02:00
* libglu with development files
Either GStreamer, Xine or VLC engine is required, but only GStreamer is fully implemented so far.
You should also install the gstreamer plugins: gstreamer-plugins-base, gstreamer-plugins-good and gstreamer-plugins-bad
* The Qt5 specific LastFM library and development files are required for fetching album covers from LastFM.
* To enable CD support for playing audio cd's you need libcdio.
* If you want MTP support you need libmtp.
* If you need iPod Classic support you need libgpod.
2018-02-27 18:06:05 +01:00
Compiling from source
---------------------
2018-05-01 22:36:28 +02:00
### Get the code:
2018-02-27 18:06:05 +01:00
2018-03-31 16:49:06 +02:00
git clone https://github.com/jonaski/strawberry
2018-02-27 18:06:05 +01:00
2018-05-01 22:36:28 +02:00
### Compile and install:
2018-02-27 18:06:05 +01:00
mkdir strawberry-build
cd strawberry-build
cmake ../strawberry
2018-03-31 16:49:06 +02:00
make -j8
2018-02-27 18:06:05 +01:00
sudo make install
2018-03-31 16:49:06 +02:00
(dont change to the source directory, if you created the build directory inside the source directory type: cmake .. instead).