The Apple sign-in window does not finish
- Close the sign-in window and select Sign in again.
- Make sure you sign in with the Apple ID that has your Apple Music subscription.
- If Apple asks for two-factor verification, finish it in the same window.
Your library shows an error or “403”
A 403 means Apple refused the request for your library.
- Update to the latest Arlet version. Arlet v0.1.0 could not load libraries; v0.1.1 fixed it.
- Check that your Apple Music subscription is active on music.apple.com with the same Apple ID.
- Select Try again on the page.
- If it keeps failing, use Settings > Account > Sign out, then sign in again.
Songs do not play
- Check that you are signed in; the status at the top left should show Connected.
- Check your internet connection. Without one, Arlet shows your cached library but cannot play.
- Check the Windows volume mixer for Arlet.
- Restart Arlet. If the window turns blank, Arlet reloads it automatically; restart if it does not recover.
Arlet says its access token has expired
Install the latest Arlet update from rosie.run/arlet/downloads. Each release’s Apple Music developer token lasts about six months.
Arlet opens off-screen or at an odd size
Use Settings > Reset to restore the default window. Arlet also falls back to the default when its saved position is on a monitor that is no longer connected.
Still stuck?
Copy the report from Settings > Support > Copy diagnostics report and include it when you contact support or open an issue on GitHub. The report leaves out tokens and account data.