Skip to content

heartached/Noctis

Repository files navigation

 Noctis

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

License: MIT Platform .NET Downloads Build

Discord

DownloadDiscordFeaturesBuildFeedback


Screenshots


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

It packs a horizon of features including,

  • Lossless audio support — FLAC, ALAC, WAV, AIFF, APE, WavPack (plus MP3, AAC, OGG, Opus, WMA, M4A)
  • Gapless playback & crossfade
  • 10-band equalizer with presets
  • Replay Gain & loudness normalization
  • Audio converter — batch transcode to FLAC, MP3, AAC, and more (ffmpeg-backed)
  • Cover Flow view for browsing albums
  • Dynamic ambient backgrounds on lyrics and album pages
  • Animated cover art for the now-playing track
  • Custom themes & accent colors
  • Side lyrics panel alongside any view
  • Synced lyrics via LRCLIB and NetEase with offline cache
  • Plain + synced lyrics editor with .lrc sidecar export
  • Drag-and-drop import
  • Multi-select with bulk actions across every view
  • Full metadata editor with artwork, lyrics, and per-track options
  • Release-type aware sections (Albums / Singles / EPs / Compilations) with filter chips
  • Smart playlists, favorites, and drag-reorder playlist management
  • Library statistics with play counts, genre distribution, and listening trends
  • Navidrome, SMB, and WebDAV remote sources with offline cache
  • Artist images & bios via MusicBrainz and Deezer; artwork lookup via iTunes
  • Last.fm scrobbling + album descriptions
  • ListenBrainz scrobbling
  • Discord Rich Presence integration
  • In-app self-update from GitHub releases

Build

git clone https://github.com/heartached/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