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

95 lines
5.0 KiB
Markdown
Raw Normal View History

2020-01-12 16:34:04 +01:00
:strawberry: Strawberry Music Player [![Build Status](https://github.com/jonaski/strawberry/workflows/C/C++%20CI/badge.svg)](https://github.com/jonaski/strawberry/actions)
2019-12-11 20:45:27 +01:00
[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://paypal.me/jonaskvinge)
2018-02-27 18:06:05 +01:00
=======================
2018-06-20 15:31:37 +02:00
Strawberry is a music 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
2019-09-24 00:06:37 +02:00
* Website: https://www.strawberrymusicplayer.org/
2018-09-15 13:46:29 +02:00
* Github: https://github.com/jonaski/strawberry
2019-09-24 00:06:37 +02:00
* Buildbot: http://buildbot.strawberrymusicplayer.org/
* Latest builds: https://builds.strawberrymusicplayer.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-09-23 21:52:48 +02:00
* Supports WAV, FLAC, WavPack, DSF, DSDIFF, Ogg FLAC, Ogg Vorbis, Ogg Opus, Ogg 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
2019-12-11 20:21:03 +01:00
* Album cover art from [Last.fm](https://www.last.fm/), [Musicbrainz](https://musicbrainz.org/), [Discogs](https://www.discogs.com/), [Deezer](https://www.deezer.com/) and [Tidal](https://tidal.com/)
* Song lyrics from [AudD](https://audd.io/), [ChartLyrics](http://www.chartlyrics.com/), [lyrics.ovh](https://lyrics.ovh/) and [lololyrics.com](https://www.lololyrics.com/)
* 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
2019-10-28 20:06:22 +01:00
* Subsonic streaming support
2019-12-11 20:21:03 +01:00
* Unofficial streaming support for [Tidal](https://tidal.com/) and [Qobuz](https://www.qobuz.com/)
* Scrobbler with support for [Last.fm](https://www.last.fm/), [Libre.fm](https://libre.fm/) and [ListenBrainz](https://listenbrainz.org/)
2019-10-28 20:06:22 +01:00
2019-10-28 20:20:13 +01:00
**Tidal and Qobuz streaming in Strawberry is unofficial. You need an official API token (or App ID/Secret) to use it, we can not provide API tokens, or help getting them. Tidal will not work with Tidal Masters (MQA), because MQA is a proprietary format in lossy quality without an open source decoder, we can't support it.**
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
2020-01-12 17:02:19 +01:00
**We do not provide releases for macOS. There currently isn't any macOS developers actively working on this project.**
2019-08-03 13:15:43 +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
* [CMake and Make tools](https://cmake.org/)
* [GCC](https://gcc.gnu.org/) or [clang](https://clang.llvm.org/) compiler
2019-07-26 20:52:47 +02:00
* [Boost](https://www.boost.org/)
2019-07-26 20:55:20 +02:00
* [POSIX thread (pthread)](http://www.yolinux.com/TUTORIALS/LinuxTutorialPosixThreads.html)
* [GLib](https://developer.gnome.org/glib/)
* [Protobuf library and compiler](https://developers.google.com/protocol-buffers/)
2019-08-03 13:15:43 +02:00
* [Qt 5.5 or higher 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/)
* [SQLite 3.9 or newer with FTS5](https://www.sqlite.org)
2018-07-03 18:23:05 +02:00
* [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/?)
2019-03-09 17:43:20 +01:00
* [GStreamer](https://gstreamer.freedesktop.org/), [Xine](https://www.xine-project.org), [VLC](https://www.videolan.org) or [Phonon](https://techbase.kde.org/Phonon)
2019-04-16 17:48:11 +02:00
* [GnuTLS](https://www.gnutls.org/)
2019-01-24 19:41:21 +01:00
Optional dependencies:
* Audio CD: [libcdio](https://www.gnu.org/software/libcdio/)
* MTP devices: [libmtp](http://libmtp.sourceforge.net/)
* iPod Classic devices: [libgpod](http://www.gtkpod.org/libgpod/)
* iPhone, iPod Touch, iPad and Apple TV devices: [libimobiledevice, libplist and libusbmuxd](https://www.libimobiledevice.org/)
2019-04-18 15:03:01 +02:00
* Moodbar: [fftw3](http://www.fftw.org/)
2018-03-31 16:49:06 +02:00
2019-03-09 17:43:20 +01:00
Either GStreamer, Xine, VLC 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-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
2019-07-26 20:52:47 +02:00
cd strawberry
mkdir build && cd build
cmake ..
make -j4
2018-02-27 18:06:05 +01:00
sudo make install
2018-03-31 16:49:06 +02:00
2019-01-24 19:42:04 +01:00
### :penguin: Packaging status
2019-01-24 19:41:21 +01:00
[![Packaging status](https://repology.org/badge/vertical-allrepos/strawberry.svg)](https://repology.org/metapackage/strawberry/versions)
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
2019-09-24 00:06:37 +02:00
![Browse](https://www.strawberrymusicplayer.org/pictures/screenshot-002-large.png)
2018-11-19 01:09:12 +01:00
### :moneybag: Donate
2019-12-11 20:46:15 +01:00
[![paypal](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://paypal.me/jonaskvinge)