Lofi Radio Player - 专注工作学习的桌面 Lofi 电台

Lofi Radio Player是一款基于 Electron 开发的桌面小部件音乐播放器，专为热爱 Lofi 音乐、需要专注工作学习的用户打造。无需本地音源、无需配置、即开即用，摆脱直播间束缚，让 LofiGirl 电台成为陪伴你身边的专注伙伴。

GitHub：https://github.com/labilio/lofi-radio

产品初心

Lofi 音乐被证实是最适合专注工作学习的音乐类型，LofiGirl 电台风靡全球，但国内用户仅能通过 B 站直播间收听，受弹幕、动画等干扰，且无法便捷控制。

这款播放器的核心目标：让专注不受干扰，让陪伴触手可及

不做「听歌工具」，只做「专注助手」
弥补电脑端「灵动岛」+「专注计时」的市场空缺
无需翻墙、无需配置，一键启动，安静陪伴

Lofi Radio Player – 专注工作学习的桌面 Lofi 电台插图1

核心功能

1. 7×24 小时无限播放

同步 LofiGirl 电台内容，无间断播放适合专注的安静 Lofi 音乐
无循环歌单、不重复曲目，告别听腻的烦恼（区别于 QQ 音乐/网易云的有限歌单）
无需本地音源，联网即可使用，不占用本地存储

2. 双形态自由切换

形态	特点	适用场景
普通模式	旋转发光黑胶唱片质感，毛玻璃精美 UI	桌面展示，追求视觉沉浸感
Mini 模式	仿手机灵动岛设计，小巧胶囊形态	专注工作，避免视觉干扰，节省桌面空间

3. 全局快捷键控制

无需切换窗口，专注不中断，一键控制播放/暂停：

Windows 系统：ALT + Q
macOS 系统：Option + Q

4. 桌面陪伴 + 专注计时

支持窗口置顶，可拖拽放置在屏幕任意位置，安静陪伴不打扰
内置专注计时器（类似 Forest/番茄 To Do），听歌+计时一站式完成
无动画、无弹幕、无任何多余干扰，只保留核心音乐和计时功能

5. 跨平台兼容

支持 Windows、macOS 系统，后续将适配 Linux 系统。

下载与使用

前置说明

无需安装额外依赖，下载对应系统安装包即可使用
无广告、无后台进程，不占用过多系统资源

安装步骤

前往 Releases 页面，下载对应系统的安装包：
- Windows：.exe 安装程序
- macOS：.dmg 镜像文件
安装并启动应用：
- macOS 用户提示：首次打开可能需要右键点击应用 → 选择「打开」，或在「系统设置 – 隐私与安全性」中允许运行未签名应用
- Windows 用户提示：直接双击安装包，按照向导完成安装即可
启动后自动开始播放音乐，无需额外配置，即开即用

基本操作

拖拽窗口：任意形态下，拖拽窗口边缘/标题栏即可移动位置
形态切换：点击窗口右下角「Mini」/「Normal」按钮切换双形态
播放/暂停：使用全局快捷键 ALT/Option + Q，或点击窗口内播放按钮
专注计时：在窗口内设置计时时长，点击「开始」即可启动专注计时

快捷键大全

快捷键	功能	支持系统
`ALT + Q` / `Option + Q`	暂停/恢复播放音乐	所有系统
`ESC`	退出 Mini 模式（返回普通模式）	所有系统
`Ctrl + W` / `Command + W`	关闭应用	所有系统

技术实现

核心技术栈

框架：Electron（跨平台桌面应用开发）
UI 渲染：HTML + CSS + JavaScript（毛玻璃效果、黑胶旋转动画）
音频播放：Electron webContents + 网络音频流解析
全局快捷键：Electron globalShortcut API
数据存储：本地轻量存储（记录计时历史、窗口位置等）

项目结构（简要）

lofi-radio-player/
├── src/
│   ├── main/           # Electron 主进程（窗口管理、快捷键、音频控制）
│   ├── renderer/       # 渲染进程（UI 界面、双形态切换、计时功能）
│   ├── assets/         # 静态资源（黑胶图片、图标等）
│   └── utils/          # 工具函数（音频流解析、本地存储等）
├── package.json        # 项目依赖与脚本配置
└── README.md           # 项目说明文档

开发与构建

# 1. 克隆仓库
git clone https://github.com/your-username/lofi-radio-player.git
cd lofi-radio-player

# 2. 安装依赖
npm install

# 3. 启动开发环境
npm run dev

# 4. 构建生产安装包
npm run build

常见问题

启动后无声音怎么办？
- 检查电脑网络是否正常（需联网获取音频流）
- 检查电脑音量是否开启，应用内音量是否调至合适大小
- 重启应用尝试解决
全局快捷键无法使用？
- 确认快捷键是否与其他应用冲突（可在应用设置中自定义快捷键，后续版本支持）
- macOS 用户：确认应用已获得「辅助功能」权限（系统设置 – 隐私与安全性 – 辅助功能）
窗口无法置顶？
- 右键点击应用托盘图标，选择「窗口置顶」即可开启

产品思考与设计权衡

为什么不做本地音源和歌单选择？
- 核心目标是「专注」，而非「听歌」，过多操作会干扰用户专注状态
- 避免用户陷入「选歌纠结」，实现真正的「即开即用」
为什么采用毛玻璃 UI + 黑胶动画，又提供 Mini 模式？
- 满足不同用户的需求：部分用户需要视觉沉浸感，部分用户需要无干扰专注
- 双形态切换实现「颜值」与「实用」的平衡
为什么不加入弹幕、动画等内容？
- LofiGirl 直播间的动画和弹幕虽有氛围感，但会分散用户注意力
- 本产品的核心是「辅助专注」，而非「消费内容」，剔除所有非核心干扰项
为什么要加入专注计时功能？
- 听 Lofi 音乐的用户本质需求是「专注完成任务」，计时功能是天然的补充
- 弥补「音乐 APP」与「学习 APP」的割裂，实现一站式专注解决方案