ClassiPod：iPod 经典风格音乐播放器

项目简介

ClassiPod 是一款以 iPod Classic 为灵感的音乐播放器，把经典点击轮（Click Wheel）交互带到 Android、iOS、macOS、Windows、Linux 和 Web 上。原生应用支持播放本地音频，也支持连接 Subsonic 兼容服务器（如 Navidrome）串流音乐；Web 版可以播放演示歌曲或连接服务器，但不能导入本地文件夹。

本地文件可离线播放；服务器音乐需要你自己的兼容服务器、账号和网络连接。应用不包含音乐订阅、服务器音频离线下载或服务器播放列表同步。

主要功能

• 音乐库：浏览歌曲、艺术家、专辑艺术家、专辑和流派；搜索歌曲、艺术家、专辑及 ClassiPod 播放列表。
• 本地与串流：Android 通过 MediaStore 发现音乐，iOS、macOS、Windows、Linux 可选择父级音乐文件夹并自动扫描子文件夹；连接 Subsonic 后可合并本地与服务器曲目，也可用 Hide Local Music 仅显示服务器音乐。
• 播放控制：旋转点击轮或触摸屏操作；上一首/下一首、快进快退、调节音量；按歌曲或整张专辑随机播放，并保持专辑曲目顺序；单曲循环或队列循环；重新打开后恢复上次队列与选中歌曲；支持 15/30/45/60 分钟或本曲结束的睡眠定时器。
• 显示与界面：Cover Flow 提供 Original 和 Big 布局，带专辑封面反光和动画过渡；支持浅色/深色屏幕主题与 Silver、Black、OLED Black 等机身配色；分屏预览、滚动标题、快速滚动字母提示、返回时恢复选中项和滚动位置。
• 其他体验：内置 iPod 风格点击轮音效、支持设备上的振动反馈、响应式布局与全屏沉浸模式、电量与充电状态显示、新手教程、多语言界面。
• 音频格式：支持 MP3、WAV、FLAC、M4A、MP4、Ogg、Opus、AAC、AIFF、APE、MOV 等，实际播放能力取决于平台。

安装与使用

各平台安装入口：

• Android：Google Play、F-Droid、APK
• Linux：AppImage、.deb、.rpm
• Windows：.exe
• iOS：.ipa，未签名，需要自行侧载并签名。
• macOS：.dmg，支持 Apple Silicon 与 Intel，需要 macOS 12 或更高版本。
• Web：打开 Web App

连接 Subsonic 或 Navidrome：打开 Settings → Library Settings → Subsonic，输入服务器基础 URL（包含反向代理路径）、用户名和密码。ClassiPod 支持使用 Token 认证的 Subsonic API 1.13+ 服务器，保存前会检查连接。Configure Subsonic 可编辑或移除连接；关闭 Subsonic 会保留配置和缓存，但隐藏其曲目并停止服务器播放。Refresh Library 获取新目录，Re-index 还会清除服务器封面缓存。

注意事项

• Web 版不能导入本地音乐；服务器必须允许来自 ClassiPod 站点的 CORS，HTTPS 页面会阻止 HTTP 服务器。
• 原生应用允许用户配置的 HTTP 服务器（包括局域网 IP），但 HTTP 流量未加密，建议优先使用 HTTPS。
• 原生应用的密码使用操作系统安全存储；Web 版密码在重新加载后失效，需要通过 Configure Subsonic 重新输入或开始播放时重新输入。
• Linux 安全存储依赖系统 Secret Service/libsecret；Windows 构建需要 Visual Studio ATL 组件。
• 歌曲评分和编辑仅保存在 ClassiPod 中，不会写回服务器。
• 即将推出的功能包括 iPod 内置游戏，以及查看设备中的照片和视频。

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