Liner：桌面音乐播放器

项目简介

Liner 是一款基于 Electron + TypeScript 构建的桌面音乐播放器，面向 Windows 和 Linux 用户。它可以把你在其他平台的音乐和歌单汇聚到一个干净的应用里：没有广告，也没有臃肿的功能，只保留同步歌词和你的曲目。界面还提供随音乐变化的动态视觉效果。

Liner 客户端连接官方 Liner API 后端，用于获取音乐目录、流媒体播放和同步歌词。

主要功能

• 统一曲库：把不同平台的音乐与歌单拉取到同一个应用中管理。
• 逐字同步歌词：支持音节级同步歌词，并提供全屏歌词页面。
• 动态视觉效果：全屏背景基于 WebGL 着色器，随播放呈现反应式动态画面。
• 本地曲目导入：可通过 liner-local:// 协议导入本地音频文件（见 electron/local-tracks/）。
• 悬浮播放器：提供独立的浮动 overlay 播放窗口（electron/overlay.ts）。
• 系统集成：支持 Discord Rich Presence、深链接、自动更新，以及 Windows 的 snap 预览插件。
• 多语言界面：内置 11 种语言翻译。

界面示例：

曲库 Library	全屏歌词 Fullscreen lyrics

安装与使用

环境要求

• Node.js v22+ 与 pnpm v10+
• Windows 10/11 或 Linux

获取源码并安装依赖

git clone https://github.com/tryliner/desktop.git
cd desktop
pnpm install

开发运行

# 启动 Electron 应用，带 Vite 热更新
pnpm dev

测试

# 仅运行测试
pnpm test

# 运行 CI 在 PR 上执行的完整检查：lint、格式检查、类型、构建、测试
pnpm check

打包构建

# Linux（AppImage 与 .deb）
pnpm electron:build:linux

# Windows（.exe 安装包）
pnpm electron:build:win

# macOS（.dmg 与 .zip，同时生成 Intel 与 Apple Silicon 版本）
pnpm electron:build:mac

macOS 构建会同时产出 x64（Intel）与 arm64（Apple Silicon）包；只想构建其中一个时，加上 --arm64 或 --x64。产物位于 release/ 目录。

参考文档

仓库 docs/ 目录包含以下说明：

• 设计规范：设计 token、玻璃质感表面、动效与构建块
• 存储：数据在设备上的存放位置，以及「清除缓存」会删除什么
• 隐私：应用会向外发送哪些数据
• 翻译：如何添加文案、复数形式与语言
• FAQ：常见问题解答

注意事项

• 应用依赖官方 Liner API 后端提供音乐目录、播放与歌词，因此使用过程中需要联网。
• 代码结构遵循 Feature-Sliced Design，渲染进程的导入只能自上而下：app → widgets → features → entities → shared。
• Liner 采用 Liner Source-Available & Non-Commercial Contribution License 授权：允许个人非商业使用、本地构建和向上游贡献；禁止商业分发、公开的竞争性 fork，或抽取核心算法用于第三方产品。具体条款见 LICENSE。

本作品整理自 GitHub 开源项目 tryliner/desktop，原作者 @tryliner。中文介绍由 AI 根据项目 README 整理，以原仓库为准。