catstodon/README.md

Catstodon

Introduction

This Mastodon fork is based on the glitch-soc Fork of Mastodon, historically with changes made to suit CatCatNya~. Some changes may be contributed back to glitch-soc. Non-security contributions to Vanilla Mastodon have ceased for Fediverse-political reasons.

To install, take a look at glitch-soc.github.io/docs/. The instructions and features are the same, except for the differences outlined below.

Contributing guidelines are available here.

Note: Use the main branch only for forks. The develop branch is experimental, has no stable state, and is only used for testing changes on the staging instance. For production, it is suggested you run:

• any of the stable/* branches or stable tags
  • do note, however, that these branches/tags have a similar support cycle to upstream, and therefore also to vanilla Mastodon!
• the main branch, which is comparable to "nightly" versions in vanilla Mastodon.

Differences

• Some files are adjusted specifically for the CatCatNya~ instance, and you may want revert/change them. Specifically, these:
  • sounds/boop.mp3
  • sounds/boop.ogg
• The rate limits for authenticated users have been relaxed a bit. Vanilla Mastodon, and by extension glitch-soc, sadly has rate-limits that make it possible to run into these rate-limits during normal usage.
• The API endpoint /api/v1/custom_emojis is no longer affected by AUTHORIZED_FETCH, allowing anyone to copy custom emojis.
• Allow higher resolution images. (4096x4096 instead of the previous limit of 3840x2160)
• Allow posting polls with only one poll option (if MIN_POLL_OPTIONS is set to 1 on your instance).
• Emoji reactions on statuses (with both Unicode and custom emojis, same as for announcements), a feature originally developed for Nyastodon. Ended up as a Catstodon-maintained patch after its initial two Pull Requests to glitch-soc, but was handed over to Essem's fork, Chuckya and is now pending its fourth attempt of merging into glitch-soc.
• Lifts the "only federate local favourites" restriction on favourites/likes and emoji reactions.
• Cherry-picks the activity filter branch from Sakurajima Mastodon.
• Adds the ability to disable the suspicious sign in detection entirely.
  • Useful for situations where the instance may not have up-to-date IP information, such as when the period of IP address retention is set to a low value (see Previous differences now merged into vanilla Mastodon)
• Environment variable MASTODON_USE_LIBVIPS is true by default.
  • This is a minor change, but it requires all systems running Catstodon to run a recent libvips version (8.13+).
  • Vanilla Mastodon intends to deprecate ImageMagick anyway, so sooner or later, this change will cease being one.
• Allow dashes in emoji shortcodes
  • This is simply to allow custom emoji compat with other fedi software.
  • Original patch by hazycora: 2dde7a25a4

Contributions to glitch-soc Mastodon

• Fixed incorrect upload size limit display when adding new a new custom emoji. (Pull request)
• Everything merged into vanilla Mastodon

Contributions to Vanilla Mastodon

• The period of retention of IP addresses and sessions was made configurable. (Pull request)