Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A PHP and Ajax feed reader
JavaScript PHP

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
help
images
schema
NEWS
README
UPGRADING
backend.php
config.php-dist
config_help.txt
db-prefs.php
db.php
error.php
feedlist.js
functions.js
functions.php
login.php
logout.php
opml.css
opml.php
pngfix.js
prefs.js
prefs.php
sanity_check.php
tt-rss.css
tt-rss.js
tt-rss.php
tt-rss_compact.css
update_feeds.php
version.php
viewfeed.js
xml-export.php
xml-import.php

README

Tiny Tiny RSS
=============

! Please read UPGRADING for upgrade instructions from version 1.0.7 !

Web-based news feed aggregator, designed to allow you to read news from 
any location, while feeling as close to a real desktop application as possible.

Copyright (C) 2005 Andrew Dolgov unless stated otherwise.

Portions (C):

	Bob Osola <bobosola@gmail.com> (pngfix.js)
	Sundar Dorai-Raj <sdoraira@vt.edu> (isNumeric() in functions.js)

Licensed under GPL version 2.

Warning: I don't know how to stress it enough - please do not install
this program wide open to the whole internet. It belongs to (host or password)
protected directory on your webserver. There could be SQL-injection or other
remote vulnerabilities, so beware.

Version 1.1 adds support for multi-user operation, disable option SINGLE_USER_MODE 
to access it. Default user is "admin" with password "password", don't forget to 
change it.

Interface:

	There is (incomplete) support for keyboard navigation.
	
	"n" and "p" moves between next/previous posts when feed is opened;
	"r" refreshes feed list;
	"u" refreshes currently selected feed;
	"a" hides or shows only unread feeds in the feedlist;
	"j" move to previous feed
	"k" move to next feed
	"s" star/unstar selected article(s)

Requirements:
	
	- Magpie RSS (http://magpierss.sourceforge.net/) - place it into
	  magpierss/ subdirectory;
	  
	- RDBMS backend:
	
			a) PostgreSQL
			b) MySQL (InnoDB and server version 4.1+ required)

	  Example DB schemas and configuration are in schema/ subdirectory.
	  
	  For PostgreSQL don't forget to create database with UTF-8 encoding
	  (createdb -E UTF-8 -O owner_user database).

	- PHP4 DOMXML extension is required for some functions

Don't forget to copy config.php-dist to config.php and edit it.

icons/ directory should be writable for your httpd user.

Send your questions, comments, patches to Andrew Dolgov <cthulhoo@gmail.com>
Something went wrong with that request. Please try again.