Mastodon

Publish videos, images, and text posts to your Mastodon account on any instance in the fediverse.

Requirements

  • Instance: Any Mastodon instance (mastodon.social, fosstodon.org, hachyderm.io, or your own)
  • Video Size: Up to 40 MB per video (default; some instances allow more)
  • Image Size: Up to 10 MB per image
  • Supported Formats: MP4 video, JPEG, PNG, WebP or GIF images, plain text posts
  • Caption Length: 500 characters by default (varies per instance; ShortSync reads the limit from your instance at connect time)

How It Works

Mastodon is federated. Each instance is an independent server, and ShortSync connects to yours over standard OAuth. No password ever touches ShortSync.

Setup

1. Enter your instance domain

On the Connections page, click Connect now on the Mastodon card and type your instance domain (for example mastodon.social) or pick one of the suggested chips. If your handle looks like @alice@fosstodon.org, the instance is the part after the second @.

2. Authorize ShortSync

ShortSync sends you to your instance's sign-in page. Log in and click Authorize. ShortSync stores an encrypted access token and returns you to the Connections page.

ShortSync Connect Mastodon modal with the instance domain input and quick-pick chips for mastodon.social, fosstodon.org, mastodon.online, hachyderm.io, and mstdn.social

Polls

On a text post, click Add a poll under the caption, add 2 to 4 options and choose how long it stays open, from 5 minutes to 7 days. Your caption is the question. Tick Let people choose more than one option for a multiple-choice poll. The same poll goes to every selected platform that supports polls; posting to Mastodon alone allows options of up to 50 characters.

Polls only work on text posts. Some servers allow fewer or shorter options than the defaults; if yours does, the post fails with the server's reason.

Post options

Alt text

Describe your images and videos for people using screen readers, up to 1,500 characters each. A carousel gets one description per image. Many people on Mastodon only boost posts that have alt text.

Write it once in the Alt text card on the Caption step and it goes to every selected platform that supports alt text, or give Mastodon its own. See Platform settings.

Content warning

Turn on Content warning in the Mastodon settings and write a short Warning text (up to 100 characters), for example "spoilers" or "flashing lights". The post is hidden behind the warning until people tap it, and any media is marked sensitive and blurred.

Mastodon counts the warning toward the post's character limit, so a long caption is shortened to make room for it.

Mark media as sensitive

Without a content warning, you can still tick Mark media as sensitive to blur the image or video while keeping the text visible.

Who can quote it

Choose who can quote the post: Anyone, Followers or Just me (no one else can quote it).

Quote settings need Mastodon 4.5 or newer on your server. Older servers ignore the setting and post normally.

Mastodon settings with Content warning turned on, the warning text Flashing lights, and Followers picked under Who can quote it

Inbox

Replies to your posts and @mentions of your account show up in your Inbox, one conversation per post. You can reply from the Inbox and ShortSync adds the person's @handle for you.

A reply never reaches more people than the original: a reply to a private mention or a followers-only post keeps the same visibility.

Mastodon filters private mentions from people you don't follow into Filtered notifications, and those don't reach the Inbox. Accept the request in Mastodon (or follow the person) and the mention shows up on the next sync.

Common Issues

"Could not reach that Mastodon instance"

ShortSync pings the instance's /api/v2/instance endpoint to confirm it is really a Mastodon server before starting OAuth. If the domain is wrong, or the instance is temporarily down, you will see this error. Double-check the domain (no protocol, no path, e.g. mastodon.social) and try again.

Caption longer than 500 characters was truncated

Mastodon defaults to a 500-character cap, but many instances raise it (some go up to 5,000). ShortSync reads your instance's actual limit at connect time and uses that. If you moved to a larger-cap instance after connecting, reconnect the account to refresh the stored limit.

"Reconnect Mastodon to see replies and mentions"

The Inbox needs permission to read your Mastodon notifications, which accounts connected earlier didn't grant. Click Reconnect on the card in the Inbox. It takes you to your own server to approve the new permission. Posting keeps working whether or not you reconnect.

A private mention doesn't show up in the Inbox

Since Mastodon 4.3, private mentions from accounts you don't follow go to Filtered notifications instead of your notifications, and ShortSync only reads your notifications. In Mastodon, open Notifications, then Filtered notifications, and accept the request, or follow the person. The mention shows up on the next sync. You can also change this filter in Mastodon's notification settings.

Caption was shortened after adding a content warning

Mastodon counts the content warning toward the character limit. ShortSync shortens the caption by the warning's length so the post fits. Use a shorter warning or caption to keep the full text.

Video is larger than 40 MB

40 MB is the default video cap for Mastodon. Some instances allow much larger uploads (mastodon.social currently allows up to 99 MB, for example). If your video is over the limit, either compress it before uploading or move to an instance with a higher cap.

Post failed with "Video still processing"

Mastodon transcodes uploaded video asynchronously. ShortSync polls the instance for up to two minutes while it processes. On a very busy instance a large video can take longer, in which case the publish fails and you can retry. Compressing the source video before uploading avoids this.

I run my own instance

Self-hosted instances work exactly the same as public ones. Enter your instance's public URL in the connect modal. ShortSync will register itself as an OAuth application on your instance and then use standard OAuth 2 to authenticate.