Noctis：无损音乐播放器

项目简介

Noctis 是一款基于 Avalonia（.NET）开发的桌面音乐播放器，定位是「尊重你拥有的一切」——零追踪、完全掌控。它以本地音乐库为核心，同时支持连接流媒体服务器与自托管，覆盖 Windows、macOS 和 Linux 三个平台。

艺术家页面

逐字卡拉 OK 歌词

Cover Flow

主题与强调色

主要功能

声音

• 支持 FLAC、ALAC、WAV、AIFF、APE、WavPack、MP3、AAC、OGG、Opus、WMA、M4A 及 M4B 有声书
• Windows 上支持 bit-perfect 独占输出
• 参数均衡器（EQ），带预设，也可为单曲保存独立预设
• 无缝播放、交叉淡入淡出与 AutoMix 过渡
• ReplayGain 与 Sound Check 音量均衡
• 自动检测 BPM 与调性
• Track Radio 与自动播放，队列播完后继续推荐
• 基于 ffmpeg 的批量格式转换
• 支持 Audio CD 播放
• 多声道上混、独立于播放速度的变调
• 频谱窗口与音频可视化（Bars、Mirror、Wave）

音乐库

• 歌曲、专辑、艺术家、文件夹、播放列表视图；专辑细分为 Albums、Singles 与 EPs
• 智能播放列表、收藏、星级评分与播放次数
• 完整元数据编辑器，可管理封面、歌词与单曲选项
• 通过 Deezer、MusicBrainz 和 Apple Music 自动打标签与搜索封面
• 拖放导入、监听文件夹、批量编辑
• 支持从 Exportify CSV、TuneMyMusic JSON 和 m3u 导入播放列表
• 重复文件查找与文件整理工具、命令面板
• 聆听统计，含月度与年度 Wrap
• 艺术家页含 Top Songs、About、Similar Artists 与 Deezer 粉丝数
• 可从 TIDAL、Deezer 链接导入播放列表与专辑
• 从 YouTube 添加、发送到文件夹、文件关联打开
• Explicit 内容开关与专辑 Explicit 标记
• 可编辑分隔符的「按…分组艺术家」，播放列表与侧边栏支持拖放
• 键盘快捷键可重新绑定

歌词

• Apple Music 风格的逐字卡拉 OK 歌词
• 读取纯文本、LRC、逐词 LRC、TTML 与 Lyricsfile 旁车文件
• 自动从 LRCLIB 与网易云获取并离线缓存
• 歌词面板可在任意页面常驻
• 显示词曲作者与制作人（Written By）
• 内置歌词编辑器，可导出 .lrc
• 歌词可分享为图片卡片或短视频
• Lyrics Studio：在本机用 Whisper 做语音到歌词的对齐
• 歌词页支持按歌曲或专辑设置视频 / GIF 背景，封面位可放 MV
• 全局歌词偏移与从文件导入歌词

外观

• Cover Flow 浏览，提供 Carousel、Cascade、Collage 布局
• Now Playing 封面可选 CD、黑胶唱片或磁带样式
• 动态封面、歌词页环境模糊背景
• 主题与强调色，含自定义主题编辑器
• Liquid Glass 半透明窗口模式
• 可缩放迷你播放器，含搜索、队列、音量与卡拉 OK 歌词
• Kawarp 扭曲背景、专辑页按封面取色、强调色可跟随封面
• 设置分为 13 个可搜索页面

连接与插件

• 从 Jellyfin、Navidrome、Airsonic、Gonic 或任意 Subsonic 服务器串流
• 内置 Noctis Server，可把音乐库串流给 Symfonium、substreamer、Feishin 等 Subsonic 客户端
• Discord Rich Presence、Last.fm 与 ListenBrainz 记录
• Web 遥控，可用手机控制播放
• 各平台媒体键，Windows 任务栏控制与进度显示
• 睡眠定时、托盘图标、开机启动、从 GitHub Releases 自动更新
• 三种扩展方式：Content packs（纯 JSON 主题/歌词预设/语言）、Local API（127.0.0.1 上的 HTTP + JSON，可接 Stream Deck、OBS 等）、以及基于 Noctis.Plugins.Abstractions SDK 的 .NET 插件
• 界面支持英语、阿拉伯语、法语、日语、韩语、俄语、西班牙语、土耳其语、简体中文和繁体中文，切换语言无需重启

安装与使用

Windows 可通过包管理器安装：

# winget
winget install heartached.Noctis

# Scoop（先添加 bucket，再安装）
scoop bucket add noctis https://github.com/heartached/scoop-bucket
scoop install noctis

也可以从 latest release 下载安装包或便携 zip。

macOS 与 Linux：从 latest release 下载 .dmg 或 AppImage，均自带所需依赖。

macOS 首次运行需清除 Gatekeeper 隔离标记：

xattr -dr com.apple.quarantine /Applications/Noctis.app

Linux AppImage：

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

自托管服务器（NAS、VPS 或 Docker）：

docker build -t noctis-server .
docker run -d --name noctis -p 4747:4747 -v /path/to/music:/music:ro -v noctis-data:/data noctis-server
docker exec -it noctis /app/noctis-server user add alice

从源码构建需要 .NET 10 SDK：

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

注意事项

• Windows 安装包未做代码签名，可能被提示为不受信任，这对独立软件属正常现象。
• macOS / Linux 的发布构建未签名，macOS 需手动清除隔离标记后才能正常打开。
• 只有从源码构建时才需要处理原生依赖 libvlc：Windows 通过 NuGet 自动打包；macOS 需安装 VLC（brew install --cask vlc）；Linux 需安装对应开发包（如 sudo apt install libvlc-dev、sudo dnf install vlc-devel、sudo pacman -S vlc）。官方发布包已内置所需依赖。
• 支持的平台：Windows 10/11（x64）、macOS 12+（Intel 与 Apple Silicon）、Linux（x64 与 ARM64）。

---

本作品整理自 GitHub 开源项目 heartached/Noctis，原作者 @heartached，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。