README.md

FreshRSS - "Comics in Feed" extension

This FreshRSS extension allows you to directly comics like The awkward yeti, Buttersafe and more comics within your FreshRSS installation.

To use it, upload the freshrss-comicsinfeed directory to the FreshRSS ./extensions directory on your server and enable it on the extension panel in FreshRSS.

I will probably be adding more comics in the future (when/if I start reading them) but feel free to add your own with a pull request.

Requirements

This FreshRSS extension uses the PHP extension DOM and XML.

As those are requirements by FreshRSS itself, you should be good to go.

Installation

To install an extension, download the extension archive first and extract it on your PC (or directly on your host). Then, upload/move the folder you want on your server. Extensions must be in the ./extensions directory of your FreshRSS installation.

Then go to your FreshRSS installation and activate the extension in the extension panel - https://localhost/FreshRSS/p/i/?c=extension - and activate it.

About FreshRSS

FreshRSS is a great self-hosted RSS Reader written in PHP, which is can also be found here at GitHub.

More extensions can be found at FreshRSS/Extensions.

To add more comics

Essentially create a new file for your comic on the folder ./comics/ see the other files there for examples, add it to be loaded on the './comics/load.php' file and add the comic to the list of comics on the ./comics/loader.php file.

Edit the extension.php file to make the match for the feed and the new function to generate the new image source.

Feel free for any pull request or to make a request for a new comic (if I have time I will add it).

Currently supported comics

• The awkward yeti
• Buttersafe
• buni
• Penny-Arcade
• xkcd
• Explosm (RSS feed)
• The Monster under the bed
• Flipside (RSS feed)
• Girl Genius
• Questionable Content
• Sluggy Freelance
• Bouletcorp

Changelog

1.6

4 Nov 2024

Added Bouletcorp by SamZub

1.5

2 May 2024

Added these new comics by Joel Goguen

• Flipside (RSS feed)
• Girl Genius
• Questionable Content
• Sluggy Freelance

1.4

9 April 2024

• Added The Monster under the bed from a user request issue #5

1.3

14 March 2024

• Added Explosm from hidden xml rss feed thanks to wiiaboo

1.2

6 December 2023

• Added xkcd images alt text, thanks to jackson15j
• Penny Arcade Penny-Arcade, thanks to jackson15j

1.1

2 September 2023

• Parses comics images from buni feed to display fully in FreshRSS

1.0

20 August 2023

• Parses comics images from The awkward yeti feed to display fully in FreshRSS
• Parses comics images from Buttersafe feed to display fully in FreshRSS