A tool to automate applications for Mastodon servers
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Syfaro 474358c6af Update README with usage. 1 year ago
demo Screenshot of sent email in README. 1 year ago
primigenius Fix initial account not getting automatically approved. 1 year ago
.gitignore Initial commit. 1 year ago
Pipfile Initial commit. 1 year ago
Pipfile.lock Initial commit. 1 year ago
README.md Update README with usage. 1 year ago
requirements.txt Initial commit. 1 year ago



A tool to automate applications for Mastodon servers.

What the user sees on the homepage. Extra and links fields can be turned off through the config file.

Administrative dashboard, shows the applications and a little bit of information about extra fields (if enabled).

A single application entry with buttons to approve or deny them.

An email sent to the user after approval.


  • Download and go to directory primigenius
  • Copy config.sample.yaml to config.yaml and replace values as needed
  • Install Python dependencies with pipenv install or pip install -r requirements.txt
  • Run with waitress-serve --call primigenius:create_app (or other preferred server)
  • Make available to the internet with nginx or similar


After starting, clicking the admin link in the footer brings you to the Mastodon OAuth signin page. Once approved, it redirects to the app.

The first account is automatically approved to manage applications and other users. Users who sign in afterwards must be approved by a previously approved user.

After a user application is received, it appears on the admin homepage. The homepage only shows a subset of the information from the application, and varies based on what fields were enabled. If extra is enabled, the first five words are shown. If links are enabled, the number of links provided is shown.

Clicking the user's provided name opens a page that reveals all of the information provided in the application. Clicking the email should open an email client to send them an email.

Approving a user will send an invite link to the email address provided when they applied. Denying them currently will not notify the user.

Applications each require a unique email address. Even after an application is accepted or denied, the email address is saved to prevent spam.