Stars: 192
Forks: 26
Pull Requests: 10
Issues: 21
Watchers: 9
Last Updated: 2021-11-19 14:41:04
Tiny Tiny RSS Fever API Plugin
License: GNU General Public License v3.0
Languages: PHP
This is an open source plugin for Tiny Tiny RSS which simulates the Fever API. This allows Fever compatible RSS clients to use Tiny Tiny RSS.
See also: Fever API
Following Features are implemented:
Like Tiny Tiny RSS, the Fever API plugin is a rolling release model and there are no periodic updates. You should use git to clone the repository to install the plugin. If you must manually download a snapshot of the master branch, you can click the Download ZIP
button.
These clients should work with Fever API emulation.
IMPORTANT You must enable the option Enable API access
in your Tiny Tiny RSS preferences, for every user that wants to use the Fever plugin.
Clone this repository to your plugins.local
folder of your Tiny Tiny RSS installation.
$ cd tt-rss/plugins.local
$ git clone https://github.com/DigitalDJ/tinytinyrss-fever-plugin fever
Enable the fever
plugin in the Tiny Tiny RSS Preferences and reload.
A Fever Emulation
accordion pane should appear in your Tiny Tiny RSS preferences that will allow you to set a password for the Fever API. This is the password you will use to login to your Fever client, and should be different to your Tiny Tiny RSS login password.
IMPORTANT The Fever API uses insecure unsalted MD5 hash. You should choose a disposable application-specific password and consider the use of HTTPS with your Tiny Tiny RSS installation. Let's Encrypt is an excellent resource to setup free SSL certificates for your HTTP server.
Once the password is saved, you may login to your Fever client using your Tiny Tiny RSS username, the password you set in the previous step and the following server / endpoint URL:
https://example.com/tt-rss/plugins.local/fever/
See the archived forum post for more detailed and outdated information.
Upgrading the Fever plugin follows the same steps as your Tiny Tiny RSS installation:
$ cd tt-rss/plugins.local
$ git pull origin master
In the file fever_api.php
there are two flags for debugging at the beginning of the file.
DEBUG
- set this to TRUE
to produce extra debugging output. The location of the log is dependent on your PHP log_errors
and error_log
configuration directives.DEBUG_USER
- set this to the ID (from ttrss_users
database table) of your user you would like to force authenticate with. The authentication process is then skipped and the API is always authenticated using this ID.If you have problems with authentication after updating the plugin, try to re-enter the password in Tiny Tiny RSS Fever plugin and save it again.
If you encounter any defects please create an issue on GitHub.
Please include any debug logs and any output from the Tiny Tiny RSS Error Log
(located in Preferences > System).
IMPORTANT Ensure logs are sanitized by removing any usernames, passwords and API keys.
Also specify versions and variants of the software you are using:
GPL-3.0
v1.0-v1.2 - 2013/05/27
v1.3 - 2013/06/27
v1.4 - 2013/06/28
v1.4.1 - 2013/06/28
v1.4.2 - 2013/06/28
v1.4.3 - 2013/06/28
v1.4.4 - 2013/06/28
v1.4.5 - 2013/06/29
v1.4.6 - 2014/01/15
v1.4.7 - 2014/01/15
v2.0 - 2017/05/16
v2.1 - 2017/12/25
v2.2 - 2018/01/22
v2.3 - 2020/01/27
v2.4 - 2021/02/16
v3 - 2021/11/18