Lokal：本地音乐库播放器

项目简介

Lokal 是一款本地优先（local-first）的音乐播放器，使用 Electron 和 React 构建。它面向拥有大型本地音乐库、希望获得现代流媒体应用般体验但不愿订阅的用户：读取的是你自己的文件，曲库、播放历史与数据库都保存在本地。

主要功能

• 逐词同步歌词：同时向 9 个歌词来源发起请求，按你设定的顺序取第一个命中的来源，支持翻译、罗马音、对唱与和声分行。可在 Settings → Playback 中拖动调整来源顺序或关闭来源；开启「优先音节歌词」后会继续寻找逐词时间轴而不是整行时间轴。
• 音乐视频：为正在播放的歌曲找到官方 MV，并与你自己的音频文件对齐时间（包含前奏、过场和加长剪辑），可用 − / + 微调偏移，Lokal 会记住该视频的偏移量。Videos 页面可列出曲库中找到的全部 MV，支持连播、收藏或下载到本地。
• 统一搜索与下载：搜索栏覆盖本地曲库，以及 YouTube Music、SoundCloud、Soulseek（通过 slskd）和你添加的 addons；在线结果可即时流式播放、加入播放列表或一键保存进曲库。也支持粘贴链接（YouTube、SoundCloud、Bandcamp 等 yt-dlp 支持的站点）下载单曲、专辑或整个播放列表，下载完成后自动入库并带标签、方形封面和歌词。
• 内置 Soulseek：在 Settings → Integrations → Soulseek 填入用户名和密码即可，Lokal 会自动下载、校验并后台运行 slskd 客户端。
• 新发行：Home → Releases 列出所关注艺人的最新专辑、EP 和单曲，第一周标记为 New；支持从 Spotify 或 Apple Music 导入关注列表。
• 发现、Mix 与电台：基于 Last.fm 或 YouTube Music 账号的推荐，优先从本地曲库播放，再回落到 YouTube Music、SoundCloud 或 addons。
• 收听回顾：为每周、每月、每年生成收听统计与可翻阅的故事页，并支持播放列表、艺人和回顾的分享卡片。
• 音质检查：将文件分为 Hi-res、Lossless、High、Low，识别假 FLAC，并可把所选内容批量升级为无损。
• 播放体验：全屏播放器、动态 canvas 封面、玻璃质感播放条、迷你播放器与淡入淡出；支持按规则自动填充的智能播放列表。
• 播放列表同步：可从链接、文件或粘贴列表导入，并与 Spotify、Tidal、Apple Music 或 Qobuz 关联，拉取其新增内容。
• 账号连接：Last.fm、ListenBrainz、YouTube Music、Discord，另有手机遥控。

安装与使用

从 GitHub Releases 下载最新版本安装包，Windows 版本通过 SignPath Foundation 进行代码签名。首次运行后会索引本地曲库。

主要设置在 Settings 中：Playback 用于调整歌词来源顺序与音乐视频画质上限；Library 用于选择下载格式（Original、MP3、M4A 或 Opus）；Addons 用于粘贴 addon 的 manifest URL。下载与在线播放依赖 yt-dlp，安装包中并不包含，需要按仓库文档的 Downloader Setup 自行配置。

Addons 兼容 Eclipse Music 的 addon 协议（manifest、/search、/stream，以及 addon 提供时的 /album、/artist 页面），同时也能运行 SpotiFLAC 扩展：添加仓库浏览来源，或安装 .sflx 包。

注意事项

• Lokal 完全本地运行：曲库、历史记录、数据库内容，以及用于调用 yt-dlp、LRCLIB 等 API 的信息，官方都不会看到。
• Lokal 不托管任何内容，在线播放使用你自己的 yt-dlp。
• Soulseek 是共享网络，其中的大部分内容受版权保护，请只下载你拥有的内容。
• 官方不附带 addon，也不为其托管或担保，添加哪些 addon 由使用者自行负责。
• 项目以 MIT 许可证开源，已知问题可查阅仓库中的 KNOWN_ISSUES.md，问题反馈走 GitHub Issues。

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