diff --git a/_snippets/common-links.md b/_snippets/common-links.md index bace449f..beddc5f3 100644 --- a/_snippets/common-links.md +++ b/_snippets/common-links.md @@ -12,6 +12,7 @@ [linx]: /recipes/linx/ [mealie]: /recipes/mealie/ [mylar]: /recipes/autopirate/mylar/ +[miniflux]: /recipes/miniflux/ [nightscout]: /recipes/nightscout/ [nzbget]: /recipes/autopirate/nzbget/ [nzbhydra]: /recipes/autopirate/nzbhydra/ @@ -23,6 +24,7 @@ [portainer]: /recipes/portainer/ [radarr]: /recipes/autopirate/radarr/ [rtorrent]: /recipes/autopirate/rtorrent/ +[rss-bridge]: /recipes/rss-bridge/ [sabnzbd]: /recipes/autopirate/sabnzbd/ [sonarr]: /recipes/autopirate/sonarr/ [tfa-dex-static]: /ha-docker-swarm/traefik-forward-auth/dex-static/ diff --git a/_snippets/recipe-footer.md b/_snippets/recipe-footer.md index d4b1723d..6de27f2c 100644 --- a/_snippets/recipe-footer.md +++ b/_snippets/recipe-footer.md @@ -8,7 +8,7 @@ Did you receive excellent service? Want to make your waiter happy? (_..and suppo ### Flirt with waiter (subscribe) 💌 -Want to know now when this recipe gets updated, or when future recipes are added? Subscribe to the [RSS feed](https://mastodon.social/@geekcookbook_changes.atom), or leave your email address below, and we'll keep you updated. (*double-opt-in, no monkey business, no spam) +Want to know now when this recipe gets updated, or when future recipes are added? Subscribe to the [RSS feed](https://mastodon.social/@geekcookbook_changes.rss), or leave your email address below, and we'll keep you updated. (*double-opt-in, no monkey business, no spam) --8<-- "convertkit-subscribe-form.html" diff --git a/manuscript/CHANGELOG.md b/manuscript/CHANGELOG.md index 7a21bbe7..bc646ecb 100644 --- a/manuscript/CHANGELOG.md +++ b/manuscript/CHANGELOG.md @@ -8,6 +8,7 @@ hide: Recipe | Description | Date -------------------------|------------------------------------------------------------------------------------------------------------------|-------------- +[RSS-Bridge][rss-bridge] | Consume content from non-open platforms (*Facebook, Instagram, etc*) in your feed reader | _1 Oct 2021_ [NightScout][nightscout] | Share your CGM :drop_of_blood: data, setup advanced alarms and charts, for improved diabetes treatment :syringe: and quality-of-life :runner: | _9 Aug 2021_ [Mealie][mealie] | Delicious, API-driven recipe manager, able to scrape-and-import recipes from a URL :cook: | _4 Feb 2021_ [Funkwhale][funkwhale] | Enjoy, share, and federate your music in your own funky "pod". Think "Mastodon for Music" :whale: :musical_note: | _28 Jan 2021_ diff --git a/manuscript/images/rssbridge.png b/manuscript/images/rssbridge.png new file mode 100644 index 00000000..e3172274 Binary files /dev/null and b/manuscript/images/rssbridge.png differ diff --git a/manuscript/recipes/duplicati.md b/manuscript/recipes/duplicati.md index 4eb9eb02..c9effa2c 100644 --- a/manuscript/recipes/duplicati.md +++ b/manuscript/recipes/duplicati.md @@ -123,4 +123,4 @@ Once we authenticate through the traefik-forward-auth provider, we can start con [^1]: Quote attributed to Mila Kunis [^2]: The [Duplicati 2 User's Manual](https://duplicati.readthedocs.io/en/latest/) contains all the information you'll need to configure backup endpoints, restore jobs, scheduling and advanced properties for your backup jobs. ---8<-- "recipe-footer.md" \ No newline at end of file +--8<-- "recipe-footer.md" diff --git a/manuscript/recipes/huginn.md b/manuscript/recipes/huginn.md index 44e4229c..532d9bdb 100644 --- a/manuscript/recipes/huginn.md +++ b/manuscript/recipes/huginn.md @@ -145,4 +145,4 @@ Log into your new instance at https://**YOUR-FQDN**. You'll need to use the "Sig [^1]: I initially considered putting an oauth proxy in front of Huginn, but since the invitation code logic prevents untrusted access, and since using a proxy would break oauth for features such as Twitter integration, I left it out. ---8<-- "recipe-footer.md" \ No newline at end of file +--8<-- "recipe-footer.md" diff --git a/manuscript/recipes/rss-bridge.md b/manuscript/recipes/rss-bridge.md new file mode 100644 index 00000000..5f1558b0 --- /dev/null +++ b/manuscript/recipes/rss-bridge.md @@ -0,0 +1,65 @@ +# RSS Bridge + + +Do you hate having to access multiple sites to view specific content? [RSS-Bridge](https://github.com/RSS-Bridge/rss-bridge) can convert content from a wide variety of websites (*such as Reddit, Facebook, Twitter*) so that it can be viewed in a structured and consistent way, all from one place (Your feed reader) + +![RSS-Bridge Screenshot](../images/rssbridge.png) + +--8<-- "recipe-standard-ingredients.md" + + +## Preparation + +### Setup data locations + +First we create a directory to hold the data which RSS Bridge will serve: + +```bash +mkdir /var/data/config/rssbridge +cd /var/data/config/rssbridge +``` + +### Setup Docker Swarm + +Create a docker swarm config file in docker-compose syntax (v3), something like this: + +--8<-- "premix-cta.md" + +```yaml +version: '3' +services: + rss: + image: rssbridge/rss-bridge:latest + volumes: + - /var/data/config/rssbridge:/config + deploy: + labels: + # traefik common + - traefik.enable=true + - traefik.docker.network=traefik_public + + # traefikv1 + - traefik.frontend.rule=Host:rssbridge.example.com + - traefik.port=80 + + # traefikv2 + - "traefik.http.routers.rssbridge.rule=Host(`rssbridge.example.com`)" + - "traefik.http.services.rssbridge.loadbalancer.server.port=80" + networks: + - traefik_public + +networks: + traefik_public: + external: true +``` + +## Serving + +### Deploy the bridge! + +Launch the RSS Bridge stack by running ```docker stack deploy rssbridge -c ``` + +[^1]: The inclusion of RSS Bridge was due to the efforts of @bencey in [Discord](http://chat.funkypenguin.co.nz) (Thanks Ben!) +[^2]: This delicious recipe is well-paired with an RSS reader such as [Miniflux][miniflux] + +--8<-- "recipe-footer.md" diff --git a/mkdocs.yml b/mkdocs.yml index 7943ecf0..4bd10c42 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -119,7 +119,8 @@ nav: - Photoprism: recipes/photoprism.md - Portainer: recipes/portainer.md - Realms: recipes/realms.md - - Restic: recipes/restic.md + - Restic: recipes/restic.md + - RSS Bridge: recipes/rss-bridge.md - Tiny Tiny RSS: recipes/tiny-tiny-rss.md - Traefik: ha-docker-swarm/traefik.md - Traefik Forward Auth: diff --git a/runtime.txt b/runtime.txt index d70c8f8d..cc1923a4 100644 --- a/runtime.txt +++ b/runtime.txt @@ -1 +1 @@ -3.6 +3.8