Instance-agnostic share page for the Fediverse.

Share₂Fedi (pronounced ‘share-to-fedi’) lets you share stuff on Mastodon, Misskey, Friendica, and other federated social networks, instance-agnostic. Just type in the post text and the instance URL, and click ‘Post’!

Or, add text query parameter to the UR, and it will be automatically inserted into the text field. The same goes for the instance and lang URL parameters. This can be used to build custom share buttons for the federated social networks:

<a href="https://s2f.kytta.dev/?text=Hello%20world!&instance=mastodon.xyz">
  Share on mastodon.xyz
</a>

The instance URL can be saved (this uses Local Storage) for later use.

Share₂Fedi has an official container image that you can use with any OCI runner. For example, using Podman:

podman run --detach --publish 127.0.0.1:9999:3000/tcp ghcr.io/kytta/share2fedi:v4.0.0-alpha.8

You can pull the image from:

• Docker Hub: kytta/share2fedi
• GHCR: ghcr.io/kytta/share2fedi
• Quay: quay.io/kytta/share2fedi

The app runs on port 3000, which the container automatically exposes. In above code, port 9999 is used on host machine.

Same configuration as a Compose file:

services:
  share2fedi:
    image: ghcr.io/kytta/share2fedi:v4.0.0-alpha.8
    ports:
      - "127.0.0.1:9999:3000/tcp"

The app does not do any TLS termination, so you must run it behind a reverse proxy to get HTTPS. We won't go into detail here; you probably know what you're doing.

Apart from versioned tags, there is also the edge tag, which is built from the latest commit on the main branch. It is not recommended to use it, as it might contain bugs.

You can also host Share₂Fedi without Docker, but this requires some extra setup.

Prerequisites: Node.js v24, pnpm.

0. Clone the repository on the target machine, or download it as a tarball.

1. Install dependencies.

   pnpm install

2. Build.

   pnpm build

3. Run server.

   By default, this will only listen on localhost:3000. To enable listening on a certain host and/or port, set the HOST and PORT environment variables, respectively.

   node dist/server/entry.mjs

   In production, you might want to use a process manager, like PM2:

   # Start the app, restart on file changes (except node_modules)
   pm2 start dist/server/entry.mjs --name "Share2Fedi" --watch --ignore-watch="node_modules"

   More information about self-hosting an Astro website with Node: https://docs.astro.build/en/guides/integrations-guide/node/#standalone

TL;DR: pnpm install && pnpm dev

See contributing guide for instructions on how to contribute source code to the project, including adding new Fediverse projects.

Share₂Fedi uses Hosted Weblate for translations. You can edit translations using its UI.. You also could do it manually by editing files in src/i18n/translations, but this is NOT recommended.

We thank Weblate for providing Libre hosting!

📯 Shareon (lightweight, stylish, and ethical share buttons) uses Share₂Fedi under the hood!

© 2020 Nikita Karamov
Licensed under the GNU Affero General Public License v3.0 only.

This project is hosted on GitHub: https://github.com/kytta/share2fedi.git