FAQ
The most common questions about Halo Music. If your question isn't answered here, ask on GitHub Issues.
Search and playback
Why does the same song appear more than once?
Results come from several platforms, and different platforms may have both an official version and covers with the same title. Results are de-duplicated by title and artist, but versions from different sources are kept so playback can fall back when one fails.
Why do some songs only play for 30 seconds?
Free sources only provide a preview clip for some licensed tracks. The player detects this and tries to switch to a full version; if none is available it skips to the next song.
Nothing happens when I press play, or playback fails. What now?
Usually the upstream source is temporarily unavailable. The player tries other routes and versions automatically; you can also retry later or try another search result.
Why is the quality label sometimes missing?
The label only appears when the quality is confirmed. Unconfirmed tracks are never labeled "lossless" to avoid misleading you.
Accounts and data
Do I need an account for favorites and playlists?
Search and playback need no account. Favorites, playlists, and listening stats require signing in, and then sync across devices.
Does the site store what I listen to?
When signed in, the track ID, title, artist, duration, and play time are written to your listening history. It is only used to show you your listening stats, never for profiling. See the privacy policy for details.
Can I delete my account?
Yes. In "My Info", open "Delete account", enter your password, and confirm. Your account, favorites, playlists, and listening history are deleted permanently.
I forgot my password. What can I do?
There is no self-service reset yet. Ask on GitHub Issues, or sign in with Google if you linked it before.
Playlists and data
How do I import my playlists?
Go to "My Music → Playlists → Import playlist" and paste a public playlist share link from NetEase Cloud Music, QQ Music, or Qishui Music. Large playlists are capped by the platform's per-import limit.
What is the exported JSON for?
It contains your favorites and all playlists, so you can back them up or import them on another device — handy when switching devices or recovering from an accidental delete.
Apps
How do the Windows / Android apps differ from the web app?
The apps wrap the web app and have the same features. The Android app additionally supports background playback, lock-screen, and notification controls. On iPhone, add the site to your Home Screen for a near-native full-screen experience.
Does the site offer audio downloads?
No. No audio files are stored or created; the download button only adds the song to your local favorites backup.