遇到问题先看下面几条,没解决就到仓库里开 issue。
问题反馈:GitHub Issues
产品主页:TinyMusic iOS · 桌面版
提 issue 时附上 iOS 版本、S3 服务类型和复现步骤,会快很多;不要贴完整的 Access Key / Secret Key。
前缀/歌单/歌手 - 歌名.m4a 放文件;同名 .lrc 和 .jpg/.png/.webp 会作为歌词和封面。在歌单或歌曲上点“缓存”,App 会用后台 URLSession 把音频、歌词、封面存进沙盒。缓存只用于 App 内播放,不能导出或分享,不出现在「文件」App 里,也不会进入 iCloud 备份。
S3 密钥写入 Keychain;开启 iCloud 钥匙串后可在自己的设备间同步。endpoint、bucket、prefix、缓存上限、仅 Wi-Fi、EQ 等非敏感设置走 iCloud Key-Value Storage。离线缓存不同步。
为什么歌单是空的?检查 prefix 是否和桶内目录一致,以及 Access Key 是否有 ListBucket / GetObject 权限。
为什么只能看不能收藏?只读密钥无法写 favorites.json,收藏会退回本机。
为什么播放失败?确认 endpoint 使用 HTTPS、bucket 允许 CORS 或公开读取,或使用预签名 URL 所需权限。
缓存和下载有什么区别?缓存只是 App 内部的离线副本,不能导出、分享或搬到别的播放器。
App 不收集账号、播放记录或缓存内容,只连接你自己的 S3 存储与 Apple 的 iCloud / Keychain 服务。详见 隐私政策。
Check the items below first. If that doesn't solve it, open an issue in the repo.
Issue tracker: GitHub Issues
Product page: TinyMusic for iOS · Desktop app
Include your iOS version, the S3 provider and the steps to reproduce — and never paste full Access Key / Secret Key.
prefix/playlist/artist - title.m4a; a matching .lrc and .jpg/.png/.webp become the lyrics and cover.Tap "Cache" on a playlist or a track and the app downloads the audio, lyrics and cover into its sandbox with a background URLSession. The cache is for in-app playback only: it can't be exported or shared, never shows up in the Files app, and is excluded from iCloud backup.
S3 keys go into the Keychain, and sync across your own devices when iCloud Keychain is on. Non-sensitive settings — endpoint, bucket, prefix, cache cap, Wi-Fi only, EQ — use iCloud Key-Value Storage. Offline cache is never synced.
Why is the playlist empty? Check that the prefix matches the folder layout in your bucket, and that the Access Key can ListBucket and GetObject.
Why can I only read, not favourite? A read-only key can't write favorites.json, so favourites fall back to this device.
Why does playback fail? Make sure the endpoint uses HTTPS, the bucket allows CORS or public reads, or that the key may sign URLs.
How is the cache different from a download? The cache is only an offline copy inside the app; you can't export it, share it or move it to another player.
The app collects no accounts, play history or cached content. It talks only to your own S3 storage and Apple's iCloud / Keychain services. See the privacy policy.