Local (as in "runs on your computer") backup tool for Freefeed. Will download all posts written by you (including direct messages and posts to groups) with attachments, and generate a simple HTML document to view them.
Prerequisites: NodeJS.
- Download this repository as a zip file and unzip it into a folder (or clone the repo).
- Generate an application token here. Put your username and app token into
credentials.json. - Open your terminal console, navigate to the folder where you put this repository, and type
npm run start. Wait for it to complete. - Your backup will be in
datasubfolder.
Downloading all of your data and attachments might take quite a bit of time, depending on the size of your feed and your geographical location (Europe is fastest). The script is tolerant to interruptions, and will continue if restarted. You can backup as many users as you want from as many servers as you want, and the backups will be kept in separate folders.
To refresh your backup delete all .json files from your backup data folder and re-run npm run start. You can keep the attachments and profilepics folders to avoid re-downloading them. It is unlikely that "incremental backups" will ever be implemented, because unless we re-download all of your posts, we won't know 1. if any of them were deleted (by you), and 2. if any of them were referenced (by other people).
The tool doesn't have complete feature parity with the official client when it comes to rendering of posts and comments. For example, #hashtags, @username mentions, and comment ^^ arrows are displayed as plain text, there are no user popups, and there is no "lightbox" for attachments. This is intentional and is unlikely to be fixed.
This tool is configured to work with https://freefeed.net by default. To run the script against other Freefeed instances (e.g. candy or your local dev server) update server configuration in config.json. Note that you will need an app token with the following access rights: Read my public profile, Read my user information, and Read feeds, including my feeds and direct messages, issued by that server.
Please raise a Github issue for bugs or feature requests. You're welcome to write me a direct message or buy me a coffee.