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

109 lines
5.9 KiB
Markdown
Raw Normal View History

2020-01-24 17:27:29 +01:00
:strawberry: Strawberry Music Player [![Build Status](https://github.com/strawberrymusicplayer/strawberry/workflows/C/C++%20CI/badge.svg)](https://github.com/strawberrymusicplayer/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
2020-07-18 04:47:54 +02:00
Strawberry is a music player and music collection organizer. It is a fork of Clementine released in 2018 aimed at music collectors and audiophiles. It's written in C++ using the Qt 5 or 6 toolkit.
2018-02-27 18:06:05 +01:00
2020-03-12 19:27:00 +01:00
![Browse](https://www.strawberrymusicplayer.org/pictures/screenshot-002-large.png)
2020-03-07 15:19:11 +01:00
Resources:
2019-09-24 00:06:37 +02:00
* Website: https://www.strawberrymusicplayer.org/
2020-03-22 19:39:24 +01:00
* Forum: https://forum.strawberrymusicplayer.org/
2020-01-24 17:27:29 +01:00
* Github: https://github.com/strawberrymusicplayer/strawberry
2020-03-22 00:17:40 +01:00
* Buildbot: https://buildbot.strawberrymusicplayer.org/
2019-09-24 00:06:37 +02:00
* Latest builds: https://builds.strawberrymusicplayer.org/
2020-03-07 15:19:11 +01:00
* openSUSE buildservice: https://build.opensuse.org/package/show/home:jonaski:audio/strawberry
* PPA: https://launchpad.net/~jonaski/+archive/ubuntu/strawberry
* Translations: https://translate.zanata.org/iteration/view/strawberry/master
2018-09-15 13:43:33 +02:00
2020-06-25 13:59:29 +02:00
### :bangbang: Opening an issue:
2020-06-25 14:12:54 +02:00
* Search for the issue to see if it is already solved, or if there is an open issue for it already. If there is an open issue already, you can comment on it if you have additional information that could be useful to us.
2020-06-25 13:59:29 +02:00
* For technical problems, questions and feature requests please use our forum on https://forum.strawberrymusicplayer.org/ that is better suited for discussion. It also better allows answers from the community instead of just the developers on GitHub.
### :moneybag: Sponsoring:
2020-05-14 22:12:55 +02:00
The program is free software, released under GPL. If you like this program and can make use of it, consider sponsoring or donating to help fund the project.
2020-03-12 19:36:07 +01:00
To sponsor, visit [my GitHub sponsors profile](https://github.com/sponsors/jonaski).
Funding developers through GitHub Sponsors is one more way to contribute to open source projects you appreciate, it helps developers get the resources they need, and recognize contributors working behind the scenes to make open source better for everyone.
You can also make a one-time payment through [paypal.me/jonaskvinge](https://paypal.me/jonaskvinge)
2018-06-20 15:31:37 +02:00
### :heavy_check_mark: Features:
2018-02-27 18:06:05 +01:00
* Play and organize music
2020-06-26 20:35:13 +02:00
* Supports WAV, FLAC, WavPack, 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
2020-09-17 17:49:39 +02:00
* Playlist management
2020-09-29 23:26:26 +02:00
* Smart and dynamic playlists
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
2020-05-09 01:48:08 +02:00
* Album cover art from [Last.fm](https://www.last.fm/), [Musicbrainz](https://musicbrainz.org/), [Discogs](https://www.discogs.com/), [Musixmatch](https://www.musixmatch.com/), [Deezer](https://www.deezer.com/), [Tidal](https://www.tidal.com/), [Qobuz](https://www.qobuz.com/) and [Spotify](https://www.spotify.com/)
* Song lyrics from [AudD](https://audd.io/), [Genius](https://genius.com/), [Musixmatch](https://www.musixmatch.com/), [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
* Transfer music to iPod, MTP or mass-storage USB player
2019-12-11 20:21:03 +01:00
* Scrobbler with support for [Last.fm](https://www.last.fm/), [Libre.fm](https://libre.fm/) and [ListenBrainz](https://listenbrainz.org/)
2020-09-17 17:49:39 +02:00
* Subsonic, Tidal and Qobuz streaming support
2020-02-25 01:08:03 +01:00
2018-02-27 18:06:05 +01:00
2020-07-13 20:40:34 +02:00
It has so far been tested to work on Linux, OpenBSD, FreeBSD, macOS and Windows.
2018-03-31 16:49:06 +02:00
2020-07-13 20:39:01 +02:00
**There currently isn't any macOS developers actively working on this project, so we might not be able to help you with issues related to macOS.**
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/)
2020-07-18 04:47:54 +02:00
* [Qt 5.8 or higher (or Qt 6) with components Core, Gui, Widgets, Concurrent, Network and Sql](https://www.qt.io/)
* [Qt 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/?)
2020-07-16 00:59:46 +02:00
* [GStreamer](https://gstreamer.freedesktop.org/) or [VLC](https://www.videolan.org)
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/)
2019-04-18 15:03:01 +02:00
* Moodbar: [fftw3](http://www.fftw.org/)
2018-03-31 16:49:06 +02:00
2020-07-16 00:59:46 +02:00
Either GStreamer 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
2020-08-01 23:46:59 +02:00
With Qt 6 we also depend on the Core5Compat module for QTextCodec.
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
2020-01-24 17:27:29 +01:00
git clone https://github.com/strawberrymusicplayer/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
2020-08-01 23:46:59 +02:00
To compile with Qt 6 use: cmake .. -DWITH_QT6=ON
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)