mirror of https://github.com/pawelorzech/tt-rss.git synced 2026-06-04 17:44:26 +00:00

A free, flexible, open-source, web-based news feed (RSS/Atom/other) reader and aggregator.

PHP 46.3%
JavaScript 21.9%
CSS 17.4%
Less 9.2%
PLpgSQL 2.6%
Other 2.6%

Find a file

supahgreg d770f209cb Add a 'JavaScript Code Quality' GitHub workflow.		2025-10-12 15:30:47 +00:00
.docker	Remove assorted unused stuff.	2025-10-11 21:17:31 +00:00
.github	Add a 'JavaScript Code Quality' GitHub workflow.	2025-10-12 15:30:47 +00:00
api	Use the official JSON MIME type of 'application/json'.	2025-06-03 13:53:12 +00:00
cache	remove startup checks for SELF_URL_PATH, rely on auto-detection instead	2023-10-22 12:19:05 +03:00
classes	Tweak the PHPUnit config and fix a UrlHelper deprecation that was identified.	2025-10-11 21:17:19 +00:00
feed-icons	remove startup checks for SELF_URL_PATH, rely on auto-detection instead	2023-10-22 12:19:05 +03:00
images	share: move og:image back to head	2021-03-21 09:35:43 +03:00
include	Switch links to the 'tt-rss' GitHub organization.	2025-10-06 19:02:28 +00:00
js	Improve 'App.getSelectedText()'.	2025-10-10 23:30:34 +00:00
lib	Bump Dojo from 1.16.5 to 1.17.3.	2025-10-05 04:34:29 +00:00
locale	Translated using Weblate (Albanian)	2025-10-10 20:07:25 +02:00
lock	remove startup checks for SELF_URL_PATH, rely on auto-detection instead	2023-10-22 12:19:05 +03:00
plugins	Add some DOMElement hints to help PHPStan.	2025-10-11 01:41:56 +00:00
plugins.local
schema	bring back web dbupdate using new migrations system	2021-03-04 09:22:24 +03:00
sql/pgsql	record last cron expression (and stub owner_uid) used by scheduled task	2025-05-04 18:06:43 +03:00
templates	Switch links to the 'tt-rss' GitHub organization.	2025-10-06 19:02:28 +00:00
templates.local	allow overriding built-in templates via templates.local	2020-03-13 14:40:35 +03:00
tests	PHPUnit cleanup, get group detection working.	2025-10-11 16:27:34 +00:00
themes	implement special counter display when viewing by published, similar to marked	2025-07-30 19:24:53 +03:00
themes.local
utils	Remove assorted unused stuff.	2025-10-11 21:17:31 +00:00
vendor	Drop 'require-dev' in 'composer.json' for now.	2025-10-11 15:01:11 +00:00
.dockerignore	Revert "pass .git to docker context so self-built images would have some way to determine version without CI variables"	2023-11-01 13:24:04 +03:00
.editorconfig	update editorconfig	2021-03-14 12:49:37 +03:00
.env-dist	remove startup checks for SELF_URL_PATH, rely on auto-detection instead	2023-10-22 12:19:05 +03:00
.eslintrc.js	Bump ESLint ecmaVersion to 2020.	2025-03-30 18:12:55 +00:00
.gitignore	Tweak the PHPUnit config and fix a UrlHelper deprecation that was identified.	2025-10-11 21:17:19 +00:00
backend.php	Use the official JSON MIME type of 'application/json'.	2025-06-03 13:53:12 +00:00
composer.json	Drop 'require-dev' in 'composer.json' for now.	2025-10-11 15:01:11 +00:00
composer.lock	Drop 'require-dev' in 'composer.json' for now.	2025-10-11 15:01:11 +00:00
config.php-dist	Switch links to the 'tt-rss' GitHub organization.	2025-10-06 19:02:28 +00:00
CONTRIBUTING.md	Improve 'CONTRIBUTING.md'.	2025-10-11 20:03:41 +00:00
COPYING	add COPYING	2017-04-22 15:42:34 +03:00
docker-compose.yml	Update images in docker-compose.yml	2025-10-10 09:35:37 +00:00
gulpfile.js	revert back to lower contrast light theme by default, add separate light-high-contrast.less	2021-03-25 20:29:36 +03:00
index.php	make default light/dark themes configurable, add support for main application and login form	2025-08-01 17:22:21 +03:00
jsconfig.json	unify prefs/main App objects, remove fake classes, use single static App object instead	2020-06-04 22:19:23 +03:00
messages.pot	rebase translations	2025-05-04 13:45:30 +03:00
package-lock.json	Drop the 'eslint-formatter-gitlab' dev dependency.	2025-10-05 05:26:50 +00:00
package.json	Drop the 'eslint-formatter-gitlab' dev dependency.	2025-10-05 05:26:50 +00:00
phpstan.neon	Cache PHPStan results, drop 'parallel.maximumNumberOfProcesses' param.	2025-10-11 05:38:51 +00:00
phpunit.xml	Tweak the PHPUnit config and fix a UrlHelper deprecation that was identified.	2025-10-11 21:17:19 +00:00
prefs.php	Switch links to the 'tt-rss' GitHub organization.	2025-10-06 19:02:28 +00:00
public.php	Use the official JSON MIME type of 'application/json'.	2025-06-03 13:53:12 +00:00
README.md	Mention GitHub Container Registry images + minor tweaks in the README.	2025-10-10 04:05:42 +00:00
update.php	stop checking for pidlock in yet another place	2025-07-04 13:59:22 +03:00
update_daemon2.php	replace all instances of die() with print+exit because die() returns exit code 0	2025-07-04 13:31:15 +03:00

README.md

Tiny Tiny RSS (tt-rss)

Tiny Tiny RSS (tt-rss) is a free, flexible, open-source, web-based news feed (RSS/Atom/other) reader and aggregator.

Getting started

Please refer to the wiki.

Some notes about this project

The original tt-rss project, hosted at https://tt-rss.org/ and its various subdomains, will be gone after 2025-11-01.
- Massive thanks to fox for creating tt-rss, and maintaining it (and absolutely everything else that went along with it) for so many years.
This project (https://github.com/tt-rss/tt-rss) is a fork of tt-rss as of 2025-10-03, created by one of its long-time contributors (wn_/wn_name on tt-rss.org, supahgreg on github.com).
- The goal is to continue tt-rss development, with an initial focus on getting things working as expected without tt-rss.org.
- Developer note: Due to use of invalid@email.com on supahgreg's pre-2025-10-03 commits (which were done on tt-rss.org) GitHub incorrectly shows ivanivanov884 (the GitHub user associated with that e-mail address) as the author instead of wn_/supahgreg. Apologies for any confusion. ¯\_(ツ)_/¯
Plugins that were under https://gitlab.tt-rss.org/tt-rss/plugins have been mirrored to https://github.com/tt-rss/tt-rss-plugin-*.
- Plugin repository names have changed to get a consistent tt-rss-plugin-* prefix.
Documentation from https://tt-rss.org has been recreated in https://github.com/tt-rss/tt-rss/wiki .
- The repository that held the content for https://tt-rss.org was mirrored to https://github.com/tt-rss/tt-rss-web-static . Some content tweaks were made after mirroring (prior to the wiki being set up), and the repository is now archived.
Docker images (for linux/amd64 and linux/arm64) are being built and published (via GitHub Actions) to:
- Docker Hub (as supahgreg/tt-rss and supahgreg/tt-rss-web-nginx).
- GitHub Container Registry (as ghcr.io/tt-rss/tt-rss and ghcr.io/tt-rss/tt-rss-web-nginx).
- See the installation guide for how the images can be used.

Development and contributing

Contributions (code, translations, reporting issues, etc.) are welcome.
Development and issue tracking primarily happens in https://github.com/tt-rss/tt-rss .
Help translate tt-rss into your own language using Weblate.

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.