Looper：离线音乐播放器

项目简介

Looper 是一款播放本地音乐文件的离线音乐播放器。把音乐文件夹交给它，它会建立可按歌曲、专辑、艺术家、流派或文件夹浏览的媒体库。

它的目标是在手机和 Linux、Windows 桌面上提供一致的界面，把专辑封面放在视觉中心：播放页、歌词页以及应用中的强调色都会取自当前封面的颜色。没有账号、没有广告、没有订阅，音乐只留在设备上；应用仅在获取歌词、检查更新等场景联网。

客户端使用 Flutter 与 Dart 开发，状态管理用 Riverpod，本地数据库为 Isar，播放基于 mpv（通过 mpv_audio_kit）。

主要功能

• 跟唱式歌词：支持逐词或逐行高亮，点击某一行可跳转到对应位置，时间轴有偏差时可以调整偏移量；歌词可在线获取，也可读取本地 .lrc 文件。
• Looper Analyze：生成收听报告，包含收听时长、连续收听天数、常听歌曲与艺术家、最忙碌的一天以及流派分布。
• 封面取色主题：播放器背景、按钮与高亮随曲目变化，也可以自行选择主题和字体。
• 18 段均衡器：拖动曲线调整音色，每段 ±20 dB。
• 断点续播：重新打开应用时恢复播放队列、曲目与播放位置。
• 快速搜索：按标题、艺术家、专辑或歌词中的一句搜索。
• Android 桌面小组件：提供 12 种布局。
• 桌面布局：Linux 和 Windows 上有侧边栏、宽幅网格与媒体键支持（Linux 使用 MPRIS）。
• 桌面首次启动引导：自动找到 Music 文件夹，一键完成媒体库设置。
• 14 种语言，包括中文、印地语、阿拉伯语、日语和韩语。
• 备份：可导出应用数据并在之后重新导入。

安装与使用

Android 版本可在 Google Play 获取，其他平台的安装包都在 Releases 页面。

Android（.apk）

下载对应架构的 APK：近几年的大多数手机用 arm64-v8a，较老的设备用 armeabi-v7a，模拟器用 x86_64。打开后点击「安装」即可，首次安装时系统会要求允许从浏览器或文件管理器安装应用。GitHub 版本可以在应用内自行更新。

Linux

Debian / Ubuntu / Mint：

sudo apt install ./looper-player.deb

Fedora 用 sudo dnf install ./looper-player.rpm，openSUSE 用 sudo zypper install ./looper-player.rpm。

AppImage 无需安装，赋予执行权限后直接运行：

chmod +x looper-player.AppImage
./looper-player.AppImage

便携压缩包解压后，进入 universal 目录运行 ./run.sh。

Windows

需要 64 位的 Windows 10 或 11。运行 looper-player_<version>_windows_x64-setup.exe 安装，只装到当前用户、无需管理员权限，会创建开始菜单项和可选的桌面快捷方式，并在「打开方式」中注册音频文件。也可以在「设置 > 应用」中卸载。

便携版：解压 looper-player_<version>_windows_x64.zip 到任意位置，运行 looper_player.exe，不会安装任何内容。

注意事项

• Windows 版本尚未代码签名，SmartScreen 可能提示警告，可选择「更多信息 > 运行 anyway」继续。
• 桌面版本首次启动会引导完成媒体库设置。
• 应用需要你自备音乐文件，并指向本地文件夹来建立媒体库。

---

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