Skip to content
🚧 Mobile HTML/JS client for Tiny Tiny RSS (working prototype) 🚧
HTML
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
README.md
apple-touch-icon.png
icon.svg
icon512.png
index.html
manifest.json
upup.min.js
upup.sw.min.js

README.md

Tiny Tiny Reeder

Tiny Tiny RSS client in HTML/JS.

It is not meant as full featured replacement of Tiny Tiny RSS. Instead it is intended as clean and simple client for quick and light reading on the go.

It works best in Chrome (or as PWA); while it may not work in browsers such as Safari (as this client uses features such as pointer events, scroll snap etc.).

I'm not sure if this client will ever mature into anything bigger, more feature full and configurable but it works more than fine already for me. I use it everyday as my only RSS reader. (But I have only up to 50 articles a day.)
(I use this project to broaden my knowledge about HTML/CSS/JS as last time I learn about HTML was 15 years ago.)

Behavior / limitations:

  • List only shows up to 200 unread articles
  • There is no list of feeds (yet; TODO)
  • Opening article doesn't make it read on server! This is intended behavior. Swipe it away (or press X) to mark it read and remove from list.
  • Works offline (no automatic image caching or support for managing read states; automatic background sync in service worker - investigate)

Installation

Edit URL, USERNAME and PASSWORD in index.html. Copy all the files (ideally) on the same host as Tiny Tiny RSS (to avoid configuring cross domain requests). I use path /tt-rss/m/.

Screenshots

List & detail in portrait

Landscape

List & detail in portrait (dark)

Landscape (dark)

Desktop

Controls

  • Tap article in the list to open view article content.
  • Swipe article in the list: Green - go to url of the article; Red - mark article as read and remove from the list.

Keyboard shortcuts

  • J/K: Next/previous article
  • V: Go to article URL
  • X: Mark article as read and remove from list
  • R: Reload list/page
You can’t perform that action at this time.