Skip to content

Repository files navigation

 Noctis

A music player that respects what's yours. Zero tracking, total control.

Discord   Downloads   Support

Platform


Screenshots

Word-by-word karaoke lyrics

Fullscreen lyrics

Home

Home

Cover Flow

Cover Flow

Album pages

Album page with the lyrics panel

Themes & accent colors

Themes

More screenshots: Hi-Res library, parametric EQ, lyrics panel, queue, artist pages
Hi-Res library Parametric EQ
Album page Queue

Artist pages


Install

Windows, via a package manager:

# winget
winget install heartached.Noctis

# Scoop (add the bucket once, then install)
scoop bucket add noctis https://github.com/heartached/scoop-bucket
scoop install noctis

Or download the installer or portable zip from the latest release.

macOS and Linux: download the .dmg or AppImage from the latest release. Both ship with everything they need, so there is nothing else to install.


Features

Sound

  • Plays FLAC, ALAC, WAV, AIFF, APE, WavPack, MP3, AAC, OGG, Opus, WMA and M4A
  • Bit-perfect exclusive output on Windows
  • Parametric EQ with presets, and a saved preset per track if you want one
  • Gapless playback, crossfade and AutoMix transitions
  • ReplayGain and Sound Check volume leveling
  • Automatic BPM and musical key detection
  • Track Radio and Autoplay keep the music going when the queue runs out
  • Batch converter between formats (ffmpeg)

Library

  • Songs, Albums, Artists, Folders and Playlists views
  • Albums split into Albums, Singles and EPs
  • Smart playlists, favorites, star ratings and play counts
  • Full metadata editor for artwork, lyrics and per-track options
  • Auto-tagging and cover art search using Deezer, MusicBrainz and Apple Music
  • Drag and drop import, watched folders, bulk edits
  • Playlist import from Exportify CSV, TuneMyMusic JSON and m3u files
  • Duplicate finder and file organizer
  • Command palette
  • Listening stats with a monthly and yearly Wrap

Lyrics

  • Word-by-word karaoke lyrics, Apple Music style
  • Reads plain text, LRC, word-level LRC, TTML and Lyricsfile sidecars
  • Auto-fetched from LRCLIB and NetEase, cached offline
  • Lyrics panel you can keep open next to any page
  • Written By credits for the songwriters and producers
  • Built-in lyrics editor with .lrc export
  • Share lyrics as image cards or short clips

Look and feel

  • Cover Flow browsing
  • Animated cover art
  • Ambient blurred backdrops on the lyrics page
  • Themes and accent colors, plus a custom theme editor
  • Liquid Glass translucent window mode
  • Resizable mini player with search, queue, volume and karaoke lyrics

Connect

  • Stream from Jellyfin, Navidrome, Airsonic, Gonic or any Subsonic server
  • Discord Rich Presence
  • Scrobble to Last.fm and ListenBrainz
  • Web remote so you can control playback from your phone
  • Media keys on every platform, plus Windows taskbar controls
  • Artist images from Deezer
  • Sleep timer, tray icon and launch at login
  • Updates itself from GitHub releases

Discord Rich Presence


Build

git clone https://github.com/heartached/Noctis
cd Noctis
dotnet run --project src/Noctis/Noctis.csproj

Requirements: .NET 10 SDK

Supported platforms: Windows 10/11 (x64), macOS 12+ (Intel and Apple Silicon), Linux (x64 and ARM64).

Native dependency: libvlc

The released downloads already carry everything they need. This only matters if you are building from source.

  • Windows: bundled automatically via NuGet, nothing to install.
  • macOS: install VLC, which Noctis loads from /Applications/VLC.app. Packaged release builds bundle their own copy of VLC inside the app, so a downloaded Noctis needs no VLC install.
    brew install --cask vlc
  • Linux: install via your package manager. The -dev package provides the unversioned libvlc.so symlink that the .NET loader looks for. The released AppImage bundles libvlc and its plugins, so it runs without this.
    # Debian/Ubuntu
    sudo apt install libvlc-dev
    # Fedora
    sudo dnf install vlc-devel
    # Arch
    sudo pacman -S vlc

Running a downloaded build (macOS / Linux)

The macOS and Linux artifacts on the Releases page are unsigned self-contained builds.

macOS, using the portable zip:

unzip Noctis-osx-arm64.zip
xattr -dr com.apple.quarantine Noctis.app   # remove Gatekeeper quarantine flag
open Noctis.app

Linux, using the AppImage:

chmod +x Noctis-x86_64.AppImage
./Noctis-x86_64.AppImage

Or the portable tarball, which extracts without a top-level folder:

mkdir noctis && tar -xzf Noctis-linux-x64.tar.gz -C noctis
chmod +x noctis/Noctis
./noctis/Noctis

Build for another OS

dotnet publish src/Noctis/Noctis.csproj -c Release -r linux-x64   --self-contained
dotnet publish src/Noctis/Noctis.csproj -c Release -r osx-arm64   --self-contained
dotnet publish src/Noctis/Noctis.csproj -c Release -r osx-x64     --self-contained
dotnet publish src/Noctis/Noctis.csproj -c Release -r linux-arm64 --self-contained

Star History

Star History Chart


Feedback

If you have any feedback about bugs, feature requests, etc. about the app, please let me know through issues.

Yours Truly, heartached.


License

MIT, see LICENSE


Warning

Windows may flag the installer as untrusted because it isn't code-signed. This is normal for indie software and the app is safe to use.

About

A modern lossless music player built on Avalonia with rich library features

Topics

Resources

Stars

179 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Contributors

Languages