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

66 lines
2.7 KiB
Markdown
Raw Normal View History

2018-07-05 19:47:18 +02:00
:strawberry: Strawberry Music Player [![Build Status](https://travis-ci.org/jonaski/strawberry.svg?branch=master)](https://travis-ci.org/jonaski/strawberry)
2018-02-27 18:06:05 +01:00
=======================
2018-06-20 15:31:37 +02: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.
2018-06-21 01:50:14 +02:00
It's written in C++ and Qt 5. The name is inspired by the band Strawbs.
2018-02-27 18:06:05 +01:00
2018-06-20 15:31:37 +02:00
### :heavy_check_mark: 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
2018-06-20 15:31:37 +02:00
It has so far been tested to work on Linux, OpenBSD and Windows (cross compiled using mingw).
2018-03-31 16:49:06 +02:00
2018-06-20 15:31:37 +02:00
### :heavy_exclamation_mark: Requirements
2018-03-31 16:49:06 +02:00
2018-06-20 15:31:37 +02:00
To build Strawberry from source you need the following installed on your system with the additional development packages/headers:
2018-03-31 16:49:06 +02:00
2018-07-03 18:23:05 +02:00
* [GLib, GIO and GObject](https://developer.gnome.org/glib/)
* [POSIX thread (pthread) libraries](http://www.yolinux.com/TUTORIALS/LinuxTutorialPosixThreads.html)
* [CMake and Make tools](https://cmake.org/)
* [GCC](https://gcc.gnu.org/) or [clang](https://clang.llvm.org/) compiler
* [Protobuf library and compiler](https://developers.google.com/protocol-buffers/)
* [Boost development headers](https://www.boost.org/)
2018-07-06 21:56:13 +02:00
* [Qt 5 with components Core, Gui, Widgets, Concurrent, Network, Sql, Xml, OpenGL, X11Extras and DBus](https://www.qt.io/)
2018-07-03 18:23:05 +02:00
* [SQLite3](https://www.sqlite.org)
* [TagLib 1.11.1 or higher](http://taglib.org/)
* [Chromaprint library](https://acoustid.org/chromaprint)
* [ALSA library (linux)](https://www.alsa-project.org/)
* [DBus (linux)](https://www.freedesktop.org/wiki/Software/dbus/)
* [PulseAudio (linux optional)](https://www.freedesktop.org/wiki/Software/PulseAudio/?)
2018-03-31 16:49:06 +02:00
Either GStreamer, Xine or VLC engine is required, but only GStreamer is fully implemented so far.
2018-06-20 15:31:37 +02:00
You should also install the gstreamer plugins base and good, and optionally bad and ugly.
2018-03-31 16:49:06 +02:00
2018-06-21 01:50:14 +02:00
Optional:
2018-06-20 15:31:37 +02:00
* The Qt 5 LastFM library is required for fetching album covers from LastFM.
2018-07-03 18:23:05 +02:00
* [libcdio](https://www.gnu.org/software/libcdio/) - To enable Audio CD support
2018-07-03 18:24:34 +02:00
* [libmtp](http://libmtp.sourceforge.net/) - MTP support.
* [libgpod](http://www.gtkpod.org/libgpod/) - iPod Classic support.
2018-03-31 16:49:06 +02:00
2018-06-20 15:31:37 +02:00
### :wrench: Compiling from source
2018-02-27 18:06:05 +01:00
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).