summaryrefslogtreecommitdiff
path: root/README
blob: a040066a9323cf1bd1d4ec23466f1eec36073f2d (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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
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.

	http://tt-rss.spb.ru

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)
	Sean M. Burke. <[email protected]> (xsl_mop-up.js)

Other bundled libraries:

	Prototype javascript library, from http://prototype.conio.net/
	Script.aculo.us javascript library, http://http://script.aculo.us/
	MagpieRSS feed parser, http://magpierss.sourceforge.net/
	SimplePie feed parser, http://simplepie.org/
	PHPMailer class, http://phpmailer.sourceforge.net/

Licensed under GNU GPL version 2

Features Overview
=================

	Updates: http://tt-rss.spb.ru/trac/wiki/FeatureList

	* Server-side application, user only needs a web browser
	* Supports RSS, RDF, Atom feeds using Magpie or SimplePie library
	* Supports OPML import/export
	* Easy setup and configuration
	* Streamlined interface using XmlHttpRequest (or AJAX for laypeople)

Requirements
============

	* Compatible browser on the client side

		Basically, Firefox, Konqueror or MSIE6 are okay. See here
		for more information:

		http://tt-rss.spb.ru/trac/wiki/CompatibleBrowsers

	* Web server, for example Apache
	* PHP (requires PHP4 DOMXML extension)
	* PostgreSQL (tested on 7.4) or MySQL (InnoDB and version 4.1+ required)

	* XML-RPC for PHP library for XML-RPC support. Optional.
	
		http://phpxmlrpc.sourceforge.net
		
Installation Notes
==================

	Updates: http://tt-rss.spb.ru/trac/wiki/InstallationNotes

	* If you are upgrading from the previous version, don't forget to update 
	schema and logout.

	* icons directory should be writable to your httpd user if you plan on 
	using feed icons

	* Leave DB_HOST empty if you want to connect to database via unix socket

	* For PostgreSQL don't forget to create database with UTF-8 encoding 

			createdb -E utf-8 -O owner_user database)

	* Don't forget to change your password from default value on your first login

	* Check your config.php for blank lines out of PHP code tags (e.g. 
	before <? and after ?>), See #1 

	* Default username:password for multiuser mode is admin:password.

See also
========

	* FAQ:				http://tt-rss.spb.ru/trac/wiki/FrequentlyAskedQuestions
	* Forum:				http://tt-rss.spb.ru/forum
	* Wiki:				http://tt-rss.spb.ru/trac/wiki/WikiStart
	* Bug Tracker:		http://tt-rss.spb.ru/trac/report

Contact
=======

Send your questions, comments, patches to Andrew Dolgov <[email protected]>