mastodon-redirector - GitLite

KO | EN

gitlite — search

#gemini #developer-tools #ai-agents #nextjs #css #framework #nlp #dotnet #ai #tailwindcss

mastodon-redirector

(★ 106)

View Mastodon profiles on your Mastodon instance

File Explorer

ZIP Download

- bookmarklet.svg
- chrome-webstore.svg
- firefox-addons.svg
- README.md
- - icon-128.png
  - icon-16.png
  - icon-32.png
  - icon-64.png
- - options.css
  - options.html
  - options.js
- background.js
- content.js
- manifest--base.json
.gitignore
.prettierrc
LICENSE
Makefile
README.md
web-ext-config.js

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

`watch`

View Details ▼

Execute a program periodically and monitor the output in full-screen mode.

watch {{command}}

Repeatedly run a command and show the result:

watch {{[-n|--interval]}} 60 {{command}}

Re-run a command every 60 seconds:

watch {{[-d|--differences]}} df

Monitor disk space, highlighting differences as they appear:

🔍

`web-ext`

View Details ▼

Manage web extension development.

web-ext run

Run the web extension in the current directory in Firefox:

web-ext run --source-dir {{path/to/directory}}

Run a web extension from a specific directory in Firefox:

web-ext run --verbose

Display verbose execution output:

# Project Badges

Available on the Chrome Web Store Visit
Available on the Firefox Add-ons Website Visit
Available as Bookmarklets Visit

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

|-|-|-|

One thing that’s a bit of a hassle with Mastodon is that you can’t immediately follow people on other instances: you have to copy the username and search for it on the instance that hosts your account. Same story with favoriting and boosting their posts, when viewed on their instance’s URL.

To make this easier, this extension exists.

## Demo

https://github.com/bramus/mastodon-redirector/assets/213073/b0554662-a7c2-4261-aae0-957f38f47ffb

_This demo shows Chrome with the extension running. My Mastodon host is `front-end.social`. After configuring the extension, I can quickly jump from other Mastodon instances to my own instance where I can follow/favorite/boost._

## Installation

### Quick Links

Use one of the buttons below to be taken to the extension stores

| [![Available on the Chrome Web Store](https://raw.githubusercontent.com/bramus/mastodon-redirector/main/assets/chrome-webstore.svg)](https://chrome.google.com/webstore/detail/mastodon-redirector/limifnkopacddgpihodacjeckfkpbfoe) | [![Available on the Firefox Add-ons Website](https://raw.githubusercontent.com/bramus/mastodon-redirector/main/assets/firefox-addons.svg)](https://addons.mozilla.org/en-US/firefox/addon/mastodon-profile-redirect/) | [![Available as Bookmarklets](https://raw.githubusercontent.com/bramus/mastodon-redirector/main/assets/bookmarklet.svg)](#other-browsers) |
|-|-|-|

### Chromium-based browsers

_This applies to browsers that are based on Chromium. This includes Google Chrome, Microsoft Edge, …_

The easiest way is to install it from [the Chrome Web Store](https://chrome.google.com/webstore/detail/mastodon-view-profile-on-my-mastodon-instance/limifnkopacddgpihodacjeckfkpbfoe)

Alternatively you can clone this repository and [load the extension unpacked](https://developer.chrome.com/docs/extensions/mv3/getstarted/development-basics/#load-unpacked). Before you can do this, you will need to [build the project](#development) though.

Don’t forget to [configure the extension](#configuration).

### Firefox

You can install the extension from [the Firefox Add-Ons Website](https://addons.mozilla.org/en-US/firefox/addon/mastodon-profile-redirect/). Because this extension uses Manifest v3, support is limited to Firefox 109 and up.

To run the extension in older versions of Firefox:

- Go to `about:config` and set `extensions.manifestV3.enabled` to `true`
- Hit the “download file” link on the [Add-Ons listing](https://addons.mozilla.org/en-US/firefox/addon/mastodon-profile-redirect/), upon which Firefox will prompt you to install it

Don’t forget to [configure the extension](#configuration).

### Other Browsers

If you can’t or won’t run the extension, you can use [the bookmarklets](./bookmarklet/) which also do the job.

## Configuration

- Chrome:
    - Right click the extension icon and choose “Options”
    - Enter the details and hit “Save Settings”
- Firefox:
    - Right click the extension icon and choose “Manage Extension”
    - Click the three dot menu next to the extension name and click “preferences”
    - Enter the details and hit “Save Settings”

TIP: To get easy access, pin the extension icon

## Usage

When viewing a Mastodon page on a different instance than yours, hit the extension icon to get redirected to the profile/post on your instance. You can also use the `Alt`+`Shift`+`M` / `Option`+`Shift`+`M` shortcut to invoke the redirect.

Furthermore, this extension modifies the modals Mastodon shows on other instances. When wanting to follow/favorite/boost, a button with a direct link to your Mastodon instance will be injected into the markup.

## Development

### Building

Due to minor differences in support for extensions that use Manifest v3 in Chromium and Firefox, the code of this repository cannot directly be loaded. The code needs to be built.

```bash
make build-all
```

The built, yet still unpacked, extensions can be found in `./build/firefox` and `./build/chromium`.

Building depends on [`jq`](https://stedolan.github.io/jq/) which you must install first.

While actively developing, make use of the `watch` task. It will auto-rebuild whenever you save something in `src/`.

```bash
make watch
```

### Loading

For Chromium based browsers, [load the extension unpacked](https://developer.chrome.com/docs/extensions/mv3/getstarted/development-basics/#load-unpacked) from the `./build/chromium` folder. Alternatively you can use the `run-chrome` Make script:

```bash
make run-chrome
```

For Firefox, you’ll need [`web-ext`](https://extensionworkshop.com/documentation/develop/getting-started-with-web-ext/) to load the extension during development. A `web-ext-config.js` is included in the repository, so you can easily run `web-ext run`. Alternatively you can use the `run-firefox` Make script:

```bash
make run-firefox
```

## Support and bugs

This project is offered as is. However, I am open to receiving bug reports and accepting PRs to improve this extension.

## License

This project is released under the MIT public license. See the enclosed `LICENSE` for details.

## Acknowledgements

Icon by [Flatart](https://www.iconfinder.com/icons/4373112/logo_logos_mastodon_icon)