Support

Do I need to manually create a Slack app?

Not necessarily. The recommended setup path lets Sound Status create and configure your Slack app automatically — you just provide a Slack config token from api.slack.com/apps and the wizard handles the rest. A manual path is also available if you prefer to create and manage the Slack app yourself.

What is a config code?

A config code (beginning with amss-) is generated by a workspace admin after completing setup. It encodes the Slack app credentials so that teammates can connect to the same Slack app without needing access to the Slack App Portal. Each person who uses a config code authorizes individually under their own Slack account and gets their own token stored in their own Keychain.

Can multiple people in my workspace use Sound Status?

Yes. One admin sets up the Slack app (automatically or manually), then shares their config code with teammates. Each team member pastes the code into the wizard and authorizes with Slack individually. Everyone gets their own token in their own Keychain — nothing is shared between users. Sound Status also supports multiple workspaces, so you can connect to as many Slack workspaces as you like from a single installation.

How do I add another workspace?

Open Preferences → Workspaces and click Add Workspace… The setup wizard runs again for the new workspace. Each workspace can be independently enabled, disabled, or removed from the Workspaces tab.

Does Sound Status send any data to your servers?

No. Sound Status has no backend. Your music metadata goes directly from your Mac to Slack's API over HTTPS, and your Slack token is stored only in the macOS Keychain on your device. During setup, the OAuth authorization flow briefly passes through a static page at soundstatus.io/oauth/callback to redirect you back to the app. This page contains no server-side code and does not read, log, or store any data. We collect no analytics, telemetry, or crash reports. See the Privacy Policy for full details.

What Apple Music information is shared with Slack?

Only the currently playing track's title, artist name, and album name are used. This metadata is formatted using your status template (e.g., {title} by {artist}) and sent to Slack to update your profile status. Nothing else from your library or listening history is accessed or transmitted.

My status isn't updating. What should I check?

A few things to verify:

• → Check the menu bar icon — if it shows a red exclamation mark, click it to see the error message.
• → Make sure the workspace is enabled in Preferences → Workspaces.
• → Confirm the Enabled toggle in the menu bar dropdown is checked.
• → If you recently re-authorized or your token expired, try re-authenticating from Preferences → Workspaces → Re-authenticate.
• → Check that quiet hours aren't active — the menu bar icon shows a moon when quiet hours are in effect.

How do I completely remove the app and its data?

Delete SoundStatus.app from your Applications folder, then remove the configuration folder at ~/Library/Application Support/sound-status/. To remove the stored tokens and OAuth config, open Keychain Access, search for sound-status, and delete any matching entries.

How do I report a bug or request a feature?

Send an email to contact@fultonengineeringservices.com with a description of the issue or feature request. For bugs, please include the macOS version, the app version (visible in Preferences), and a description of what you expected vs. what happened.