Support
Need help with Sound Status? Start below or reach out directly.
Getting Started
-
Launch Sound Status and open the setup wizard
On first launch, the setup wizard opens automatically. You can re-open it at any time from Preferences → Workspaces → Add Workspace…
-
Create a Slack app in your workspace
The wizard links directly to the Slack App Portal and walks you through creating a new app, then adds the required OAuth permission scopes:
users.profile:write,channels:read,groups:read, andchat:write. -
Paste your User OAuth token
After installing your Slack app, copy the User OAuth token (beginning with
xoxp-) from the Slack App Portal and paste it into the wizard. The token is validated against Slack's API and stored in the macOS Keychain — it never touches our servers. -
Play something in Apple Music
That's it. Sound Status updates your Slack status automatically whenever a track is playing and clears it when you pause or stop.
Frequently Asked Questions
Do I need to manually create a Slack app?
Yes, but the setup wizard makes it straightforward. You create the app in your own Slack workspace under your own account — Sound Status never touches your Slack workspace directly. The wizard links you to the right pages in the Slack App Portal and tells you exactly which settings to configure.
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. 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.
- → 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 Slack token(s), 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.
Contact
For support questions, bug reports, or anything else, reach out directly: