Stringer
A self-hosted, anti-social RSS reader.
Stringer has no external dependencies, no social recommendations/sharing, and no fancy machine learning algorithms.
But it does have keyboard shortcuts and was made with love!
Niceties
Keyboard Shortcuts
You can access the keyboard shortcuts when using the app by hitting ?
.
Using your own domain with Heroku
You can run Stringer at http://reader.yourdomain.com
using a CNAME.
If you are on Heroku:
heroku domains:add reader.yourdomain.com
Go to your registrar and add a CNAME:
Record: CNAME
Name: reader
Target: your-heroku-instance.herokuapp.com
Wait a few minutes for changes to propagate.
Translations
Stringer has been translated to several other languages. Your language can be set with the LOCALE
environment variable.
To set your locale on Heroku, run heroku config:set LOCALE=en
.
If you would like to translate Stringer to your preferred language, please use LocaleApp.
Clean up old read stories on Heroku
You can clean up old stories by running: rake cleanup_old_stories
By default, this removes read stories that are more than 30 days old (that are not starred). You can either run this manually or add it as a scheduled task.
Development
Run the Ruby tests with rspec
.
Run the Javascript tests with rake test_js
and then open a browser to http://localhost:4567/test
.
Getting Started
To get started using Stringer for development you first need to install foreman
.
gem install foreman
Then run the following commands.
bundle install
rails db:setup
foreman start
The application will be running on port 5000
.
You can launch an interactive console (a la rails c
) using rake console
.
Maintainers
Robert Fletcher boon.gl
Alumni
Matt Swanson (creator), mdswanson.com, @_swanson Victor Koronen, victor.koronen.se, @victorkoronen