ttrss-mobile

A mobile webapp for Tiny Tiny RSS

What is it?

This webapp is a client for Tiny Tiny RSS. It uses its JSON API.

I started working on this because the default mobile version was somtimes slow, limited and not in good shape for future development.

ttrss-mobile is using:

How to install?

Download the latest release available here.
Unpack the archive somewhere on your server.
Alternatively, you can clone the repository where you want it on your web server.
In the scripts dir, copy conf.js-dist to conf.js and set the variable window.apiPath pointing to your Tiny Tiny RSS installation.

Updates

Download the update
Unpack it over your previous installation
Compare the new conf.js-dist with yours and merge them
It should be ready
(Don't forget to clear your cache if you see something strange)

How to hack on it?

You need node.js to make a build but you can still hack without it.

Clone this repo on your webserver
Hack on the files in src
Test on the version in src
Build with make/make.sh
Test with the built version in build
Make a pull request with your awesome contribution

Caveats

You should not put this webapp in a subdir of your Tiny Tiny RSS install. On update, it could be wiped. For more info, see this post from HunterZ on the forum.
Make sure that the user you'll use to connect has the API activated in Tiny Tiny RSS preferences :
- in Tiny Tiny RSS go into Actions -> Preferences
- Configuration -> Enable external API
If you want to host this webapp on another hostname than your Tiny Tiny RSS instance, you'll find a solution using CORS in this issue.

Current features

mark all as read/unread
categories support
feeds icon display
image & objects adapted to the screen size (max-width: 100% in CSS)
link to the original article
unread count display
special feeds
publish/unpublish article support
star/unstar article support
mark as read/unread article support
iPhone webapp support (startup image & icon)
SINGLE_USER_MODE support
settings page: only number of articles to load as of now

Other features to come are tracked as issues. Feel free to give a hand or request things :-)

License

ttrss-mobile is Free Software under the AGPLv3