Skip to content
clean-greader is a tiny tiny rss theme based on the latest Google Reader and inspired by other Google Services.
CSS JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


clean-greader is a tiny tiny rss (1.8+) theme based on the latest Google Reader and inspired by other Google Services.
As of 2017/02/14 the theme does not contain tt-rss version information. Please see the FAQ to properly add the version of tt-rss
As of 2013/08/29 the theme is build from scratch to be independent from changes to the tt-rss default.css.



Using Git

$ # Assuming, that your tt-rss instance is located at /usr/share/tt-rss
$ cd /usr/share/tt-rss/themes
$ git clone
$ cp clean-greader/wrapper.css clean-greader.css


  1. Download the package using the "Download ZIP" button on the right
  2. Copy the clean-greader-master folder into you tt-rss/themes folder (e. g. /usr/share/tt-rss/themes) and rename it to clean-greader
  3. In /usr/share/tt-rss/themes run
$ cp clean-greader/wrapper.css clean-greader.css


Using git

$ # Assuming, that your tt-rss instance is located at /usr/share/tt-rss:
$ cd /usr/share/tt-rss/themes/clean-greader
$ git pull


Same as Installation - just overwrite the files.

Custom settings

There is a sample file called _config.scss.sample in the themes css/ folder. Before running gulp.js tasks, make sure to create this file, since you'll get an error otherwise.

$ cd /usr/share/tt-rss/themes/clean-greader/css
$ # Either work with a copy...
$ cp _config.scss{.sample,}
$ # ... or link it, if you're fine with the default settings.
$ ln -s _config.scss{.sample,}

Thumbnail for main feed image ( $small-main-feed-image )

  • type: boolean
  • default: true

Display the first image as a thumbnail to save some space. If you're using image feeds, this might not be what you want.

Use fullscreen ( $use-fullscreen )

  • type: boolean
  • default: false

This enables the theme to use the full page width instead of a limited container width. Initially, the clean-greader theme was supposed to be used in combined mode and therefore was always fixed to a specific container max-width. In 16.3.0, support for non-combined mode, and therefore also widescreen mode, was added - which might need a bit more space then the regular container's max-width.

Rebuild the main.css file

After making changes to the settings file (or basically any .scss file), you need to rebuild the css file.

$ cd /usr/share/tt-rss/themes/clean-greader
$ # Install / update the dev dependencies
$ npm install
$ # Rebuild the .css file
$ gulp styles


As of the "build from scratch" update, the theme is completely written using SASS/SCSS. A tutorial on Devloping With Sass and Chrome DevTools can be found on

Working with sass and gulp.js

$ cd /usr/share/tt-rss/themes/clean-greader
$ # Install / update the dev dependencies
$ npm install
$ # Run gulp as background task ...
$ gulp watch
$ # ... or let it build the .css file once
$ gulp styles


To prepare the .css file for a pull request, please use the build task. This will replace your custom configuration with the default configuration, build the .css file and put your configuration back in place.

$ gulp build


The clean-greader theme is build on Google Chrome (33) using Arch Linux and tested on Google Chrome (33) as well as Mozilla Firefox (23). These are the only official support browsers, so there will be no guarantee for the usability on other browsers except of those.


Theme's not displayed in the Settings

As of tiny tiny rss 1.15.3, themes require to provide a version they support. Sadly, tiny tiny rss supports only providing a single specific version number. If this number provided by the theme does not match your tiny tiny rss version, the theme won't be available.
The version, however, can be changed in the clean-greader.css file created in the /usr/share/tt-rss/themes/ directory. This file should have the format

/* supports-version:17.1 */

@import "clean-greader/clean-greader.css";

To support a newer version of tt-rss, simply change the version number in the top line.

Tiny Tiny RSS Settings

Setting Value
Combined feed display enabled
Automatically expand articles in combined mode disabled
Show content preview in headlines list disabled


Main Page

Main Settings

Feed Settings

Main Page (disabled combined mode, enabled widescreen mode, set $use-fullscreen: true)

You can’t perform that action at this time.