Skip to content

heartached/Noctis

Repository files navigation

 Noctis

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

Discord   Downloads

License: MIT Platform .NET Build


Screenshots

Home

Cover Flow

Cover collage

Artists

Lyrics

Themes


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

# Chocolatey
choco install noctis

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

macOS / Linux — download the .dmg / AppImage from the latest release.


Features

Everything below ships in the box — no accounts, no upsells, no telemetry.

  • Lossless formats — FLAC, ALAC, WAV, AIFF, APE, WavPack (plus MP3, AAC, OGG, Opus, WMA, M4A)
  • Gapless playback & crossfade
  • Parametric equalizer with presets
  • Bit-perfect WASAPI exclusive output with a live signal-path badge (Windows)
  • ReplayGain & loudness normalization
  • Audio converter — batch transcode to FLAC, MP3, AAC, and more (ffmpeg-backed)
  • Floating mini player
  • Songs, Albums, Artists, Folders & Playlists views
  • Release-type aware sections (Albums / Singles / EPs / Compilations) with filter chips
  • Smart playlists, favorites & drag-to-reorder playlists
  • Full metadata editor with artwork, lyrics & per-track options
  • Drag-and-drop import and multi-select bulk actions in every view
  • Duplicate finder & file organizer (rename/move by metadata)
  • Command palette for fast navigation
  • Library statistics plus a "Wrap" year / month listening recap
  • Synced lyrics via LRCLIB & NetEase with offline cache
  • Plain + synced lyrics editor with .lrc sidecar export
  • Side lyrics panel alongside any view
  • Share lyrics as image cards or short video clips
  • Cover Flow album browsing
  • Animated cover art for the now-playing track
  • Dynamic ambient backgrounds on lyrics & album pages
  • Custom themes & accent colors with a built-in theme editor
  • Navidrome, SMB & WebDAV remote sources with offline cache
  • Web remote — control playback from your phone's browser over your LAN
  • Artist images & bios via MusicBrainz and Deezer; artwork lookup via iTunes
  • Last.fm scrobbling + album descriptions
  • ListenBrainz scrobbling
  • Discord Rich Presence
  • In-app self-update from GitHub releases

Build

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

Requirements: .NET 8 SDK

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

Native dependency — libvlc

  • Windows: bundled automatically via NuGet — nothing to install.
  • macOS: install VLC (Noctis loads libvlc from /Applications/VLC.app):
    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:
    # 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. After unzipping:

macOS:

cd Noctis-macos-arm64
xattr -dr com.apple.quarantine .   # remove Gatekeeper quarantine flag
./Noctis

Linux:

cd Noctis-linux-x64
chmod +x 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 — the app is safe to use.

About

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

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages