#mastodon #backup #fediverse

app fediback

A mastodon account backup program

2 unstable releases

0.2.0 Dec 5, 2022
0.1.0 Dec 5, 2022

#17 in #mastodon

MIT license

345KB
624 lines

Why fediback

A Mastodon instance can go down, and can die. This happens.

That's why users should always have essential information backuped on their own computer, most essentially their list of following and of followers.

With those lists, they can start a new account if necessary, even if their old one is unreachable, and follow again the same users, and notify people who were following them of their new account.

Install

From source

You must have the Rust environnement installed: https://rustup.rs

Run

cargo install fediback

From precompiled binaries

Executables for Windows and Linux are included in the releases published on GitHub.

Usage

help

You first tell Fediback what account(s) you want to save, with fediback add <user> where user can be a user url or @user@instance:

add

You can add who you want: only public data is fetched.

To backup all selected accounts, run fediback update:

update

Accounts are fetched in parallel.

This operation can be done manually but there's no harm in having a cron rule if you can.

For each account 4 JSON files are saved on disk:

  • user.json with the core account data
  • followers.json with a list of users
  • following.json with a list of users too
  • featured.json with a list of "pinned" messages

tree

user.json

following.json

Licence

MIT - Enjoy

Dependencies

~13–28MB
~439K SLoC