gsantner / ttrss-reader-mobile-html5-webapp

Lightweight html5 RSS feed reader for TinyTinyRSS using it's API

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:

• jQuery Mobile
• Backbone.js
• RequireJS

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

The tt-rss project is licensed under the GPLv3 LICENSE, source is the original tt-rss project.