Strawberry Music Player Wiki - User contributions [en]

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).

Compile Arch

2024-11-23T15:49:13Z

Jonas:

Compiling on Arch.

Install the required dependencies:

pacman -S --noconfirm git make cmake gcc pkgconf gettext 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 Ubuntu

2024-11-23T15:48:57Z

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

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:48:38Z

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 \
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