Ever since Google announced they were shutting Reader down, I’ve been looking for a new RSS reader to replace it. I have since settled on Tiny Tiny RSS, a self-hosted package with a nice, clean interface. It also has a plugin system, which lets me use the Reeder app on my iPhone by having Tiny Tiny RSS emulate the Fever API.
I’m running all of this here on Nearly Free Speech, and I thought I would document the process in case it helps anyone out, including getting Reeder to sync with TT-RSS.
I don’t do truly experimental development on it because it’s a daily driver for me personally and my friends who use the same instance, which is why it should stay functional. Actual versioned releases are not much more than tagged trunk snapshots taken at a given date.
Note, though, that cloning the Git repository results in a
.git folder that is 80 MB+ big. That’s almost 10 times the rest of my site, and since NFSN charges based on disk usage, that wasn’t going to work. So what I did was clone a copy onto my local computer, then use Transmit to upload the installation, using a rule to skip version control files (#3 in that list), including any system files from Git.
Other than that, installation is straightforward. Upgrading consists of updating the Git clone on your local computer, then uploading any changes (Transmit has a Sync feature that does this).
I set everything to be owned by the
web group (
chgrp -R web * in the TT-RSS directory), and made the
lock folders writable by members of the
web group (
chmod -R g+w cache feed-icons lock). This seems to be working fine for me so far.
Setting up the
NFSN recently rolled out scheduled tasks, and I just added the following command…
/usr/local/bin/php /home/public/path/to/tt-rss/update.php --feeds --quiet
…to run every hour (* for every entry) under the
web user. This is as frequent as NFSN allows you to schedule tasks, and it’s easy enough to remember that feeds are updated on the hour.
Using Reeder with TT-RSS
When I used Google Reader, I checked my feeds pretty regularly with Reeder on my iPhone. Unfortunately, the developer behind Reeder has yet to include any support for TT-RSS (or any free solution for that matter). Thankfully, someone made a plugin to emulate the Fever API. Since Reeder supports the Fever API, by proxy Reeder also supports the TT-RSS API.
- Download the plugin from that link.
- Upload the
- Activate it in your preferences.
- Make sure “Allow API access” is checked.
- Set your Fever API password in the Fever preference pane.
- Set up your new Fever account in Reeder, and start syncing.
There are pictures in the link for the plugin if necessary. The bold step is the one I missed, and ran around in circles trying to troubleshoot.
Replacing Google Reader
With this solution in place, I haven’t had to log into Google Reader at all. I was concerned about bandwidth usage and disk usage becoming a problem on NFSN, but my bandwidth hasn’t spiked at all, and the only disk usage spike was when I had the 80 MB
.git folder in my installation. Once I figured out what caused that spike, my disk usage is actually the same as before I installed TT-RSS.