This repository has been archived on 2023-05-27. You can view files and clone it, but cannot push or open issues or pull requests.
fedifeed/README.md

1.6 KiB

Mastofeed

Embed a mastodon feed in your blog et cetera.

https://www.mastofeed.com

User guide

The homepage has a tool for generating iframe code for you, with a sensible sandbox attribute. The feeds fit comfortably in a 400px wide area.

API

V1

GET /api/v1/feed

example: /api/feed?userurl=https%3A%2F%2Foctodon.social%2Fusers%2Ffenwick67&scale=90&theme=masto-light

Returns a html page which displays a mastodon feed for a user URL. Note that URLs must be URI encoded (i.e. encodeURIComponent('https://octodon.social/users/fenwick67') ).

Querystring options:

option required description
userurl yes Mastodon/ActivityPub account URL (usually https://${instance}/users/${username})
feedurl no a URL to a page of an ActivityPub post collection. Only used for pages beyond the first.
theme no either masto-dark, masto-light or masto-auto, to select the UI theme (default is masto-dark). auto will appear masto-light unless the user sets up masto-dark mode on their device.
boosts no whether to show boosts or not
replies no whether to show replies or not
size no the scale of the UI in percent.

Server Installation

This is a straightforward node project with zero databases or anything, you should just be able to run npm install and then npm start to get up and running. Set your PORT environment variable to change the port it listens on.

Improve me

Feel free to add a caching layer, improve the styles and add more features.