Connect Mastodon

Mastodon is federated, so every instance issues its own credentials. Unison handles per-instance OAuth automatically. You can connect more than one account from different instances in the same workspace.

1. 1

   Open Settings → Channels and click Add channel.

2. 2

   Pick Mastodon from the network grid. Type the instance URL (for example mastodon.social or hachyderm.io).

3. 3

   You will be redirected to that instance to authorise. If Unison has not connected to it before it registers a new OAuth application automatically (one per instance).

4. 4

   Sign in to your Mastodon account on that instance and approve the requested scopes: read, write:statuses, write:media, write:follows, read:notifications (for the unified inbox).

5. 5

   Land back inside Unison. Your Mastodon channel appears with the instance hostname so you can tell apart multiple federated identities.

What you can publish

• Toots up to the instance limit (500 chars on most instances)
• Auto-thread on overflow
• Image and video media (instance-dependent file size limits)
• Content warnings, sensitive media flag, and visibility per toot (Public, Unlisted, Followers only, Direct)

Removing access

Disconnect inside Unison to delete the per-instance token. To revoke at your instance, open Preferences → Account → Authorized apps and remove Unison.