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

123 lines
7.6 KiB
Markdown
Raw Normal View History

2024-04-21 22:35:15 +02:00
:strawberry: Strawberry Music Player [![Build Status](https://github.com/strawberrymusicplayer/strawberry/workflows/Build/badge.svg)](https://github.com/strawberrymusicplayer/strawberry/actions)
2021-10-09 00:39:11 +02:00
=======================
2021-10-09 00:34:28 +02:00
[![Sponsor](https://img.shields.io/badge/-Sponsor-green?logo=github)](https://github.com/sponsors/jonaski)
2020-12-03 22:24:57 +01:00
[![Patreon](https://img.shields.io/badge/patreon-donate-green.svg)](https://patreon.com/jonaskvinge)
2021-10-09 00:34:28 +02:00
[![PayPal](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://paypal.me/jonaskvinge)
2018-06-20 15:31:37 +02:00
2020-10-02 22:09:33 +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 toolkit.
2018-02-27 18:06:05 +01:00
2021-04-11 09:11:24 +02:00
![Browse](https://raw.githubusercontent.com/strawberrymusicplayer/strawberry/master/data/screenshot/screenshot.png)
2020-03-12 19:27:00 +01:00
2020-03-07 15:19:11 +01:00
Resources:
2019-09-24 00:06:37 +02:00
* Website: https://www.strawberrymusicplayer.org/
2022-07-02 22:38:55 +02:00
* Wiki: https://wiki.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
2021-04-10 06:36:18 +02:00
* Ubuntu PPA: https://launchpad.net/~jonaski/+archive/ubuntu/strawberry
* Ubuntu Unstable PPA: https://launchpad.net/~jonaski/+archive/ubuntu/strawberry-unstable
2018-09-15 13:43:33 +02:00
2023-12-09 21:02:18 +01:00
### :bangbang: Opening an issue
2020-06-25 13:59:29 +02:00
2022-07-27 20:43:03 +02:00
* Read the FAQ: https://wiki.strawberrymusicplayer.org/wiki/FAQ
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.
2022-04-07 01:22:21 +02:00
* For technical problems, discussion, questions and feature suggestions use the forum (https://forum.strawberrymusicplayer.org/) instead. The forum is better suited for discussion.
* We do not take feature requests from users on GitHub. Any issues related to feature requests will be closed. This does not necessarily mean that we won't add new features, but we don't have time to take feature requests or answer questions about new features from users. It is still possible to suggest or discuss new features on the forum (https://forum.strawberrymusicplayer.org/).
2023-09-24 13:19:05 +02:00
* We do not maintain the Flatpak package. Do not report issues related to Flatpak unless the issue can be reproduced with a native package, use Flatpak support instead https://flatpak.org/about/
2020-06-25 13:59:29 +02:00
2024-02-18 14:24:20 +01:00
### :moneybag: Sponsoring
2020-06-25 13:59:29 +02:00
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.
2024-01-09 18:08:40 +01:00
There are currently 4 options for sponsoring:
2021-03-03 22:02:41 +01:00
2024-01-09 18:08:40 +01:00
1. [GitHub](https://github.com/sponsors/jonaski)
2021-03-03 22:02:41 +01:00
2. [Patreon](https://www.patreon.com/jonaskvinge)
2023-09-28 16:55:25 +02:00
3. [Ko-fi](https://ko-fi.com/jonaskvinge)
4. [PayPal](https://paypal.me/jonaskvinge)
2021-03-03 22:02:41 +01:00
Funding developers is a 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.
2020-03-12 19:36:07 +01:00
2023-12-09 21:02:18 +01: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
2023-06-29 23:34:26 +02:00
* In-player song loudness analysis and song playback loudness normalization, as per EBU R 128
2021-05-11 22:06:09 +02:00
* Edit tags on audio 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 [Genius](https://genius.com/), [Musixmatch](https://www.musixmatch.com/), [ChartLyrics](http://www.chartlyrics.com/), [lyrics.ovh](https://lyrics.ovh/), [lololyrics.com](https://www.lololyrics.com/), [songlyrics.com](https://www.songlyrics.com/), [azlyrics.com](https://www.azlyrics.com/) and [elyrics.net](https://www.elyrics.net/)
* Support for multiple backends
2018-09-15 00:22:10 +02:00
* Audio analyzer
* Audio equalizer
2021-05-11 22:06:09 +02:00
* Transfer music to mass-storage USB players, MTP compatible devices and iPod Nano/Classic
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
2024-01-09 18:08:40 +01:00
**macOS releases are currently limited to sponsors. This is because Strawberry mainly has one contributor/developer and supporting macOS requires Apple hardware, building libraries Strawberry depends and a Apple developer account for signing releases. If you are sponsoring strawberry through Patreon, releases are available directly on Patreon, if you are sponsoring through GitHub, Ko-fi or Paypal, please e-mail support@strawberrymusicplayer.org for access to downloads.**
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
2021-06-05 22:30:15 +02:00
* [CMake](https://cmake.org/)
2022-11-21 23:40:20 +01:00
* C/C++ compiler ([GCC](https://gcc.gnu.org/), [Clang](https://clang.llvm.org/) or [MSVC](https://visualstudio.microsoft.com/vs/features/cplusplus/))
* [pkg-config](https://www.freedesktop.org/wiki/Software/pkg-config/) or [pkgconf](https://github.com/pkgconf/pkgconf)
2019-07-26 20:52:47 +02:00
* [Boost](https://www.boost.org/)
2019-07-26 20:55:20 +02:00
* [GLib](https://developer.gnome.org/glib/)
2022-01-29 01:33:40 +01:00
* [Qt 6 or Qt 5.12 or higher with components Core, Gui, Widgets, Concurrent, Network and Sql](https://www.qt.io/)
* [SQLite 3.9 or newer with FTS5](https://www.sqlite.org)
2022-03-24 20:32:50 +01:00
* [Protobuf](https://developers.google.com/protocol-buffers/)
* [ALSA (Required on Linux)](https://www.alsa-project.org/)
* [D-Bus (Required on Linux)](https://www.freedesktop.org/wiki/Software/dbus/)
2020-07-16 00:59:46 +02:00
* [GStreamer](https://gstreamer.freedesktop.org/) or [VLC](https://www.videolan.org)
* [TagLib 1.11.1 or higher](https://www.taglib.org/) or [TagParser](https://github.com/Martchus/tagparser)
2022-08-08 00:37:37 +02:00
* [ICU](https://unicode-org.github.io/icu/)
2019-01-24 19:41:21 +01:00
Optional dependencies:
2021-06-05 22:30:15 +02:00
* Song fingerprinting and MusicBrainz tagging: [Chromaprint](https://acoustid.org/chromaprint)
* Moodbar: [fftw3](http://www.fftw.org/)
* PulseAudio integration: [PulseAudio](https://www.freedesktop.org/wiki/Software/PulseAudio/?)
2019-01-24 19:41:21 +01:00
* 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/)
* EBU R 128 loudness normalization [libebur128](https://github.com/jiixyj/libebur128)
2018-03-31 16:49:06 +02:00
2022-03-24 20:32:50 +01:00
You should also install the gstreamer plugins base and good, and optionally bad, ugly and libav to support all audio formats.
2018-03-31 16:49:06 +02:00
2024-02-18 14:24:20 +01: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
2023-10-28 00:56:08 +02:00
git clone --recursive 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
2022-11-21 23:40:20 +01:00
mkdir build
cd build
2022-03-24 20:32:50 +01:00
cmake .. -DBUILD_WITH_QT6=ON
2022-11-21 23:40:20 +01:00
make -j $(nproc)
2018-02-27 18:06:05 +01:00
sudo make install
2020-10-02 22:09:33 +02:00
2022-03-24 20:32:50 +01:00
Strawberry is backwards compatible with Qt 5, to compile with Qt 5 use:
cmake .. -DBUILD_WITH_QT5=ON
2018-03-31 16:49:06 +02:00
2022-11-21 23:40:20 +01:00
To compile on Windows with Visual Studio 2019 or 2022, see https://github.com/strawberrymusicplayer/strawberry-msvc
2024-02-18 14:24:20 +01:00
### :penguin: Packaging status
2019-01-24 19:41:21 +01:00
[![Packaging status](https://repology.org/badge/vertical-allrepos/strawberry.svg?exclude_unsupported=1)](https://repology.org/metapackage/strawberry/versions)