Strawberry Music Player Wiki - User contributions [en]

GStreamer plugins

2026-07-19T10:26:46Z

Jonas:

Strawberry uses GStreamer for the audio backend, to play different audio formats you need different plugins.

On Linux distributions you need to install individual packages to get support for different formats.

Windows and macOS releases have all the listed plugins bundled in the installer.

On Linux plugin files are usually installed in a directory called <code>gstreamer-1.0</code>, examples are.: <code>/usr/lib/gstreamer-1.0</code> or <code>/usr/lib64/gstreamer-1.0</code>

The gstreamer plugin files are called <code>libgstPLUGIN.so</code>, for example <code>libgstflac.so</code>

== gst-inspect ==

To check if a plugin is installed and properly detected, you can use.:

gst-inspect-1.0 <plugin>

For example.:

gst-inspect-1.0 flac

Returns:

Plugin Details:
Name flac
Description The FLAC Lossless compressor Codec
Filename /usr/lib64/gstreamer-1.0/libgstflac.so
Version 1.20.3
License LGPL
Source module gst-plugins-good
Source release date 2022-06-15
Binary package openSUSE GStreamer-plugins-good package
Origin URL http://download.opensuse.org

flacdec: FLAC audio decoder
flacenc: FLAC audio encoder
flactag: FLAC tagger

3 features:
+-- 3 elements

== Always required ==

These are not tied to any particular audio format, but are needed for any playback at all. <code>coreelements</code> ships as part of GStreamer itself (not a separate <code>gst-plugins-*</code> package), the rest ship inside gst-plugins-base, which is effectively always installed alongside GStreamer.

{|
|-
! style="text-align:left;" | Plugin !! style="text-align:left;" | Type
|-
| coreelements || Core elements (queue, filesrc, typefind, ...), part of GStreamer itself
|-
| playback || Core playback framework (playbin/playbin3/decodebin/decodebin3)
|-
| typefindfunctions || Automatic format detection
|-
| pbtypes || Shared dynamic types used internally by other plugins
|-
| app || appsrc/appsink, used internally for fingerprinting, waveform and loudness analysis
|-
| audioconvert || Audio format/channel conversion, used internally by every pipeline
|-
| audioresample || Audio sample rate conversion, used internally by every pipeline
|-
| volume || Software volume control, fading, ReplayGain/EBU R128 gain application
|}

== gst-plugins-base ==

The base package is almost always installed whenever GStreamer is installed.

{|
|-
! style="text-align:left;" | Plugin !! style="text-align:left;" | Type
|-
| ogg || Ogg container formats
|-
| vorbis || Ogg Vorbis decoding and encoding
|-
| opus || Ogg Opus decoding and encoding
|-
| alsa || ALSA audio output
|-
| dsd || DSD-to-PCM conversion, used together with gst-libav for DSD (.dsf/.dff) playback
|}

== gst-plugins-good ==

The good package is required for common formats such as FLAC and MP3.

{|
|-
! style="text-align:left;" | Plugin !! style="text-align:left;" | Type
|-
| flac || FLAC decoding and encoding
|-
| speex || Speex decoding and encoding
|-
| wavpack || WavPack decoding and encoding
|-
| wavparse || WAV decoding
|-
| wavenc || WAV encoding
|-
| mpg123 || MP3 decoding
|-
| lame || MP3 encoding
|-
| taglib || MP3 encoding (Adds ID3v2 tags via id3v2mux)
|-
| xingmux || MP3 encoding (Adds a Xing header to VBR MP3 files)
|-
| soup || HTTP/HTTPS client, used for internet radio, podcasts and streaming services
|-
| icydemux || Reads ICY (Shoutcast/Icecast) metadata from internet radio streams
|-
| id3demux || Reads ID3v1/ID3v2 tags while demuxing MP3/AIFF files
|-
| apetag || Reads APEv1/APEv2 tags, used for Musepack/WavPack/APE-tagged files
|-
| isomp4 || MP4/M4A container decoding and encoding (AAC, ALAC)
|-
| matroska || Matroska/WebM container decoding
|-
| audiofx || Audio effects, e.g. stereo balance
|-
| audioparsers || Parsers for various audio formats, used ahead of most decoders
|-
| autodetect || Automatic audio output selection
|-
| equalizer || 10-band equalizer
|-
| replaygain || ReplayGain volume normalization
|-
| spectrum || Spectrum analyzer, used for Moodbar generation if Strawberry is built without FFTW3
|-
| pulseaudio || PulseAudio audio output
|-
| rtsp || RTSP network stream support
|-
| rtp || RTP payload handling, required by RTSP streams
|-
| rtpmanager || RTP session management (jitter buffer, synchronization), required by RTSP streams
|-
| udp || UDP transport, used by raw udp:// stream URLs and required by RTSP streams
|-
| adaptivedemux2 || Adaptive streaming (DASH/HLS/Smooth Streaming) support used by playbin3
|}

== gst-plugins-bad ==

Some distributions such as Fedora does not include some of the bad plugins for licensing reasons. On openSUSE, faad/faac/fdkaac are only available via the Packman repository, not the main OSS repository.

{|
|-
! style="text-align:left;" | Plugin !! style="text-align:left;" | Type
|-
| faad || AAC/MP4 decoding
|-
| faac || AAC/MP4 encoding
|-
| fdkaac || AAC/MP4 decoding and encoding
|-
| musepack || MPC decoding
|-
| aiff || AIFF decoding
|-
| asfmux || Microsoft ASF format (WMA) encoding
|-
| openmpt || Module music (MOD, S3M, XM, IT) decoding
|-
| bs2b || Improve headphone listening of stereo audio records using the bs2b library
|-
| gme || Game console music (SPC, VGM, NSF, and other chiptune formats) decoding
|-
| hls || HTTP Live Streaming (HLS), used when playbin3 is disabled
|-
| dash || Dynamic Adaptive Streaming over HTTP (DASH)
|-
| mpegtsdemux || MPEG transport stream (.ts) demuxing, needed for HLS streams that use .ts segments
|}

== gst-plugins-ugly ==

{|
|-
! style="text-align:left;" | Plugin !! style="text-align:left;" | Type
|-
| asf || Microsoft ASF format (WMA) decoding
|-
| cdio || Read audio from audio CDs
|}

== gst-libav ==

{|
|-
! style="text-align:left;" | Plugin !! style="text-align:left;" | Type
|-
| libav || Monkey's Audio, WMA, ALAC, DSD (.dsf/.dff) and various other formats supported through ffmpeg
|}

== gst-plugins-rs ==

Rust-based plugins, packaged separately from the classic C-based gst-plugins-* modules (e.g. as <code>gstreamer-plugins-rs</code> on openSUSE).

{|
|-
! style="text-align:left;" | Plugin !! style="text-align:left;" | Type
|-
| spotify || Spotify streaming support
|}

== MP3 encoding ==

For MP3 encoding (Transcoding to MP3 in Strawberry) you need lame, taglib (which provides id3v2mux) and xingmux.

== Notes on specific features ==

'''HLS / DASH internet radio''': Strawberry uses playbin3 when available, falling back to the older playbin otherwise (this can be toggled in settings). playbin3 plays HLS via adaptivedemux2's hlsdemux2, while playbin uses the older hls plugin's hlsdemux instead - both are needed to cover either setting. DASH is only used via adaptivedemux2's dashdemux2 (used for some Tidal streams). Many HLS streams still use .ts-segmented (MPEG transport stream) media internally, which additionally needs mpegtsdemux to demux.

'''DSD (.dsf/.dff) playback''': there is no dedicated GStreamer DSD decoder. Demuxing (avdemux_dsf/avdemux_iff) and decoding (avdec_dsd_*) is done entirely by gst-libav; the dsd plugin's dsdconvert element then converts the decoded DSD samples to PCM for the audio sink.

'''RTSP / raw stream URLs''': Strawberry allows raw rtsp://, rtspu://, rtspt://, rtsph://, udp:// and rtp:// stream URLs to be opened directly. This needs rtsp, rtp, rtpmanager and udp together.

'''Audio CD playback''': needs cdio (provides cdiocddasrc).

MinGW vs MSVC

2026-07-09T13:06:21Z

Jonas:

For Windows, Strawberry provides two different versions, MinGW and MSVC.

It's basically two different builds using two different compilers / Standard C++ libraries, MSVC is Microsoft Visual C++ while the other one is from a free software project called GNU ported to Windows.

Both releases use the current latest versions of libraries such as Qt, OpenSSL, Glib and GStreamer.

== MSVC - Microsoft Visual C++ ==

MSVC is Microsoft Visual C++, a proprietary compiler/standard library by Microsoft.

* Requires Microsoft Visual C++ runtime (redistributable).
* GStreamer WASAPI2 support.
* Experimental ASIO support.
* WinSystemMediaTransportControls
* Spotify support.
* More unlikely to be picked up by anti-virus software as false-positive.

When using the MSVC version, always make sure you have up-to-date Visual C++ runtime (Microsoft Visual C++ Redistributable). If not, Strawberry will crash on start, or can crash later in the program.
You get get the latest version here:
https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170#latest-microsoft-visual-c-redistributable-version
Usually it's automatically installed through the Strawberry installer, but it won't be installed automatically if you already have the Visual C++ runtime, and an older version might cause instability.

== MinGW-W64 - Minimal GCC for Windows ==

MinGW is a port of GCC to Windows. GCC is a free compiler and Standard C++ library by the GNU Project, usually found on all major Linux distributions.

* Debug version of the setups are available and includes the GDB debugger which makes debugging a crash easier.
* More likely to be picked up by anti-virus software as false-positive.

None of them currently has device and CD-support.

FAQ

2026-06-21T20:26:42Z

Jonas:

<strong>Frequently Asked Questions</strong>

== Strawberry does not start ==

If you are on Linux or macOS, try starting Strawberry from a terminal window, you should then see more output.

Try starting with a new database, rename strawberry.db to strawberry.db.bak. See https://wiki.strawberrymusicplayer.org/wiki/Database_integrity_check for database location.

== Strawberry does not respect Qt style, KDE theme or icons on Linux. ==

This isn't a bug in Strawberry, it's because Strawberry uses Qt 6 and KDE is still using Qt 5. Any settings configured in KDE won't apply to Qt 6 programs. So you need to specifically configure Qt style and icon theme for Qt 6. You need the qt6ct utility (https://github.com/trialuser02/qt6ct) for this. You should ask your Linux distribution for help with setting this up as this can be different on different distributions.
Once a Qt 6 release of KDE is ready this won't be a problem anymore.

For icon themes that only provide SVG icons, you need the Qt svg imageformat plugin (libqsvg.so).

== Your GStreamer installation is missing a plug-in ==

This is a general error message from GStreamer, which is the framework Strawberry uses for playback. So there could be different reasons why you get this message.

Possible reasons:
# Missing a GStreamer plugin, the plugin you need depends on the audio format you are trying to play, see [https://wiki.strawberrymusicplayer.org/wiki/GStreamer_plugins GStreamer plugins].
# The file you are trying to play is not a audio file, or it might be corrupt.
# GStreamer / Strawberry does not currently support the audio format, see the audio formats supported.
# You need to clear the gstreamer plugin cache, delete ~/.cache/gstreamer-1.0/registry.x86_64.bin

== Album covers in JPEG are not showing. ==

Check that you have the Qt JPEG plugin (libqjpeg.so).

sudo find /usr/ -name 'libqjpeg.so'

== Strawberry does not integrate natively with Wayland. ==

Check that you have the Qt Wayland plugin (libqwayland-generic.so and libqwayland-egl.so).

sudo find /usr/ -name 'libqwayland-generic.so'
sudo find /usr/ -name 'libqwayland-egl.so'

== Could not open audio device for playback. Device is being used by another application. ==

If you are using ALSA with the hw plugin, no other programs can use the same device as Strawberry. Either select PCM as ALSA plugin, or close any other application using the same device.

== Setup or installed files being detected as virus on Windows ==

This is a false-positive. Strawberry is open-source and all source code is available on GitHub (https://github.com/strawberrymusicplayer).

We do not have resources to report all false-positives to each and every anti-virus company each time they occur.

Please report this directly to your anti-virus software company (google i.e: mcafee report false positive) to find the page with information on how to do it.

An option is to use the MSVC version instead of MinGW which is more unlikely to be flagged as virus in the future.

Strawberry is using the NSIS installer which is commonly misidentified as virus by antivirus companies, see: https://nsis.sourceforge.io/NSIS_False_Positives

== Buffering is stuck at 0% when playing HTTP streams ==

This could be issues with HTTP/2 if you have libsoup 3.0 or higher. As of Strawberry version 1.0.8 there is a setting to explicitly turn on HTTP/2 in the backend settings, make sure it is not checked.

For older versions, you can set the SOUP_FORCE_HTTP1 environment variable manually to 1, or start strawberry with: SOUP_FORCE_HTTP1=1 strawberry

== SQL errors like "Unable to execute SQL query", "Unable to open database file", "Unable to fetch row", "Failed query" or similar errors ==

For database location, see [https://wiki.strawberrymusicplayer.org/wiki/Accessing_the_database Accessing the database].

1. Check the permissions to the database file.

ls -la ~/.local/share/strawberry/strawberry/strawberry.db

2. Check free disk space.

df -h

3. A common issue for this fault is the database being corrupted.

Integrity check the database to find out if there are issues:

sqlite3 ~/.local/share/strawberry/strawberry/strawberry.db "pragma integrity_check"

4. Start with a new database.

Close Strawberry, rename the strawberry.db to .bak. Start Strawberry and see if it resolves the issue.

== Can you take my feature request? ==

No. Strawberry is a community project and most contributions (such as bug-fixes, improvements and features) need to come from the community. There are currently few contributors and no-one who can commit to take feature requests from users. Strawberry is mainly maintained by one person, and fixing bugs and keeping the project alive with the current features is a lot of work on it's own. I currently have too many features I want to add, but not enough time to do it all.

== The stereo balancer or equalizer is not working ==

The stereo balancer and equalizer needs to be enabled before starting playback, once enabled, you can adjust it while playing.

== Can you provide AppImages? ==

We know from previous experience that AppImages require a lot of time to maintain and support, they also need to be frequently released, because they contain all libraries used by Strawberry bundled inside.
Therefore we will only provide AppImages based on sponsorship. See https://forum.strawberrymusicplayer.org/topic/1094/appimages-for-linux for more information.

== Apple Music opens when pressing media shortcuts on macOS ==

To disable the annoying Apple Music opening when using the media keys:

Open /Applications/Utilities/Terminal.app

Enter the following:

launchctl unload -w /System/Library/LaunchAgents/com.apple.rcd.plist

to revert:

launchctl load -w /System/Library/LaunchAgents/com.apple.rcd.plist

== Choppy and/or stuttering audio on Windows with the MSVC release ==

Some users have reported that the audio can be choppy and/or stuttering on Windows using the WASAPI2 output (this is the default with MSVC, so it will be picked when set to auto). Try slecting WASAPI or Direct Sound as output instead in Tools / Settings / Backend.

== strawberry.app is damaged and can't be opened ==

This is the macOS security not allowing the program to execute.

To fix this, open a Terminal and type:

sudo xattr -d com.apple.quarantine /Applications/strawberry.app

== "strawberry" can't be opened because Apple cannot check it for malicious software. ==

See https://support.apple.com/en-gu/guide/mac-help/mchleab3a043/mac

== There are ampersands "&" characters in text ==

This is a known issue on KDE 6, not a Strawberry bug. There is a bug report for it here: https://bugs.kde.org/show_bug.cgi?id=483488
A workaround is to disable AutoCheckAccelerators in KDE.:

kwriteconfig5 --file kdeglobals --group Development --key AutoCheckAccelerators "false"

== Can't close sponsorship window on Windows 11 ==

We are still not sure why this happens, try pressing the ESC key. If that does not work, you can disable it manually through the registry under Computer\HKEY_CURRENT_USER\SOFTWARE\Strawberry\Strawberry\MainWindow, add String Value do_not_show_sponsor_message with value true.

There is a reg file here that disables it: https://files.strawberrymusicplayer.org/do_not_show_sponsor_message.reg

== “strawberry” Not Opened - Apple could not verify “strawberry” is free of malware that may harm your Mac or compromise your privacy. ==

Click done, go to System Settings / Privacy & Security, scroll down to the bottom under "Security", there should be something called "strawberry was blocked to protect your mac". Click open anyway.

MinGW vs MSVC

2026-01-21T02:14:22Z

Jonas:

For Windows, Strawberry provides two different versions, MinGW and MSVC.

It's basically two different builds using two different compilers / Standard C++ libraries, MSVC is Microsoft Visual C++ while the other one is from a free software project called GNU ported to Windows.

Both releases use the current latest versions of libraries such as Qt, OpenSSL, Glib and GStreamer.

== MSVC - Microsoft Visual C++ ==

MSVC is Microsoft Visual C++, a proprietary compiler/standard library by Microsoft.

* Requires Microsoft Visual C++ runtime (redistributable).
* Has GStreamer WASAPI2 support.
* Has experimental ASIO support.
* Has Spotify support.
* More unlikely to be picked up by anti-virus software as false-positive.

When using the MSVC version, always make sure you have up-to-date Visual C++ runtime (Microsoft Visual C++ Redistributable). If not, Strawberry will crash on start, or can crash later in the program.
You get get the latest version here:
https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170#latest-microsoft-visual-c-redistributable-version
Usually it's automatically installed through the Strawberry installer, but it won't be installed automatically if you already have the Visual C++ runtime, and an older version might cause instability.

== MinGW-W64 - Minimal GCC for Windows ==

MinGW is a port of GCC to Windows. GCC is a free compiler and Standard C++ library by the GNU Project, usually found on all major Linux distributions.

* Debug version of the setups are available and includes the GDB debugger which makes debugging a crash easier.
* Lacks WSAPI exclusive mode and ASIO support.
* No spotify support.
* More likely to be picked up by anti-virus software as false-positive.

None of them currently has device and CD-support.

Installing GStreamer Spotify plugin

2025-11-10T18:35:06Z

Jonas:

To play Spotify songs you need the GStreamer Spotify plugin from the gst-plugins-rs package version 0.14.0 or higher, if you do not have it, you can build it from source this way.

Get the source

git clone https://gitlab.freedesktop.org/gstreamer/gst-plugins-rs.git
cd gst-plugins-rs

Build and install:

meson setup --buildtype=release --default-library=shared --wrap-mode=nodownload --auto-features=disabled -Dspotify=enabled build
cd build
ninja
sudo cp libgstspotify.so /usr/lib64/gstreamer-1.0/

Compile Arch

2025-04-05T18:06:31Z

Jonas:

Compiling on Arch.

Install the required dependencies:

pacman -S --noconfirm git make cmake gcc pkgconf udisks2 dbus sqlite3 alsa-lib pulseaudio boost gnutls fftw \
qt6-base qt6-tools gst-plugins-base gst-plugins-good taglib chromaprint rapidjson sparsehash \
libcdio libmtp libgpod

Compile and install:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

Compile Arch

2025-04-05T18:05:37Z

Jonas:

Compiling on Arch.

Install the required dependencies:

pacman -S --noconfirm git make cmake gcc pkgconf udisks2 dbus sqlite3 alsa-lib pulseaudio boost gnutls fftw \
qt6-base qt6-tools gst-plugins-base gst-plugins-good taglib chromaprint \
libcdio libmtp libgpod

Compile and install:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

Compile Fedora

2025-04-05T18:05:23Z

Jonas:

Compiling on Fedora

Install the required dependencies:

sudo dnf install \
glibc gcc-c++ git tar rpmdevtools make cmake glib \
boost-devel dbus-devel glib2-devel sqlite-devel alsa-lib-devel pulseaudio-libs-devel libicu-devel \
qt6-qtbase-devel qt6-qtbase-private-devel qt6-qttools-devel kdsingleapplication-qt6-devel \
gstreamer1-devel gstreamer1-plugins-base-devel \
libcdio-devel libgpod-devel libplist-devel libusbmuxd-devel libmtp-devel \
taglib-devel libchromaprint-devel fftw-devel libebur128-devel sparsehash-devel rapidjson-devel

Compile and install:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

Compile openSUSE

2025-04-05T18:05:11Z

Jonas:

Compiling on openSUSE.

Install the required dependencies:

zypper in \
git make cmake gcc gcc-c++ tar \
glibc-devel glib2-devel glib2-tools dbus-1-devel alsa-devel libpulse-devel \
boost-devel sqlite3-devel libicu-devel \
qt6-core-devel qt6-gui-devel qt6-gui-private-devel qt6-widgets-devel qt6-concurrent-devel qt6-network-devel \
qt6-sql-devel qt6-dbus-devel qt6-test-devel qt6-base-common-devel qt6-sql-sqlite qt6-linguist-devel kdsingleapplication-qt6-devel \
gstreamer-devel gstreamer-plugins-base-devel \
libtag-devel libcdio-devel libgpod-devel libplist-devel libmtp-devel libusbmuxd-devel libchromaprint-devel libebur128-devel sparsehash-devel rapidjson-devel

Compile and install:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

Compile Mageia

2025-04-05T18:04:56Z

Jonas:

Install required dependencies:

urpmi --force urpmi-debuginfo-install git glibc gcc-c++ make cmake \
lib64boost-devel lib64sqlite3-devel lib64alsa2-devel lib64pulseaudio-devel \
lib64qt5core-devel lib64qt5gui-devel lib64qt5widgets-devel lib64qt5network-devel lib64qt5concurrent-devel \
lib64qt5sql-devel lib64qt5dbus-devel lib64qt5x11extras-devel lib64qt5help-devel libqt5test-devel \
lib64gstreamer1.0-devel lib64gstreamer-plugins-base1.0-devel lib64cdio-devel lib64gpod-devel \
lib64plist-devel lib64usbmuxd-devel lib64mtp-devel lib64raw1394-devel lib64taglib-devel \
lib64chromaprint-devel libgnutls-devel libfftw-devel dbus-devel lib64sparsehash-devel rapidjson

Compile and install:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

Compile Debian

2025-04-05T18:04:42Z

Jonas:

Install required dependencies:

apt install -y \
git make cmake gcc g++ \
libboost-dev libglib2.0-dev dpkg-dev libdbus-1-dev libsqlite3-dev libgnutls28-dev libicu-dev libsparsehash-dev rapidjson-dev libxkbcommon-dev \
libasound2-dev libpulse-dev \
qt6-base-dev qt6-base-dev-tools qt6-tools-dev qt6-tools-dev-tools qt6-l10n-tools libkdsingleapplication-qt6-dev \
libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gstreamer1.0-alsa gstreamer1.0-pulseaudio \
libchromaprint-dev libfftw3-dev libtag1-dev libebur128-dev \
libcdio-dev libmtp-dev libgpod-dev

Compile:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

Compile Ubuntu

2025-04-05T18:04:26Z

Jonas:

Compiling on Ubuntu

Install the required dependencies:

apt install -y git make cmake gcc g++ \
libglib2.0-dev libdbus-1-dev \
libboost-dev libsqlite3-dev libgnutls28-dev libicu-dev libasound2-dev libpulse-dev libsparsehash-dev rapidjson-dev libxkbcommon-dev \
qt6-base-dev qt6-base-dev-tools qt6-tools-dev qt6-tools-dev-tools qt6-l10n-tools qt6-base-private-dev libkdsingleapplication-qt6-dev \
libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libgstreamer-plugins-good1.0-dev \
libchromaprint-dev libfftw3-dev libtag1-dev libcdio-dev libmtp-dev libgpod-dev libebur128-dev

Compile and install:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

Compile Ubuntu

2025-04-05T17:18:07Z

Jonas:

Compiling on Ubuntu

Install the required dependencies:

apt install -y git make cmake gcc g++ gettext \
libglib2.0-dev libdbus-1-dev \
libboost-dev libsqlite3-dev libgnutls28-dev libicu-dev libasound2-dev libpulse-dev libsparsehash-dev rapidjson-dev libxkbcommon-dev \
qt6-base-dev qt6-base-dev-tools qt6-tools-dev qt6-tools-dev-tools qt6-l10n-tools qt6-base-private-dev libkdsingleapplication-qt6-dev \
libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libgstreamer-plugins-good1.0-dev \
libchromaprint-dev libfftw3-dev libtag1-dev libcdio-dev libmtp-dev libgpod-dev libebur128-dev

Compile and install:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

Compile Debian

2025-04-05T17:17:50Z

Jonas:

Install required dependencies:

apt install -y \
git make cmake gcc g++ gettext \
libboost-dev libglib2.0-dev dpkg-dev libdbus-1-dev libsqlite3-dev libgnutls28-dev libicu-dev libsparsehash-dev rapidjson-dev libxkbcommon-dev \
libasound2-dev libpulse-dev \
qt6-base-dev qt6-base-dev-tools qt6-tools-dev qt6-tools-dev-tools qt6-l10n-tools libkdsingleapplication-qt6-dev \
libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gstreamer1.0-alsa gstreamer1.0-pulseaudio \
libchromaprint-dev libfftw3-dev libtag1-dev libebur128-dev \
libcdio-dev libmtp-dev libgpod-dev

Compile:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

Compile Ubuntu

2025-04-05T17:06:56Z

Jonas:

Compiling on Ubuntu

Install the required dependencies:

apt install -y git make cmake gcc g++ gettext \
libglib2.0-dev libdbus-1-dev \
libboost-dev libsqlite3-dev libgnutls28-dev libicu-dev libasound2-dev libpulse-dev libsparsehash-dev rapidjson-dev libxkbcommon-dev \
qt6-base-dev qt6-base-dev-tools qt6-tools-dev qt6-tools-dev-tools qt6-l10n-tools qt6-base-private-dev \
libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libgstreamer-plugins-good1.0-dev \
libchromaprint-dev libfftw3-dev libtag1-dev libcdio-dev libmtp-dev libgpod-dev libebur128-dev

Compile and install:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

Compile Ubuntu

2025-04-05T17:06:19Z

Jonas:

Compiling on Ubuntu

Install the required dependencies:

apt install -y git make cmake gcc g++ gettext \
libglib2.0-dev libdbus-1-dev \
libboost-dev libsqlite3-dev libgnutls28-dev libicu-dev libasound2-dev libpulse-dev libsparsehash-dev rapidjson-dev libxkbcommon-dev \
qt6-base-dev qt6-base-dev-tools qt6-tools-dev qt6-tools-dev-tools qt6-l10n-tools \
libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libgstreamer-plugins-good1.0-dev \
libchromaprint-dev libfftw3-dev libtag1-dev libcdio-dev libmtp-dev libgpod-dev libebur128-dev

Compile and install:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

Compile Debian

2025-04-05T17:06:09Z

Jonas:

Install required dependencies:

apt install -y \
git make cmake gcc g++ gettext \
libboost-dev libglib2.0-dev dpkg-dev libdbus-1-dev libsqlite3-dev libgnutls28-dev libicu-dev libsparsehash-dev rapidjson-dev libxkbcommon-dev \
libasound2-dev libpulse-dev \
qt6-base-dev qt6-base-dev-tools qt6-tools-dev qt6-tools-dev-tools qt6-l10n-tools \
libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gstreamer1.0-alsa gstreamer1.0-pulseaudio \
libchromaprint-dev libfftw3-dev libtag1-dev libebur128-dev \
libcdio-dev libmtp-dev libgpod-dev

Compile:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

Compile Mageia

2025-04-04T19:55:12Z

Jonas:

Install required dependencies:

urpmi --force urpmi-debuginfo-install git glibc gcc-c++ make cmake gettext \
lib64boost-devel lib64sqlite3-devel lib64alsa2-devel lib64pulseaudio-devel \
lib64qt5core-devel lib64qt5gui-devel lib64qt5widgets-devel lib64qt5network-devel lib64qt5concurrent-devel \
lib64qt5sql-devel lib64qt5dbus-devel lib64qt5x11extras-devel lib64qt5help-devel libqt5test-devel \
lib64gstreamer1.0-devel lib64gstreamer-plugins-base1.0-devel lib64cdio-devel lib64gpod-devel \
lib64plist-devel lib64usbmuxd-devel lib64mtp-devel lib64raw1394-devel lib64taglib-devel \
lib64chromaprint-devel libgnutls-devel libfftw-devel dbus-devel lib64sparsehash-devel rapidjson

Compile and install:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

Compile Ubuntu

2025-04-04T19:54:20Z

Jonas:

Compiling on Ubuntu

Install the required dependencies:

apt install -y git make cmake gcc g++ gettext \
libglib2.0-dev libdbus-1-dev \
libboost-dev libsqlite3-dev libgnutls28-dev libicu-dev libasound2-dev libpulse-dev libsparsehash-dev rapidjson-dev \
qt6-base-dev qt6-base-dev-tools qt6-tools-dev qt6-tools-dev-tools qt6-l10n-tools \
libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libgstreamer-plugins-good1.0-dev \
libchromaprint-dev libfftw3-dev libtag1-dev libcdio-dev libmtp-dev libgpod-dev libebur128-dev

Compile and install:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

Compile Debian

2025-04-04T19:53:35Z

Jonas:

Install required dependencies:

apt install -y \
git make cmake gcc g++ gettext \
libboost-dev libglib2.0-dev dpkg-dev libdbus-1-dev libsqlite3-dev libgnutls28-dev libicu-dev libsparsehash-dev rapidjson-dev \
libasound2-dev libpulse-dev \
qt6-base-dev qt6-base-dev-tools qt6-tools-dev qt6-tools-dev-tools qt6-l10n-tools \
libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gstreamer1.0-alsa gstreamer1.0-pulseaudio \
libchromaprint-dev libfftw3-dev libtag1-dev libebur128-dev \
libcdio-dev libmtp-dev libgpod-dev

Compile:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

Compile openSUSE

2025-04-04T19:52:48Z

Jonas:

Compiling on openSUSE.

Install the required dependencies:

zypper in \
git make cmake gcc gcc-c++ tar gettext-tools \
glibc-devel glib2-devel glib2-tools dbus-1-devel alsa-devel libpulse-devel \
boost-devel sqlite3-devel libicu-devel \
qt6-core-devel qt6-gui-devel qt6-gui-private-devel qt6-widgets-devel qt6-concurrent-devel qt6-network-devel \
qt6-sql-devel qt6-dbus-devel qt6-test-devel qt6-base-common-devel qt6-sql-sqlite qt6-linguist-devel kdsingleapplication-qt6-devel \
gstreamer-devel gstreamer-plugins-base-devel \
libtag-devel libcdio-devel libgpod-devel libplist-devel libmtp-devel libusbmuxd-devel libchromaprint-devel libebur128-devel sparsehash-devel rapidjson-devel

Compile and install:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

Compile Fedora

2025-04-04T19:52:05Z

Jonas:

Compiling on Fedora

Install the required dependencies:

sudo dnf install \
glibc gcc-c++ git tar rpmdevtools make cmake glib man gettext \
boost-devel dbus-devel glib2-devel sqlite-devel alsa-lib-devel pulseaudio-libs-devel libicu-devel \
qt6-qtbase-devel qt6-qtbase-private-devel qt6-qttools-devel kdsingleapplication-qt6-devel \
gstreamer1-devel gstreamer1-plugins-base-devel \
libcdio-devel libgpod-devel libplist-devel libusbmuxd-devel libmtp-devel \
taglib-devel libchromaprint-devel fftw-devel libebur128-devel sparsehash-devel rapidjson-devel

Compile and install:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

Differences from Clementine

2025-03-08T11:13:50Z

Jonas:

Strawberry is a fork of Clementine, the GUI looks very similar, but many parts have been rewritten and improved that are not immediately.

* Active development
* Ported to Qt 6
* Frequent stable releases
* Focus on local music playback
* Focus on playback without resampling
* Focus on code improvements and bugfixes instead of adding more features
* Adapt faster to newer libraries and API changes
* Depend on less libraries and less 3rdparty code
* Advanced audio output and device configuration for bit-perfect playback on Linux
* The GStreamer engine code is mostly rewritten
* GStreamer engine is changed so that the analyzer does not cause resampling
* Equalizer elements in the pipeline are not activated unless the equalizer is enabled which fixes problems with resampling
* Error handling is improved
* Option to disable volume
* The collection model has been rewritten.
* New context view with song playing info and album cover
* Improved album cover fetching and cover manager with better album covers from Tidal and Deezer
* Lyrics from multiple working providers
* New rewritten scrobbler with caching and support for multiple providers: Last.fm, Libre.fm and ListenBrainz
* The queue manager is moved into the tab for easier access
* Improved playlist background image settings for displaying album cover and custom image
* Option to automatically save album covers to the album directory
* Streaming support for Subsonic, Tidal, Qobuz and Spotify
* Tabbar is improved
* Organizing music is improved
* Transcoding music is improved
* Settings have been reorganized
* New global shortcuts backend for X11 and Windows
* Lots of improvements to code and bugfixes

== Features missing ==

Some features found in Clementine have not been included.
Some of them, like the internet services and song and artist bio depended on clementine services.
Others have not been included to make maintaining the project easier and less time consuming.
Basically, the more code, the more job it is to maintain a project. Also, to make sure features work it require developers and testers who actually use the features. Some features might have been dropped because we want to rewrite it or do it differently.

* CD Ripper: Better options exist such as k3b, also the main focus is a music player, not a cd ripper.
* Podcast support: Work was started on integrating it, but due to lack of time, it was never finished.
* Various streaming services and radios: These require each a API token for Strawberry, they require lot of work to test, maintain and make sure they work for each release, an account with each service, also, some of them were broken.
* Cloud storage: Same as above, also few people use them and the main focus is local music.
* Song info: It is replaced by the context which also has lyrics.
* Artist bio: It depended on clementine services. Work started on a new one, but didn't find a good API with artist biography.
* Visualizations: It's partial broken in Clementine. We have attempted to add this back, but because of major changes in the Qt framework and a new projectM API, it's has not been resolved yet. Getting projectM to work with Qt has been challenging, so it's possible this won't get added.
* The extras stuff and background streams.
* Network remote: We don't have an android app. Because of lack of contributors we have currently decided not to add it at this time.
* WII remote control: Few people use it, we don't have anyone to maintain the code.

Differences from Clementine

2025-03-08T11:12:16Z

Jonas:

Strawberry is a fork of Clementine, it looks and behaves very similar. Beneath the hood there are more changes than immediately seen in the GUI. Also, it does not include all features that Clementine got, but focus on other features instead.

* Active development
* Ported to Qt 6
* Frequent stable releases
* Focus on local music playback
* Focus on playback without resampling
* Focus on code improvements and bugfixes instead of adding more features
* Adapt faster to newer libraries and API changes
* Depend on less libraries and less 3rdparty code
* Advanced audio output and device configuration for bit-perfect playback on Linux
* The GStreamer engine code is mostly rewritten
* GStreamer engine is changed so that the analyzer does not cause resampling
* Equalizer elements in the pipeline are not activated unless the equalizer is enabled which fixes problems with resampling
* Error handling is improved
* Option to disable volume
* The collection model has been rewritten.
* New context view with song playing info and album cover
* Improved album cover fetching and cover manager with better album covers from Tidal and Deezer
* Lyrics from multiple working providers
* New rewritten scrobbler with caching and support for multiple providers: Last.fm, Libre.fm and ListenBrainz
* The queue manager is moved into the tab for easier access
* Improved playlist background image settings for displaying album cover and custom image
* Option to automatically save album covers to the album directory
* Streaming support for Subsonic, Tidal, Qobuz and Spotify
* Tabbar is improved
* Organizing music is improved
* Transcoding music is improved
* Settings have been reorganized
* New global shortcuts backend for X11 and Windows
* Lots of improvements to code and bugfixes

== Features missing ==

Some features found in Clementine have not been included.
Some of them, like the internet services and song and artist bio depended on clementine services.
Others have not been included to make maintaining the project easier and less time consuming.
Basically, the more code, the more job it is to maintain a project. Also, to make sure features work it require developers and testers who actually use the features. Some features might have been dropped because we want to rewrite it or do it differently.

* CD Ripper: Better options exist such as k3b, also the main focus is a music player, not a cd ripper.
* Podcast support: Work was started on integrating it, but due to lack of time, it was never finished.
* Various streaming services and radios: These require each a API token for Strawberry, they require lot of work to test, maintain and make sure they work for each release, an account with each service, also, some of them were broken.
* Cloud storage: Same as above, also few people use them and the main focus is local music.
* Song info: It is replaced by the context which also has lyrics.
* Artist bio: It depended on clementine services. Work started on a new one, but didn't find a good API with artist biography.
* Visualizations: It's partial broken in Clementine. We have attempted to add this back, but because of major changes in the Qt framework and a new projectM API, it's has not been resolved yet. Getting projectM to work with Qt has been challenging, so it's possible this won't get added.
* The extras stuff and background streams.
* Network remote: We don't have an android app. Because of lack of contributors we have currently decided not to add it at this time.
* WII remote control: Few people use it, we don't have anyone to maintain the code.

Differences from Clementine

2025-03-08T11:10:26Z

Jonas:

Strawberry is a fork of Clementine, it looks and behaves very similar. Beneath the hood there are more changes than immediately seen in the GUI. Also, it does not include all features that Clementine got, but focus on other features instead.

== Project goals, focus and advantages ==

* Active development
* Ported to Qt 6
* Frequent stable releases
* Focus on local music playback
* Focus on playback without resampling
* Focus on code improvements and bugfixes instead of adding more features
* Adapt faster to newer libraries and API changes
* Depend on less libraries and less 3rdparty code

== Playpack ==

* Advanced audio output and device configuration for bit-perfect playback on Linux
* The GStreamer engine code is different and uses playbin
* GStreamer engine is changed so that the analyzer does not cause resampling
* Equalizer elements in the pipeline are not activated unless the equalizer is enabled which fixes problems with resampling
* Error handling is improved
* Option to disable volume

== Other ==

* The collection model has been rewritten.
* New context view with song playing info and album cover
* Improved album cover fetching and cover manager with better album covers from Tidal and Deezer
* Lyrics are retrieved using API's instead of scraping HTML
* New rewritten scrobbler with caching and support for multiple providers: Last.fm, Libre.fm and ListenBrainz
* The queue manager is moved into the tab for easier access
* Improved playlist background image settings for displaying album cover and custom image
* Option to automatically save album covers to the album directory
* Streaming support for Subsonic, Tidal, Qobuz and Spotify
* Tabbar is improved
* Organizing music is improved
* Transcoding music is improved
* Settings have been reorganized
* New global shortcuts backend for X11 and Windows
* Lots of improvements to code and bugfixes

== Features missing ==

Some features found in Clementine have not been included.
Some of them, like the internet services and song and artist bio depended on clementine services.
Others have not been included to make maintaining the project easier and less time consuming.
Basically, the more code, the more job it is to maintain a project. Also, to make sure features work it require developers and testers who actually use the features. Some features might have been dropped because we want to rewrite it or do it differently.

* CD Ripper: Better options exist such as k3b, also the main focus is a music player, not a cd ripper.
* Podcast support: Work was started on integrating it, but due to lack of time, it was never finished.
* Various streaming services and radios: These require each a API token for Strawberry, they require lot of work to test, maintain and make sure they work for each release, an account with each service, also, some of them were broken.
* Cloud storage: Same as above, also few people use them and the main focus is local music.
* Song info: It is replaced by the context which also has lyrics.
* Artist bio: It depended on clementine services. Work started on a new one, but didn't find a good API with artist biography.
* Visualizations: It's partial broken in Clementine. We have attempted to add this back, but because of major changes in the Qt framework and a new projectM API, it's has not been resolved yet. Getting projectM to work with Qt has been challenging, so it's possible this won't get added.
* The extras stuff and background streams.
* Network remote: We don't have an android app. Because of lack of contributors we have currently decided not to add it at this time.
* WII remote control: Few people use it, we don't have anyone to maintain the code.

Known Issues

2025-02-27T07:36:47Z

Jonas:

This is a list of issues we know about, but for various reasons we are currently unable to do anything about them, and most likely they won't be fixed.

== General ==

'''"Server does not support seeking" error when un-pausing playback from a live stream'''

It is not to possible to pause and un-pause a live stream, because you cannot seek when playing a live stream.
Currently, the workaround is to use stop instead of pause when playing a live stream.
A long term fix would be to improve GStreamer so it can read the HTTP headers to check whether the stream is a live stream or not.

== Linux ==

'''Strawberry does not respect Qt style, KDE theme or icons.'''

See [https://wiki.strawberrymusicplayer.org/wiki/FAQ FAQ]

== macOS ==

'''Playlist scrolling is slow and uses high CPU'''

This is a Qt bug.

== Windows ==

''' No support for devices'''

''' No support for CD playback'''

This is most likely a GStreamer restriction, CD playback with GStreamer does not work on Windows.

Known Issues

2025-02-27T07:35:32Z

Jonas:

This is a list of issues we know about, but for various reasons we are currently unable to do anything about them, and most likely they won't be fixed.

== General ==

'''"Server does not support seeking" error when un-pausing playback from a live stream'''

It is not to possible to pause and un-pause a live stream, because you cannot seek when playing a live stream.
Currently, the workaround is to use stop instead of pause when playing a live stream.
A long term fix would be to improve GStreamer so it can read the HTTP headers to check whether the stream is a live stream or not.

== Linux ==

'''Strawberry does not respect Qt style, KDE theme or icons.'''

See [https://wiki.strawberrymusicplayer.org/wiki/FAQ FAQ]

== macOS ==

'''Playlist scrolling is slow and uses high CPU'''

This is a Qt bug.

== Windows ==

''' No support for devices'''

Strawberry is missing the "backend" for listing devices on Windows, no contributors have been willing to work on it so far.

''' No support for CD playback'''

This is most likely a GStreamer restriction, CD playback with GStreamer does not work on Windows.

Compile macOS using macports

2025-01-16T06:33:31Z

Jonas:

Compiling on macOS using macports.

This guide is currently not maintained and might no longer work.

== Install xcode tools ==

xcode-select --install

== Install macports ==

Download and install macports from: https://www.macports.org/install.php

== Prepare macports ==

sudo port -v selfupdate

== Install dependencies ==

sudo port -N install glib2 pkgconfig cmake boost sqlite3 gnutls chromaprint fftw taglib libebur128 qt6-qtbase qt6-sqlite-plugin qt6-qttools gstreamer1 gstreamer1-gst-plugins-base gstreamer1-gst-plugins-good gstreamer1-gst-plugins-ugly gstreamer1-gst-libav libcdio libmtp libgpod libebur128
sudo port -N install gstreamer1-gst-plugins-bad +faac +fdk_aac

== Install create-dmg ==

mkdir -p ~/build
cd ~/build
git clone --recursive https://github.com/create-dmg/create-dmg
cd create-dmg
sudo make install

== Set environment variables ==

export GIO_EXTRA_MODULES=/opt/local/lib/gio/modules
export GST_PLUGIN_SCANNER=/opt/local/libexec/gstreamer-1.0/gst-plugin-scanner
export GST_PLUGIN_PATH=/opt/local/lib/gstreamer-1.0

== Prepare build ==

mkdir -p ~/build
cd ~/build
git clone https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

== Compile and create DMG ==

/opt/local/libexec/qt6/bin/qt-cmake .. -DCMAKE_BUILD_TYPE=Debug -DUSE_BUNDLE=ON -DENABLE_SPARKLE=OFF -DENABLE_QTSPARKLE=OFF
make -j 4
make install
make deploy
make deploycheck
make dmg

You might get warnings in make deploy about missing gstreamer plugins because macports does not have all of them, they are not critical and Strawberry should still work.

== Install ==

To install, either open the DMG, drag Strawberry over to Applications, or manually copy the strawberry.app folder over to /Applications/

Compile macOS using homebrew

2025-01-16T06:32:34Z

Jonas: /* Configure build */

Compile on macOS using homebrew

This guide is currently not maintained and might no longer work.

Homebrew is generally unsuitable for building strawberry since its missing several gstreamer plugins, specific macdeployqt patches and specific Qt and gstreamer modifications and patches.

Since Homebrew refuse enable certain gstreamer plugins and have been generally unwilling to accept patches, we can not give support for building strawberry with homebrew. This guide is provided as is, outdated and without any support. If you want access to the Wiki for editing, please e-mail us or contact us on the forum.

If you want support, consider donating for getting access to the official signed binaries of strawberry.

== Install xcode tools and brew package manager ==

xcode-select --install
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

== Install dependencies through brew ==

brew install pkg-config cmake ninja meson bison flex wget create-dmg gettext boost
brew install glib glib-openssl glib-networking gdk-pixbuf gobject-introspection orc
brew install libffi openssl sqlite fftw libmtp libplist libxml2 libsoup
brew install libogg libvorbis flac wavpack opus speex mpg123 lame twolame taglib chromaprint libebur128 libbs2b libcdio libopenmpt faad2 faac fdk-aac musepack game-music-emu
brew install qt6 gstreamer

== Set environment variables ==

export GIO_EXTRA_MODULES=$(brew --prefix)/lib/gio/modules
export GST_PLUGIN_SCANNER=$(brew --prefix)/opt/gstreamer/libexec/gstreamer-1.0/gst-plugin-scanner
export GST_PLUGIN_PATH=$(brew --prefix)/lib/gstreamer-1.0

== Prepare build ==

mkdir -p ~/build
cd ~/build
git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

== Configure build ==

cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH=$(brew --prefix)/opt/qt6/lib/cmake -DUSE_BUNDLE=ON -DENABLE_SPARKLE=OFF -DENABLE_QTSPARKLE=OFF -DICU_ROOT=$(brew --prefix)/opt/icu4c

== Build ==

make -j 4
make install

== Remove problematic unneeded plugins ==

sudo rm -rf $(brew --prefix)/opt/qt6/share/qt/plugins/virtualkeyboard $(brew --prefix)/opt/qt6/share/qt/plugins/platforminputcontexts
sudo rm -f $(brew --prefix)/Cellar/qt/*/share/qt/plugins/imageformats/libqpdf.dylib

== Manually copy files ==

You need to manually copy libsoup-3.0.0.dylib, as this library needs to be loaded by gstreamer at runtime:

mkdir -p strawberry.app/Contents/Frameworks
cp $(brew --prefix)/lib/libsoup-3.0.0.dylib strawberry.app/Contents/Frameworks/

== Deploy ==

make deploy

== Deploy check ==

Checks that all libraries are deployed correctly.

make deploycheck

== Create DMG ==

make dmg

== Install ==

To install, either open the DMG, drag Strawberry over to Applications, or manually copy the strawberry.app folder over to /Applications/

Build macOS

2025-01-16T05:07:18Z

Jonas: /* Configure build */

Building on macOS

== Install xcode tools ==

xcode-select --install

== Download and install dependencies ==

Dependencies will be extracted under /opt/strawberry_macos_ARCH_release

curl -f -O -L https://github.com/strawberrymusicplayer/strawberry-macos-dependencies/releases/latest/download/strawberry-macos-$(uname -m)-release.tar.xz
sudo tar -C / -xf strawberry-macos-$(uname -m)-release.tar.xz
rm strawberry-macos-$(uname -m)-release.tar.xz

== Checkout code ==

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

== Configure build ==

PKG_CONFIG_PATH=/opt/strawberry_macos_$(uname -m)_release/lib/pkgconfig LDFLAGS="-L/opt/strawberry_macos_$(uname -m)_release/lib -Wl,-rpath,/opt/strawberry_macos_$(uname -m)_release/lib" /opt/strawberry_macos_$(uname -m)_release/bin/cmake --log-level="DEBUG" -S .. -B . -DCMAKE_BUILD_TYPE="Release" -DUSE_BUNDLE=ON -DCMAKE_PREFIX_PATH="/opt/strawberry_macos_$(uname -m)_release/lib/cmake" -DPKG_CONFIG_EXECUTABLE="/opt/strawberry_macos_$(uname -m)_release/bin/pkg-config" -DICU_ROOT="/opt/strawberry_macos_$(uname -m)_release" -DMACDEPLOYQT_EXECUTABLE=/opt/strawberry_macos_$(uname -m)_release/bin/macdeployqt -DARCH=$(uname -m) -DENABLE_SPARKLE=ON -DENABLE_QTSPARKLE=OFF

== Build ==

make -j 4
make install

== Set environment variables ==

export GIO_EXTRA_MODULES="/opt/strawberry_macos_$(uname -m)_release/lib/gio/modules"
export GST_PLUGIN_SCANNER="/opt/strawberry_macos_$(uname -m)_release/libexec/gstreamer-1.0/gst-plugin-scanner"
export GST_PLUGIN_PATH="/opt/strawberry_macos_$(uname -m)_release/lib/gstreamer-1.0"
export LIBSOUP_LIBRARY_PATH="/opt/strawberry_macos_$(uname -m)_release/lib/libsoup-3.0.0.dylib"

== Deploy ==

make deploy

== Deploy check ==

Checks that all libraries are deployed correctly.

make deploycheck

== Create DMG ==

make dmg

== Install ==

To install, either open the DMG, drag Strawberry over to Applications, or manually copy the strawberry.app folder over to /Applications/

Build macOS

2025-01-15T13:48:47Z

Jonas: /* Configure build */

Building on macOS

== Install xcode tools ==

xcode-select --install

== Download and install dependencies ==

Dependencies will be extracted under /opt/strawberry_macos_ARCH_release

curl -f -O -L https://github.com/strawberrymusicplayer/strawberry-macos-dependencies/releases/latest/download/strawberry-macos-$(uname -m)-release.tar.xz
sudo tar -C / -xf strawberry-macos-$(uname -m)-release.tar.xz
rm strawberry-macos-$(uname -m)-release.tar.xz

== Checkout code ==

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

== Configure build ==

PKG_CONFIG_PATH=/opt/strawberry_macos_$(uname -m)_release/lib/pkgconfig LDFLAGS="-L/opt/strawberry_macos_$(uname -m)_release/lib -Wl,-rpath,/opt/strawberry_macos_$(uname -m)_release/lib" /opt/strawberry_macos_$(uname -m)_release/bin/cmake --log-level="DEBUG" -S .. -B . -DCMAKE_BUILD_TYPE="Release" -DUSE_BUNDLE=ON -DCMAKE_PREFIX_PATH="/opt/strawberry_macos_$(uname -m)_release/lib/cmake" -DPKG_CONFIG_EXECUTABLE="/opt/strawberry_macos_$(uname -m)_release/bin/pkg-config" -DICU_ROOT="/opt/strawberry_macos_$(uname -m)_release" -DENABLE_DBUS=OFF -DMACDEPLOYQT_EXECUTABLE=/opt/strawberry_macos_$(uname -m)_release/bin/macdeployqt -DARCH=$(uname -m)

== Build ==

make -j 4
make install

== Set environment variables ==

export GIO_EXTRA_MODULES="/opt/strawberry_macos_$(uname -m)_release/lib/gio/modules"
export GST_PLUGIN_SCANNER="/opt/strawberry_macos_$(uname -m)_release/libexec/gstreamer-1.0/gst-plugin-scanner"
export GST_PLUGIN_PATH="/opt/strawberry_macos_$(uname -m)_release/lib/gstreamer-1.0"
export LIBSOUP_LIBRARY_PATH="/opt/strawberry_macos_$(uname -m)_release/lib/libsoup-3.0.0.dylib"

== Deploy ==

make deploy

== Deploy check ==

Checks that all libraries are deployed correctly.

make deploycheck

== Create DMG ==

make dmg

== Install ==

To install, either open the DMG, drag Strawberry over to Applications, or manually copy the strawberry.app folder over to /Applications/

Compile macOS using homebrew

2024-12-12T01:36:35Z

Jonas:

Compile on macOS using homebrew

This guide is currently not maintained and might no longer work.

Homebrew is generally unsuitable for building strawberry since its missing several gstreamer plugins, specific macdeployqt patches and specific Qt and gstreamer modifications and patches.

Since Homebrew refuse enable certain gstreamer plugins and have been generally unwilling to accept patches, we can not give support for building strawberry with homebrew. This guide is provided as is, outdated and without any support. If you want access to the Wiki for editing, please e-mail us or contact us on the forum.

If you want support, consider donating for getting access to the official signed binaries of strawberry.

== Install xcode tools and brew package manager ==

xcode-select --install
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

== Install dependencies through brew ==

brew install pkg-config cmake ninja meson bison flex wget create-dmg gettext boost
brew install glib glib-openssl glib-networking gdk-pixbuf gobject-introspection orc
brew install libffi openssl sqlite fftw libmtp libplist libxml2 libsoup
brew install libogg libvorbis flac wavpack opus speex mpg123 lame twolame taglib chromaprint libebur128 libbs2b libcdio libopenmpt faad2 faac fdk-aac musepack game-music-emu
brew install qt6 gstreamer

== Set environment variables ==

export GIO_EXTRA_MODULES=$(brew --prefix)/lib/gio/modules
export GST_PLUGIN_SCANNER=$(brew --prefix)/opt/gstreamer/libexec/gstreamer-1.0/gst-plugin-scanner
export GST_PLUGIN_PATH=$(brew --prefix)/lib/gstreamer-1.0

== Prepare build ==

mkdir -p ~/build
cd ~/build
git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

== Configure build ==

cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH=$(brew --prefix)/opt/qt6/lib/cmake -DUSE_BUNDLE=ON -DENABLE_SPARKLE=OFF -DICU_ROOT=$(brew --prefix)/opt/icu4c -DENABLE_DBUS=OFF

== Build ==

make -j 4
make install

== Remove problematic unneeded plugins ==

sudo rm -rf $(brew --prefix)/opt/qt6/share/qt/plugins/virtualkeyboard $(brew --prefix)/opt/qt6/share/qt/plugins/platforminputcontexts
sudo rm -f $(brew --prefix)/Cellar/qt/*/share/qt/plugins/imageformats/libqpdf.dylib

== Manually copy files ==

You need to manually copy libsoup-3.0.0.dylib, as this library needs to be loaded by gstreamer at runtime:

mkdir -p strawberry.app/Contents/Frameworks
cp $(brew --prefix)/lib/libsoup-3.0.0.dylib strawberry.app/Contents/Frameworks/

== Deploy ==

make deploy

== Deploy check ==

Checks that all libraries are deployed correctly.

make deploycheck

== Create DMG ==

make dmg

== Install ==

To install, either open the DMG, drag Strawberry over to Applications, or manually copy the strawberry.app folder over to /Applications/

Compile macOS using macports

2024-12-12T01:36:00Z

Jonas:

Compiling on macOS using macports.

This guide is currently not maintained and might no longer work.

== Install xcode tools ==

xcode-select --install

== Install macports ==

Download and install macports from: https://www.macports.org/install.php

== Prepare macports ==

sudo port -v selfupdate

== Install dependencies ==

sudo port -N install glib2 pkgconfig cmake boost sqlite3 gnutls chromaprint fftw taglib libebur128 qt6-qtbase qt6-sqlite-plugin qt6-qttools gstreamer1 gstreamer1-gst-plugins-base gstreamer1-gst-plugins-good gstreamer1-gst-plugins-ugly gstreamer1-gst-libav libcdio libmtp libgpod libebur128
sudo port -N install gstreamer1-gst-plugins-bad +faac +fdk_aac

== Install create-dmg ==

mkdir -p ~/build
cd ~/build
git clone --recursive https://github.com/create-dmg/create-dmg
cd create-dmg
sudo make install

== Set environment variables ==

export GIO_EXTRA_MODULES=/opt/local/lib/gio/modules
export GST_PLUGIN_SCANNER=/opt/local/libexec/gstreamer-1.0/gst-plugin-scanner
export GST_PLUGIN_PATH=/opt/local/lib/gstreamer-1.0

== Prepare build ==

mkdir -p ~/build
cd ~/build
git clone https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

== Compile and create DMG ==

/opt/local/libexec/qt6/bin/qt-cmake .. -DCMAKE_BUILD_TYPE=Debug -DUSE_BUNDLE=ON
make -j 4
make install
make deploy
make deploycheck
make dmg

You might get warnings in make deploy about missing gstreamer plugins because macports does not have all of them, they are not critical and Strawberry should still work.

== Install ==

To install, either open the DMG, drag Strawberry over to Applications, or manually copy the strawberry.app folder over to /Applications/

Build macOS

2024-11-29T22:16:37Z

Jonas: /* Configure build */

Building on macOS

== Install xcode tools ==

xcode-select --install

== Download and install dependencies ==

Dependencies will be extracted under /opt/strawberry_macos_ARCH_release

curl -f -O -L https://github.com/strawberrymusicplayer/strawberry-macos-dependencies/releases/latest/download/strawberry-macos-$(uname -m)-release.tar.xz
sudo tar -C / -xf strawberry-macos-$(uname -m)-release.tar.xz
rm strawberry-macos-$(uname -m)-release.tar.xz

== Checkout code ==

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

== Configure build ==

PKG_CONFIG_PATH=/opt/strawberry_macos_$(uname -m)_release/lib/pkgconfig LDFLAGS="-L/opt/strawberry_macos_$(uname -m)_release/lib -Wl,-rpath,/opt/strawberry_macos_$(uname -m)_release/lib" /opt/strawberry_macos_$(uname -m)_release/bin/cmake --log-level="DEBUG" -S .. -B . -DCMAKE_BUILD_TYPE="Release" -DUSE_BUNDLE=ON -DCMAKE_PREFIX_PATH="/opt/strawberry_macos_$(uname -m)_release/lib/cmake" -DPKG_CONFIG_EXECUTABLE="/opt/strawberry_macos_$(uname -m)_release/bin/pkg-config" -DICU_ROOT="/opt/strawberry_macos_$(uname -m)_release" -DENABLE_DBUS=OFF -DMACDEPLOYQT_EXECUTABLE=/opt/strawberry_macos_$(uname -m)_release/bin/macdeployqt

== Build ==

make -j 4
make install

== Set environment variables ==

export GIO_EXTRA_MODULES="/opt/strawberry_macos_$(uname -m)_release/lib/gio/modules"
export GST_PLUGIN_SCANNER="/opt/strawberry_macos_$(uname -m)_release/libexec/gstreamer-1.0/gst-plugin-scanner"
export GST_PLUGIN_PATH="/opt/strawberry_macos_$(uname -m)_release/lib/gstreamer-1.0"
export LIBSOUP_LIBRARY_PATH="/opt/strawberry_macos_$(uname -m)_release/lib/libsoup-3.0.0.dylib"

== Deploy ==

make deploy

== Deploy check ==

Checks that all libraries are deployed correctly.

make deploycheck

== Create DMG ==

make dmg

== Install ==

To install, either open the DMG, drag Strawberry over to Applications, or manually copy the strawberry.app folder over to /Applications/

Build macOS

2024-11-27T09:51:14Z

Jonas:

Building on macOS

== Install xcode tools ==

xcode-select --install

== Download and install dependencies ==

Dependencies will be extracted under /opt/strawberry_macos_ARCH_release

curl -f -O -L https://github.com/strawberrymusicplayer/strawberry-macos-dependencies/releases/latest/download/strawberry-macos-$(uname -m)-release.tar.xz
sudo tar -C / -xf strawberry-macos-$(uname -m)-release.tar.xz
rm strawberry-macos-$(uname -m)-release.tar.xz

== Checkout code ==

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

== Configure build ==

PKG_CONFIG_PATH=/opt/strawberry_macos_$(uname -m)_release/lib/pkgconfig LDFLAGS="-L/opt/strawberry_macos_$(uname -m)_release/lib -Wl,-rpath,/opt/strawberry_macos_$(uname -m)_release/lib" /opt/strawberry_macos_$(uname -m)_release/bin/cmake --log-level="DEBUG" -S .. -B . -DCMAKE_BUILD_TYPE="Release" -DBUILD_WITH_QT6=ON -DUSE_BUNDLE=ON -DCMAKE_PREFIX_PATH="/opt/strawberry_macos_$(uname -m)_release/lib/cmake" -DPKG_CONFIG_EXECUTABLE="/opt/strawberry_macos_$(uname -m)_release/bin/pkg-config" -DICU_ROOT="/opt/strawberry_macos_$(uname -m)_release" -DFFTW3_DIR="/opt/strawberry_macos_$(uname -m)_release" -DENABLE_DBUS=OFF

== Build ==

make -j 4
make install

== Set environment variables ==

export GIO_EXTRA_MODULES="/opt/strawberry_macos_$(uname -m)_release/lib/gio/modules"
export GST_PLUGIN_SCANNER="/opt/strawberry_macos_$(uname -m)_release/libexec/gstreamer-1.0/gst-plugin-scanner"
export GST_PLUGIN_PATH="/opt/strawberry_macos_$(uname -m)_release/lib/gstreamer-1.0"
export LIBSOUP_LIBRARY_PATH="/opt/strawberry_macos_$(uname -m)_release/lib/libsoup-3.0.0.dylib"

== Deploy ==

make deploy

== Deploy check ==

Checks that all libraries are deployed correctly.

make deploycheck

== Create DMG ==

make dmg

== Install ==

To install, either open the DMG, drag Strawberry over to Applications, or manually copy the strawberry.app folder over to /Applications/

Compile FreeBSD

2024-11-26T19:26:36Z

Jonas:

Compiling on FreeBSD

Install the required dependencies:

sudo pkg install pkgconfig cmake git boost-libs sqlite gstreamer qt6 libcdio libmtp libgpod

Compile and install:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

Compile FreeBSD

2024-11-26T19:25:01Z

Jonas: Created page with "Compiling on FreeBSD Install the required dependencies: sudo pkg install cmake git boost-libs libcdio libmtp libgpod Compile and install: git clone --recursive https://github.com/strawberrymusicplayer/strawberry cd strawberry mkdir build cd build cmake .. make -j$(nproc) sudo make install (If you already did `git clone`, do `git pull` to make sure you have the latest code)."

Compiling on FreeBSD

Install the required dependencies:

sudo pkg install cmake git boost-libs libcdio libmtp libgpod

Compile and install:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

Differences from Clementine

2024-11-23T15:58:03Z

Jonas: /* Features missing */

Strawberry is a fork of Clementine, it looks and behaves very similar. Beneath the hood there are more changes than immediately seen in the GUI. Also, it does not include all features that Clementine got, but focus on other features instead.

== Project goals, focus and advantages ==

* Active development
* Migrated to Qt 6
* Frequent stable releases
* Focus on local music playback
* Focus on playback of high resolution audio and without resampling
* Focus on code improvements and bugfixes instead of adding more features
* Adapt faster to newer libraries and API changes
* Depend on less libraries and less 3rdparty code

== Playpack ==

* Advanced audio output and device configuration for bit-perfect playback on Linux
* The GStreamer engine code is different and uses playbin
* GStreamer engine is changed so that the analyzer does not cause resampling
* Equalizer elements in the pipeline are not activated unless the equalizer is enabled which fixes problems with resampling
* Error handling is improved
* Option to disable volume

== Other ==

* The collection model has been rewritten.
* New context view with song playing info and album cover
* Improved album cover fetching and cover manager with better album covers from Tidal and Deezer
* Lyrics are retrieved using API's instead of scraping HTML
* New rewritten scrobbler with caching and support for multiple providers: Last.fm, Libre.fm and ListenBrainz
* The queue manager is moved into the tab for easier access
* Improved playlist background image settings for displaying album cover and custom image
* Option to automatically save album covers to the album directory
* Streaming support for Subsonic, Tidal, Qobuz and Spotify
* Tabbar is improved
* Organizing music is improved
* Transcoding music is improved
* Settings have been reorganized
* New global shortcuts backend for X11 and Windows
* Lots of improvements to code and bugfixes

== Features missing ==

Some features found in Clementine have not been included.
Some of them, like the internet services and song and artist bio depended on clementine services.
Others have not been included to make maintaining the project easier and less time consuming.
Basically, the more code, the more job it is to maintain a project. Also, to make sure features work it require developers and testers who actually use the features. Some features might have been dropped because we want to rewrite it or do it differently.

* CD Ripper: Better options exist such as k3b, also the main focus is a music player, not a cd ripper.
* Podcast support: Work was started on integrating it, but due to lack of time, it was never finished.
* Various streaming services and radios: These require each a API token for Strawberry, they require lot of work to test, maintain and make sure they work for each release, an account with each service, also, some of them were broken.
* Cloud storage: Same as above, also few people use them and the main focus is local music.
* Song info: It is replaced by the context which also has lyrics.
* Artist bio: It depended on clementine services. Work started on a new one, but didn't find a good API with artist biography.
* Visualizations: It's partial broken in Clementine. We have attempted to add this back, but because of major changes in the Qt framework and a new projectM API, it's has not been resolved yet. Getting projectM to work with Qt has been challenging, so it's possible this won't get added.
* The extras stuff and background streams.
* Network remote: We don't have an android app. Because of lack of contributors we have currently decided not to add it at this time.
* WII remote control: Few people use it, we don't have anyone to maintain the code.

Differences from Clementine

2024-11-23T15:57:51Z

Jonas: /* Other */

Strawberry is a fork of Clementine, it looks and behaves very similar. Beneath the hood there are more changes than immediately seen in the GUI. Also, it does not include all features that Clementine got, but focus on other features instead.

== Project goals, focus and advantages ==

* Active development
* Migrated to Qt 6
* Frequent stable releases
* Focus on local music playback
* Focus on playback of high resolution audio and without resampling
* Focus on code improvements and bugfixes instead of adding more features
* Adapt faster to newer libraries and API changes
* Depend on less libraries and less 3rdparty code

== Playpack ==

* Advanced audio output and device configuration for bit-perfect playback on Linux
* The GStreamer engine code is different and uses playbin
* GStreamer engine is changed so that the analyzer does not cause resampling
* Equalizer elements in the pipeline are not activated unless the equalizer is enabled which fixes problems with resampling
* Error handling is improved
* Option to disable volume

== Other ==

* The collection model has been rewritten.
* New context view with song playing info and album cover
* Improved album cover fetching and cover manager with better album covers from Tidal and Deezer
* Lyrics are retrieved using API's instead of scraping HTML
* New rewritten scrobbler with caching and support for multiple providers: Last.fm, Libre.fm and ListenBrainz
* The queue manager is moved into the tab for easier access
* Improved playlist background image settings for displaying album cover and custom image
* Option to automatically save album covers to the album directory
* Streaming support for Subsonic, Tidal, Qobuz and Spotify
* Tabbar is improved
* Organizing music is improved
* Transcoding music is improved
* Settings have been reorganized
* New global shortcuts backend for X11 and Windows
* Lots of improvements to code and bugfixes

== Features missing ==

Some features found in Clementine have not been included.
Some of them, like the internet services and song and artist bio depended on clementine services.
Others have not been included to make maintaining the project easier and less time consuming.
Basically, the more code, the more job it is to maintain a project. Also, to make sure features work it require developers and testers who actually use the features. Some features might have been dropped because we want to rewrite it or do it differently.

* CD Ripper: Better options exist such as k3b, also the main focus is a music player, not a cd ripper.
* Podcast support: Work was started on integrating it, but due to lack of time, it was never finished.
* Various streaming services and radios: These require each a API token for Strawberry, they require lot of work to test, maintain and make sure they work for each release, an account with each service, also, some of them were broken.
* Cloud storage: Same as above, also few people use them and the main focus is local music.
* Spotify: A new Spotify integration based on GStreamer has been made and will be available in the next release on Linux and Windows MSVC.
* Song info: It is replaced by the context which also has lyrics.
* Artist bio: It depended on clementine services. Work started on a new one, but didn't find a good API with artist biography.
* Visualizations: It's partial broken in Clementine. We have attempted to add this back, but because of major changes in the Qt framework and a new projectM API, it's has not been resolved yet. Getting projectM to work with Qt has been challenging, so it's possible this won't get added.
* The extras stuff and background streams.
* Network remote: We don't have an android app. Because of lack of contributors we have currently decided not to add it at this time.
* wii remote control: Few people use it, we don't have anyone to maintain the code.

Differences from Clementine

2024-11-23T15:57:02Z

Jonas: /* Features missing */

Strawberry is a fork of Clementine, it looks and behaves very similar. Beneath the hood there are more changes than immediately seen in the GUI. Also, it does not include all features that Clementine got, but focus on other features instead.

== Project goals, focus and advantages ==

* Active development
* Migrated to Qt 6
* Frequent stable releases
* Focus on local music playback
* Focus on playback of high resolution audio and without resampling
* Focus on code improvements and bugfixes instead of adding more features
* Adapt faster to newer libraries and API changes
* Depend on less libraries and less 3rdparty code

== Playpack ==

* Advanced audio output and device configuration for bit-perfect playback on Linux
* The GStreamer engine code is different and uses playbin
* GStreamer engine is changed so that the analyzer does not cause resampling
* Equalizer elements in the pipeline are not activated unless the equalizer is enabled which fixes problems with resampling
* Error handling is improved
* Option to disable volume

== Other ==

* The collection model has been rewritten.
* New context view with song playing info and album cover
* Improved album cover fetching and cover manager with better album covers from Tidal and Deezer
* Lyrics are retrieved using API's instead of scraping HTML
* New rewritten scrobbler with caching and support for multiple providers: Last.fm, Libre.fm and ListenBrainz
* The queue manager is moved into the tab for easier access
* Improved playlist background image settings for displaying album cover and custom image
* Option to automatically save album covers to the album directory
* Streaming support for Subsonic and Tidal
* Tabbar is improved
* Organizing music is improved
* Transcoding music is improved
* Settings have been reorganized
* New global shortcuts backend for X11 and Windows
* Lots of improvements to code and bugfixes

== Features missing ==

Some features found in Clementine have not been included.
Some of them, like the internet services and song and artist bio depended on clementine services.
Others have not been included to make maintaining the project easier and less time consuming.
Basically, the more code, the more job it is to maintain a project. Also, to make sure features work it require developers and testers who actually use the features. Some features might have been dropped because we want to rewrite it or do it differently.

* CD Ripper: Better options exist such as k3b, also the main focus is a music player, not a cd ripper.
* Podcast support: Work was started on integrating it, but due to lack of time, it was never finished.
* Various streaming services and radios: These require each a API token for Strawberry, they require lot of work to test, maintain and make sure they work for each release, an account with each service, also, some of them were broken.
* Cloud storage: Same as above, also few people use them and the main focus is local music.
* Spotify: A new Spotify integration based on GStreamer has been made and will be available in the next release on Linux and Windows MSVC.
* Song info: It is replaced by the context which also has lyrics.
* Artist bio: It depended on clementine services. Work started on a new one, but didn't find a good API with artist biography.
* Visualizations: It's partial broken in Clementine. We have attempted to add this back, but because of major changes in the Qt framework and a new projectM API, it's has not been resolved yet. Getting projectM to work with Qt has been challenging, so it's possible this won't get added.
* The extras stuff and background streams.
* Network remote: We don't have an android app. Because of lack of contributors we have currently decided not to add it at this time.
* wii remote control: Few people use it, we don't have anyone to maintain the code.

Differences from Clementine

2024-11-23T15:56:30Z

Jonas: /* Playpack */

Strawberry is a fork of Clementine, it looks and behaves very similar. Beneath the hood there are more changes than immediately seen in the GUI. Also, it does not include all features that Clementine got, but focus on other features instead.

== Project goals, focus and advantages ==

* Active development
* Migrated to Qt 6
* Frequent stable releases
* Focus on local music playback
* Focus on playback of high resolution audio and without resampling
* Focus on code improvements and bugfixes instead of adding more features
* Adapt faster to newer libraries and API changes
* Depend on less libraries and less 3rdparty code

== Playpack ==

* Advanced audio output and device configuration for bit-perfect playback on Linux
* The GStreamer engine code is different and uses playbin
* GStreamer engine is changed so that the analyzer does not cause resampling
* Equalizer elements in the pipeline are not activated unless the equalizer is enabled which fixes problems with resampling
* Error handling is improved
* Option to disable volume

== Other ==

* The collection model has been rewritten.
* New context view with song playing info and album cover
* Improved album cover fetching and cover manager with better album covers from Tidal and Deezer
* Lyrics are retrieved using API's instead of scraping HTML
* New rewritten scrobbler with caching and support for multiple providers: Last.fm, Libre.fm and ListenBrainz
* The queue manager is moved into the tab for easier access
* Improved playlist background image settings for displaying album cover and custom image
* Option to automatically save album covers to the album directory
* Streaming support for Subsonic and Tidal
* Tabbar is improved
* Organizing music is improved
* Transcoding music is improved
* Settings have been reorganized
* New global shortcuts backend for X11 and Windows
* Lots of improvements to code and bugfixes

== Features missing ==

Some features found in Clementine have not been included.
Some of them, like the internet services and song and artist bio depended on clementine services.
Others have not been included to make maintaining the project easier and less time consuming.
Basically, the more code, the more job it is to maintain a project. Also, to make sure features work it require developers and testers who actually use the features. Some features might have been dropped because we want to rewrite it or do it differently.

* CD Ripper: Better options exist such as k3b, also the main focus is a music player, not a cd ripper.
* Podcast support: Work was started on integrating it, but due to lack of time, it was never finished.
* Various streaming services and radios: These require each a API token for Strawberry, they require lot of work to test, maintain and make sure they work for each release, an account with each service, also, some of them were broken.
* Cloud storage: Same as above, also few people use them and the main focus is local music.
* Spotify: A new Spotify integration based on GStreamer has been made and will be available in the next release on Linux and Windows MSVC.
* Song info: It is replaced by the context which also has lyrics.
* Artist bio: It depended on clementine services. Work started on a new one, but didn't find a good API with artist biography.
* Visualizations: It's partial broken in Clementine. We have attempted to add this back, but because of major changes in the Qt framework and a new projectM API, it's has not been resolved yet. Getting projectM to work with Qt has been challenging.
* The extras stuff and background streams.
* Network remote: We don't have an android app. Because of lack of contributors we have currently decided not to add it at this time.
* wii remote control: Few people use it, we don't have anyone to maintain the code.

Differences from Clementine

2024-11-23T15:56:15Z

Jonas: /* Project goals, focus and advantages */

Strawberry is a fork of Clementine, it looks and behaves very similar. Beneath the hood there are more changes than immediately seen in the GUI. Also, it does not include all features that Clementine got, but focus on other features instead.

== Project goals, focus and advantages ==

* Active development
* Migrated to Qt 6
* Frequent stable releases
* Focus on local music playback
* Focus on playback of high resolution audio and without resampling
* Focus on code improvements and bugfixes instead of adding more features
* Adapt faster to newer libraries and API changes
* Depend on less libraries and less 3rdparty code

== Playpack ==

* Support for multiple backends including Gstreamer and VLC engine
* Advanced audio output and device configuration for bit-perfect playback on Linux
* The GStreamer engine code is different and uses playbin
* GStreamer engine is changed so that the analyzer does not cause resampling
* Equalizer elements in the pipeline are not activated unless the equalizer is enabled which fixes problems with resampling
* Error handling is improved
* Option to disable volume

== Other ==

* The collection model has been rewritten.
* New context view with song playing info and album cover
* Improved album cover fetching and cover manager with better album covers from Tidal and Deezer
* Lyrics are retrieved using API's instead of scraping HTML
* New rewritten scrobbler with caching and support for multiple providers: Last.fm, Libre.fm and ListenBrainz
* The queue manager is moved into the tab for easier access
* Improved playlist background image settings for displaying album cover and custom image
* Option to automatically save album covers to the album directory
* Streaming support for Subsonic and Tidal
* Tabbar is improved
* Organizing music is improved
* Transcoding music is improved
* Settings have been reorganized
* New global shortcuts backend for X11 and Windows
* Lots of improvements to code and bugfixes

== Features missing ==

Some features found in Clementine have not been included.
Some of them, like the internet services and song and artist bio depended on clementine services.
Others have not been included to make maintaining the project easier and less time consuming.
Basically, the more code, the more job it is to maintain a project. Also, to make sure features work it require developers and testers who actually use the features. Some features might have been dropped because we want to rewrite it or do it differently.

* CD Ripper: Better options exist such as k3b, also the main focus is a music player, not a cd ripper.
* Podcast support: Work was started on integrating it, but due to lack of time, it was never finished.
* Various streaming services and radios: These require each a API token for Strawberry, they require lot of work to test, maintain and make sure they work for each release, an account with each service, also, some of them were broken.
* Cloud storage: Same as above, also few people use them and the main focus is local music.
* Spotify: A new Spotify integration based on GStreamer has been made and will be available in the next release on Linux and Windows MSVC.
* Song info: It is replaced by the context which also has lyrics.
* Artist bio: It depended on clementine services. Work started on a new one, but didn't find a good API with artist biography.
* Visualizations: It's partial broken in Clementine. We have attempted to add this back, but because of major changes in the Qt framework and a new projectM API, it's has not been resolved yet. Getting projectM to work with Qt has been challenging.
* The extras stuff and background streams.
* Network remote: We don't have an android app. Because of lack of contributors we have currently decided not to add it at this time.
* wii remote control: Few people use it, we don't have anyone to maintain the code.

Compile Ubuntu

2024-11-23T15:52:28Z

Jonas:

Compiling on Ubuntu

Install the required dependencies:

apt install -y git make cmake gcc g++ gettext \
libglib2.0-dev libdbus-1-dev \
libboost-dev libsqlite3-dev libgnutls28-dev libicu-dev libasound2-dev libpulse-dev \
qt6-base-dev qt6-base-dev-tools qt6-tools-dev qt6-tools-dev-tools qt6-l10n-tools \
libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libgstreamer-plugins-good1.0-dev \
libchromaprint-dev libfftw3-dev libtag1-dev libcdio-dev libmtp-dev libgpod-dev libebur128-dev

Compile and install:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

Compile Debian

2024-11-23T15:51:58Z

Jonas:

Install required dependencies:

apt install -y \
git make cmake gcc g++ gettext \
libboost-dev libglib2.0-dev dpkg-dev libdbus-1-dev libsqlite3-dev libgnutls28-dev libicu-dev \
libasound2-dev libpulse-dev \
qt6-base-dev qt6-base-dev-tools qt6-tools-dev qt6-tools-dev-tools qt6-l10n-tools \
libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gstreamer1.0-alsa gstreamer1.0-pulseaudio \
libchromaprint-dev libfftw3-dev libtag1-dev libebur128-dev \
libcdio-dev libmtp-dev libgpod-dev

Compile:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

Compile openSUSE

2024-11-23T15:50:56Z

Jonas:

Compiling on openSUSE.

Install the required dependencies:

zypper in \
git make cmake gcc gcc-c++ tar gettext-tools \
glibc-devel glib2-devel glib2-tools dbus-1-devel alsa-devel libpulse-devel \
boost-devel sqlite3-devel libicu-devel \
qt6-core-devel qt6-gui-devel qt6-gui-private-devel qt6-widgets-devel qt6-concurrent-devel qt6-network-devel \
qt6-sql-devel qt6-dbus-devel qt6-test-devel qt6-base-common-devel qt6-sql-sqlite qt6-linguist-devel kdsingleapplication-qt6-devel \
gstreamer-devel gstreamer-plugins-base-devel \
libtag-devel libcdio-devel libgpod-devel libplist-devel libmtp-devel libusbmuxd-devel libchromaprint-devel libebur128-devel

Compile and install:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

Compile Fedora

2024-11-23T15:50:33Z

Jonas:

Compiling on Fedora

Install the required dependencies:

sudo dnf install \
glibc gcc-c++ git tar rpmdevtools make cmake glib man gettext \
boost-devel dbus-devel glib2-devel sqlite-devel alsa-lib-devel pulseaudio-libs-devel libicu-devel \
qt6-qtbase-devel qt6-qtbase-private-devel qt6-qttools-devel kdsingleapplication-qt6-devel \
gstreamer1-devel gstreamer1-plugins-base-devel \
libcdio-devel libgpod-devel libplist-devel libusbmuxd-devel libmtp-devel \
taglib-devel libchromaprint-devel fftw-devel libebur128-devel

Compile and install:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

Compile openSUSE

2024-11-23T15:50:21Z

Jonas:

Compiling on openSUSE.

Install the required dependencies:

zypper in \
git make cmake gcc gcc-c++ tar gettext-tools \
glibc-devel glib2-devel glib2-tools dbus-1-devel alsa-devel libpulse-devel \
boost-devel sqlite3-devel libicu-devel \
qt6-core-devel qt6-gui-devel qt6-gui-private-devel qt6-widgets-devel qt6-concurrent-devel qt6-network-devel \
qt6-sql-devel qt6-dbus-devel qt6-test-devel qt6-base-common-devel qt6-sql-sqlite qt6-linguist-devel kdsingleapplication-qt6-devel \
gstreamer-devel gstreamer-plugins-base-devel vlc-devel \
libtag-devel libcdio-devel libgpod-devel libplist-devel libmtp-devel libusbmuxd-devel libchromaprint-devel libebur128-devel

Compile and install:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

Compile macOS using macports

2024-11-23T15:50:07Z

Jonas:

Compiling on macOS using macports.

This guide is currently not maintained and might no longer work.

== Install xcode tools ==

xcode-select --install

== Install macports ==

Download and install macports from: https://www.macports.org/install.php

== Prepare macports ==

sudo port -v selfupdate

== Install dependencies ==

sudo port -N install glib2 pkgconfig cmake boost sqlite3 gnutls chromaprint fftw taglib libebur128 qt6-qtbase qt6-sqlite-plugin qt6-qttools gstreamer1 gstreamer1-gst-plugins-base gstreamer1-gst-plugins-good gstreamer1-gst-plugins-ugly gstreamer1-gst-libav libcdio libmtp libgpod libebur128
sudo port -N install gstreamer1-gst-plugins-bad +faac +fdk_aac

== Install create-dmg ==

mkdir -p ~/build
cd ~/build
git clone --recursive https://github.com/create-dmg/create-dmg
cd create-dmg
sudo make install

== Set environment variables ==

export GIO_EXTRA_MODULES=/opt/local/lib/gio/modules
export GST_PLUGIN_SCANNER=/opt/local/libexec/gstreamer-1.0/gst-plugin-scanner
export GST_PLUGIN_PATH=/opt/local/lib/gstreamer-1.0

== Prepare build ==

mkdir -p ~/build
cd ~/build
git clone https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

== Compile and create DMG ==

/opt/local/libexec/qt6/bin/qt-cmake .. -DCMAKE_BUILD_TYPE=Debug -DBUILD_WITH_QT6=ON -DUSE_BUNDLE=ON
make -j 4
make install
make deploy
make deploycheck
make dmg

You might get warnings in make deploy about missing gstreamer plugins because macports does not have all of them, they are not critical and Strawberry should still work.

== Install ==

To install, either open the DMG, drag Strawberry over to Applications, or manually copy the strawberry.app folder over to /Applications/

Compile macOS using homebrew

2024-11-23T15:49:48Z

Jonas:

Compile on macOS using homebrew

This guide is currently not maintained and might no longer work.

Homebrew is generally unsuitable for building strawberry since its missing several gstreamer plugins, specific macdeployqt patches and specific Qt and gstreamer modifications and patches.

Since Homebrew refuse enable certain gstreamer plugins and have been generally unwilling to accept patches, we can not give support for building strawberry with homebrew. This guide is provided as is, outdated and without any support. If you want access to the Wiki for editing, please e-mail us or contact us on the forum.

If you want support, consider donating for getting access to the official signed binaries of strawberry.

== Install xcode tools and brew package manager ==

xcode-select --install
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

== Install dependencies through brew ==

brew install pkg-config cmake ninja meson bison flex wget create-dmg gettext boost
brew install glib glib-openssl glib-networking gdk-pixbuf gobject-introspection orc
brew install libffi openssl sqlite fftw libmtp libplist libxml2 libsoup
brew install libogg libvorbis flac wavpack opus speex mpg123 lame twolame taglib chromaprint libebur128 libbs2b libcdio libopenmpt faad2 faac fdk-aac musepack game-music-emu
brew install qt6 gstreamer

== Set environment variables ==

export GIO_EXTRA_MODULES=$(brew --prefix)/lib/gio/modules
export GST_PLUGIN_SCANNER=$(brew --prefix)/opt/gstreamer/libexec/gstreamer-1.0/gst-plugin-scanner
export GST_PLUGIN_PATH=$(brew --prefix)/lib/gstreamer-1.0

== Prepare build ==

mkdir -p ~/build
cd ~/build
git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build

(If you already did `git clone`, do `git pull` to make sure you have the latest code).

== Configure build ==

cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH=$(brew --prefix)/opt/qt6/lib/cmake -DBUILD_WITH_QT6=ON -DUSE_BUNDLE=ON -DENABLE_SPARKLE=OFF -DICU_ROOT=$(brew --prefix)/opt/icu4c -DPROTOBUF_INCLUDE_DIRS=$(brew --prefix)/include -DENABLE_DBUS=OFF

== Build ==

make -j 4
make install

== Remove problematic unneeded plugins ==

sudo rm -rf $(brew --prefix)/opt/qt6/share/qt/plugins/virtualkeyboard $(brew --prefix)/opt/qt6/share/qt/plugins/platforminputcontexts
sudo rm -f $(brew --prefix)/Cellar/qt/*/share/qt/plugins/imageformats/libqpdf.dylib

== Manually copy files ==

You need to manually copy libsoup-3.0.0.dylib, as this library needs to be loaded by gstreamer at runtime:

mkdir -p strawberry.app/Contents/Frameworks
cp $(brew --prefix)/lib/libsoup-3.0.0.dylib strawberry.app/Contents/Frameworks/

== Deploy ==

make deploy

== Deploy check ==

Checks that all libraries are deployed correctly.

make deploycheck

== Create DMG ==

make dmg

== Install ==

To install, either open the DMG, drag Strawberry over to Applications, or manually copy the strawberry.app folder over to /Applications/

Compile Mageia

2024-11-23T15:49:30Z

Jonas:

Install required dependencies:

urpmi --force urpmi-debuginfo-install git glibc gcc-c++ make cmake gettext \
lib64boost-devel lib64sqlite3-devel lib64alsa2-devel lib64pulseaudio-devel \
lib64qt5core-devel lib64qt5gui-devel lib64qt5widgets-devel lib64qt5network-devel lib64qt5concurrent-devel \
lib64qt5sql-devel lib64qt5dbus-devel lib64qt5x11extras-devel lib64qt5help-devel libqt5test-devel \
lib64gstreamer1.0-devel lib64gstreamer-plugins-base1.0-devel lib64cdio-devel lib64gpod-devel \
lib64plist-devel lib64usbmuxd-devel lib64mtp-devel lib64raw1394-devel lib64taglib-devel \
lib64chromaprint-devel libgnutls-devel libfftw-devel protobuf-compiler dbus-devel

Compile and install:

git clone --recursive https://github.com/strawberrymusicplayer/strawberry
cd strawberry
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

(If you already did `git clone`, do `git pull` to make sure you have the latest code).