💾 Archived View for gmn.clttr.info › sources › orrg.git › tree › README.md.txt captured on 2024-07-09 at 01:26:25.

View Raw

More Information

⬅️ Previous capture (2023-01-29)

-=-=-=-=-=-=-

# orrg (online rss feed reader for gemini) 

public instance: [gemini://orrg.clttr.info]


	
orrg* is a cgi script for [gemini](gemini://gemini.circumlunar.space) servers.

It delivers an easy way to consume atom or rss feeds shipped over gemini or https.

Lists of popular and recently visited feeds as well as viewing a random feed help you discover new things.

## features

- load an atom/rss feed from gemini or https (http is deliberately not supported!) given by user input
- render feed (channel info & entrys) as a gemini site
	- include links to originating site and every article
	- strip html tags from item description
- lists of popular and recently visited feeds
- random feed selector

## non-features


	
orrg* will never be a full-fletched feed aggregator with archiving and searching capabilities.


Given this restrictions is not suitable for high traffic feeds which are updated very often. But it should work quite well for slow paced feeds of blogs and so on.

# installation

- setup your geminiserver with cgi enabled
- `git clone` the repo to the directory
- open the capsule in a gemini client

## requirements

- gemini server with cgi enabled (like gmnisrv or stargazer)
- Perl >= 5.28 with modules
	- URI::Escape
	- XML::FeedPP
	- DateTime
	- DateTime::Format::ISO8601
	- HTML::Strip
- gmni (from https://git.sr.ht/~sircmpwn/gmni or https://src.clttr.info/rwa/cgmnlm)
- wget