Privacy
Last updated 17 November 2026
Chroma is made and run by one person. This page covers what the Chroma app and chroma.pw collect, why, and who else handles it. What you share with the music app's maker is between you and them.
The daily check
The app asks chroma.pw whether a new release is out, once a day and at most every six hours. The request carries:
- a random install ID made on your phone, not tied to your name, Apple ID or music account
- the Chroma, music app and iOS versions, and the iPhone model
- how the app was installed and the kind of signing certificate
- your language and region settings
- which of a fixed list of features are on, and which lyrics sources
It shows which versions and features are in use and what to fix first. The records are kept per install and day and can't be matched to a person. Your IP address is used only to limit abuse: it is held in memory, hashed with a key that changes on every restart, and never stored. Turn the count off in the app under Privacy & clutter, Share anonymous usage; the update check then goes without it.
Crash reports
When the music app crashes with Chroma in it, iOS writes a report on the phone. At the next launch the app sends that report to chroma.pw with:
- the same random install ID as the daily check
- the Chroma, music app and iOS versions, the iPhone model and how the app was installed
- Chroma's own switches and sliders as numbers, never anything you typed, keys or names
- the names of other add-ons loaded into the app
iOS's report lists where in the code each thread of the app was; it holds no songs, messages or account details. A run that ended while the app was open and that iOS wrote no report about is sent with the same details and no report. Reports are kept for 90 days and used only to find and fix crashes. Turn them off in the app under Privacy & clutter, Send crash reports; reports not sent yet are deleted then. Your IP address is handled as for the daily check.
After a crash the app may ask what you were doing. What you write there is added to that report only if you tap Send. Turn the question off under Privacy & clutter, Ask what happened after a crash.
Problem reports
Reporting a problem needs a chroma.pw account. If you turn on Shake to report a problem and send a report while signed in, it goes to chroma.pw under your account, with what you write, the same details as a crash report, how the phone was doing when you shook it (how warm it was, battery level and Low Power Mode, free memory and storage, the kind of network and audio output without their names, screen size and orientation, accessibility settings that change how the app looks, and language), and what you leave attached:
- a screenshot of the screen you shook the phone on
- the layout of that screen: what is drawn where, with any text on it replaced by its length
- Chroma's own switches and sliders as numbers
- a screen recording, when you make one: a video of Chroma and Spotify as they showed while it ran, without sound, and a log of what moved, appeared or disappeared on screen and when, again with no text
The report shows you each attachment before it goes, and you can leave any of them out. A screenshot or recording shows whatever was on the screen, so turn it off if that was private. Reports are used only to find and fix problems. Each report is also copied to Chroma's private issue tracker, where fixes are planned: what you wrote and the details above, with the attachments shown from chroma.pw for as long as they are kept. Screenshots, layouts and recordings are deleted after 90 days. What you wrote, the details you add later and where each report stands stay with your account, so Your reports in the app shows them on any phone you sign in on. Closing your account removes your name from them.
Your account
An account is optional. Plus needs one. It holds:
- your e-mail address, and a password if you set one, stored only as a hash
- the devices you sign in on: a key made on the device, its name, model, iOS and Chroma version, its install ID, and when it was added and last seen
- your Plus status, including gift codes you redeem
- a log of sign-ins, device changes and Plus changes, with a short code derived from the IP address, not the address
Sign-in codes are sent by e-mail and expire after use. The log is kept for a year. The entry for Plus paid once, or for a year switched to it, stays with the account as the record of which terms were agreed to. The account stays until you ask for it to be deleted, which removes it with its devices and log.
Plus and Patreon
Plus is paid through Patreon or once through Ko-fi. Chroma never sees your card or payment details. When you link Patreon, chroma.pw receives your Patreon user ID and your membership's status and tier, and Patreon tells it when they change. When you buy on Ko-fi, Ko-fi sends chroma.pw the order's ID and the e-mail address you gave it; chroma.pw e-mails the code there and keeps only the order ID with the code. What you give Patreon or Ko-fi is covered by their own privacy policies.
Linking Discord is optional. chroma.pw then keeps your Discord user ID, username and display name, and the Discord bot gives that user the Plus role while Plus is on and keeps the names current. Unlinking deletes them. If you boost the Discord server, the bot asks chroma.pw for your gift code, and chroma.pw keeps your Discord user ID with that code so each booster gets one a month.
Plus features that go through chroma.pw
- Animated covers and artist logos. The app sends the album and artist name; chroma.pw asks Apple Music and keeps the answer for everyone who asks next. Daily totals per album or artist are kept without who asked; a per-device count for the daily limit is deleted after two days.
- Sing. The voice model downloads through links made for your device that expire.
- Audio presets and AutoEq. The lists are downloaded from chroma.pw.
- Workshop downloads. The app asks chroma.pw whether the shaders, lyrics shaders and lock screen styles you downloaded have a newer version, and tells it which shared audio presets you keep in your Library. chroma.pw keeps which of them your account has, with the day each was first and last seen, to count how many people use each one. Deleting the account deletes it.
- Settings backup. The app saves its switches and choices to your account, with the name of the device and the Chroma version they came from. It holds no sign-in, keys or tokens. Delete it in the app, or delete the account.
Straight from your phone
These go from the app to someone else without passing through chroma.pw:
- Lyrics: the sources you turn on (Musixmatch, LRCLIB, Genius, Spicy Lyrics) receive the song being looked up.
- Translate with Gemini: the lyrics lines and your own API key go to Google.
- The update check falls back to GitHub when chroma.pw doesn't answer.
This website
chroma.pw counts visits with Umami, hosted by Chroma, without cookies: the page, the referring site, the browser, the kind of device and the country. The account and sign-in pages load no analytics and use cookies only for signing in and linking Patreon or Discord. The patcher works in your browser and never uploads your IPA.
Who else handles data
- A hosting provider runs the server and database.
- A network provider carries the traffic to chroma.pw and stores the Sing model.
- An e-mail delivery service sends sign-in e-mails.
- Patreon takes payments and memberships.
- Discord runs the community server and learns who holds the Plus role.
- GitHub hosts the releases and the private issue tracker that problem reports are copied to.
Nothing is sold or used for ads.
Your rights
You can ask what is stored about you, have it corrected or deleted, or object to its use; write via [email protected]. You can also complain to the data protection authority in your country.
