Nocturne

Nocturne is a Navidrome / Jellyfin client that brings all your music together in one place, Nocturne not only connects to existing instances but it's capable of installing and managing it's own Navidrome instance

---

Important

Please be aware that GNOME Code of Conduct applies to Nocturne before interacting with this repository.

Warning

AI generated issues and PRs will be denied, repeated offense will result in a ban from the repository.

Features

• Exploration by songs, artists, albums, radios and playlists
• Playlist management
• Mpris integration
• Integrated Navidrome instance management
• Cool interface
• Automatic lyrics fetching

Screenies

HomePage	Song Queue	Lyrics	Song List	Album Page

Dependencies

The following dependencies are requirements of the project.

• python3 >= 3.13
• gtk4
• libadwaita-1 >= 1.9
• glib-2.0 >= 2.84.0
• libsecret
• gstreamer
• blueprint-compiler >= 0.18.0

Build

Linux (Flatpak)

Dependencies are automatically managed and built depending on host environment.

flatpak-builder build com.jeffser.Nocturne.yml --force-clean --install-deps-from=flathub
flatpak-builder --run build com.jeffser.Nocturne.yml nocturne

macOS

1. Install Dependencies with Homebrew

brew install [email protected] meson ninja pkgconf \
  glib gtk4 libadwaita pygobject3 gstreamer \
  gobject-introspection libsecret \
  desktop-file-utils

2. Install Project & Packages

# 1. Install blueprint-compiler
git clone https://github.com/GNOME/blueprint-compiler
cd blueprint-compiler
meson build --prefix=/usr/local
sudo ninja install -C build
cd ..

# 2. Clone the project
git clone https://github.com/Jeffser/Nocturne/
cd Nocturne

# 3. Install python packages
python3 -m venv ./venv
source ./venv/bin/activate
pip install requests colorthief favicon mutagen mpris-server

3. Build Project

meson setup build --prefix=$HOME/.local
ninja -C build
ninja install -C build

4. Run Development Build

nocturne

Special Thanks

Translators

Language	Contributors
Spanish	Jeffry Samuel