1
0
mirror of https://github.com/fenwick67/mastofeed synced 2024-12-23 07:38:10 +01:00
mastofeed-iframe-embed/README.md
2017-04-30 13:26:13 -05:00

1.0 KiB

Mastofeed

Embed a mastodon feed in your blog et cetera.

Preview (note: domain name incoming): https://mastofeed.herokuapp.com/

Usage 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

GET /api/feed?url=${url}

example: /api/feed/url=https%3A%2F%2Foctodon.social%2Fusers%2Ffenwick67.atom

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

Mastodon Atom feed URLs follow this convention:

https://${instance}/users/${username}.atom

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 chaching layer, improve the styles and add more features.