A web-based RSS/ATOM aggregator
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
php
src
templates
tests
.gitignore
.travis.yml
Dockerfile
Makefile
README.md
composer.json
composer.lock
config.ini.docker
config.ini.sample
deplist.txt
manage.php
public
setup.php
supervisord.conf

README.md

Bliss

Build Status

Because reading my private, mostly NSFW RSS Feeds makes me a happy puppy.

fka rssReader. see link for my first release.

DESCRIPTION:

Bliss is a simple application which can be used to gather a set of RSS/RDF feeds, and compile them into one single Page ordered by Date.

I build it because i liked PlanetGnome (http://www.gnome.org/~jdub/planetgnome/) alot, but didn't like the Python Spycyroll (http://spycyroll.sourceforge.net/).

Recently it got a slight update (as in complete rewrite) to something a bit more up-to-date.

BUT WHY?

  • I have feeds that i don't want Google Reader to know about. (The NSFW, and authenticated kind)
  • tt-rss needs MySQL, i'd like to get rid of that dependency for my VPS
  • I don't want a Desktop Reader.
  • And, as always: Because i can, that's why!

REQUIREMENTS:

INSTALLATION:

  • Untar the archive into your webservers directory.
  • Use composer to install all vendor packages
  • Open the config.ini.sample in your favorite editor and follow the instructions in that file. Save as config.ini
  • Then run manage.php --update from the commandline
  • After you've run the update you can open the page in your browser.

Running on Docker

Create the Container by runnint docker build -t bliss .

Then create the Directories data/cache and data/feeds` somewhere, and chown them to uid 48.

Run the container with `docker run -v :/data -p :80 -d bliss

ADDING FEEDS:

There is 3 ways to do add feeds to Bliss:

  • Add them to config.ini
  • Create an OPML File, and add that to config.ini
  • Add them via the Options Menu pulldown

Bliss uses SimplePie for feed retrieval. SimplePie has Feed autodetection, so you shouldn't have to worry about adding the RSS Feed as URL. Usually just adding a Page that has a Feed is sufficient.

KEYBOARD NAVIGATION:

These Keyboard Commands exist currently:

  • r to Reload all Articles

TODO:

  • A Way to mark items read/unread and a "mark all read" maybe?
  • Expire of the simplepie cache
  • Sortable Image Gallery
  • Search? (this is probably where i will regret most that i chose not to use a database)
  • Keyboard Navigation needs completion
  • More Unit Tests

BUGS

  • It will likely not look good in Internet Explorer or Opera.

Probably alot more. Tested with a couple of feeds, but there are probably alot that don't work correct.

LICENSE:

Released under the MIT License