summaryrefslogtreecommitdiff
path: root/README
blob: 5aa84c53b5463edc96b93f40df174efe163a4c83 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
Tiny Tiny RSS
=============

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 <[email protected]> (pngfix.js)
	Sundar Dorai-Raj <[email protected]> (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;

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).

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 <[email protected]>