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

89 lines
4.1 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-11-19 01:09:12 +01:00
[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=FRJUYV5QP6HW8)
2018-02-27 18:06:05 +01:00
=======================
2018-06-20 15:31:37 +02:00
2018-11-19 01:38:55 +01:00
Strawberry is a audio player and music collection organizer. It is a fork of Clementine released in 2018 aimed at music collectors, audio enthusiasts and audiophiles. The name is inspired by the band Strawbs. It's based on a heavily modified version of Clementine created in 2012-2013. It's written in C++ and Qt 5.
2018-02-27 18:06:05 +01:00
2018-12-02 16:11:51 +01:00
* Website: https://www.strawbs.org/
2018-09-15 13:46:29 +02:00
* Github: https://github.com/jonaski/strawberry
* Buildbot: http://buildbot.strawbs.net/
2018-12-02 16:11:51 +01:00
* Latest builds: https://builds.strawbs.org/
2018-09-15 13:43:33 +02: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
2019-01-06 00:32:58 +01:00
* Supports WAV, FLAC, WavPack, DSF, DSDIFF, Ogg Vorbis, Speex, MPC, TrueAudio, AIFF, MP4, MP3, ASF and Monkey's Audio.
2018-09-15 00:22:10 +02:00
* Audio CD playback
* Native desktop notifications
* Playlists in multiple formats
2018-11-19 01:12:32 +01:00
* Advanced audio output and device configuration for bit-perfect playback on Linux
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-08-29 23:26:14 +02:00
* Album cover art from Last.fm, Musicbrainz and Discogs
2018-09-15 00:22:10 +02:00
* Song lyrics from AudD and API Seeds
* Support for multiple backends
2018-09-15 00:22:10 +02:00
* Audio analyzer
* Audio equalizer
2018-05-08 19:55:53 +02:00
* Transfer music to iPod, iPhone, MTP or mass-storage USB player
* Streaming support for Tidal and Deezer
* Scrobbler with support for Last.fm, Libre.fm and ListenBrainz
2018-02-27 18:06:05 +01:00
2018-12-23 19:07:20 +01:00
It has so far been tested to work on Linux, OpenBSD, macOS and Windows.
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-12-28 17:15:27 +01:00
* [Qt 5 with components Core, Gui, Widgets, Concurrent, Network and Sql](https://www.qt.io/)
2018-12-23 19:07:20 +01:00
* [Qt 5 components X11Extras and DBus for Linux/BSD, MacExtras for macOS and WinExtras for Windows](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
2018-10-20 22:13:21 +02:00
Either GStreamer, Xine, VLC, Deezer or Phonon 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-10-19 20:42:58 +02:00
Deezer streams with full songs are encrypted and only urls for preview streams (MP3) are exposed by the API.
Full length songs requires the use of deezers own engine (Deezer SDK).
The Deezer SDK can be found here: https://build-repo.deezer.com/native_sdk/deezer-native-sdk-v1.2.10.zip
2018-10-19 20:37:42 +02:00
2018-06-21 01:50:14 +02:00
Optional:
2018-06-20 15:31:37 +02:00
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).
2018-10-02 00:38:52 +02:00
2018-10-21 20:49:35 +02:00
### :computer: Screenshot
2018-03-31 16:49:06 +02:00
2018-10-21 20:49:35 +02:00
![Browse](https://www.strawbs.org/pictures/screenshot-002-large.png)
2018-11-19 01:09:12 +01:00
### :moneybag: Donate
[![paypal](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=FRJUYV5QP6HW8)