Spring for Twitter URL Scheme

Updated 12272022-021820


URL Schemes

TL;DR

Replace a Twitter URL's "https" prefix with "spring" to open the URL in Spring.

Replace a Mastodon URL's "https" prefix with "mona" to open the URL in Mona.

For example: https://twitter.com/theSpringApp => spring://twitter.com/theSpringApp

Preface

Supported Schemes (URL Prefixes)

spring

Open one of these apps: Spring, Spring mini (version 4.3+), or Spring Beta.

mona

Open one of these apps: Mona, or Mona Beta.

Note

You could also use app ID as scheme instead, if you installed multiple editions of Spring or Mona, and you want to explicitly (not randomly) open one of them.

Common Parameters

account

Perform a task with specific account identified by your Twitter handle (@username), or Mastodon user address. The value of account is case insensitive.

Twitter example: @theSpringApp Mastodon example: @MonaApp@mastodon.social

Open Links in Spring or Mona

Twitter

Supports links to tweets (e.g. https://twitter.com/thespringapp/status/1344625888449556480), user profiles (e.g. https://twitter.com/thespringapp), Twitter Lists (e.g. https://twitter.com/i/lists/1344918930687729664), Direct Message deep links (e.g. https://twitter.com/messages/123456), and Twitter Search (e.g. https://twitter.com/search?q=hello)

Mastodon

User profile: https://[any_domain]/@[username]. https://mastodon.social/@MonaApp

Toot: https://[any_domain]/@[username]/[toot_id_number] https://mastodon.social/@MonaApp/109506252875971252

Basic

Replace the “https” prefix in a Twitter URL with “spring”.

For example, open @theSpringApp’s user page using default account:

spring://twitter.com/theSpringApp

Advanced

Use the “open” URL scheme if you want to open multiple pages at once, or open a page with specific account.

The URL takes 2 parameters: url (required), and account (optional).

You may include multiple url parameters. "url" parameters must be percent encoded.

For example, open user page of @twitter and @jack with a signed in account called @theSpringApp would be something like this:

spring://open?account=theSpringApp&url=https%3A%2F%2Ftwitter.com%2Ftwitter&url=https%3A%2F%2Ftwitter.com%2Fjack

Switch Account

Provide "account" as parameter. Nothing changed if the target account is already activated on the current app window.

Examples:

spring://switch?account=@theSpringApp

mona://switch?account=@MonaApp@mastodon.social

Open Tweet Composer

You can provide 2 optional parameters: text, account

The value of text parameter will be filled into the tweet composer view. If no account provided, Spring/Mona chooses a default account based on the current app window.

Examples:

spring://post?text=hello

mona://post?text=hello&account=@MonaApp@mastodon.social

Open Search View

You can provide 2 optional parameters: text, account

The value of text parameter will be filled into the search bar.

Examples:

spring://search?text=hello

mona://search?text=hello&account=@MonaApp@mastodon.social