Implementing TTRSS: Special feeds #119

New issue

Closed

opened 2017-10-06 10:47:52 -04:00 by jking · 3 comments

jking commented

2017-10-06 10:47:52 -04:00

Owner

TTRSS has a set of "special" virtual feeds:

All articles
Fresh articles
Starred articles
Published articles
Archived articles
Recently read

The names are fairly obvious from a semantic standpoint, but in a technical sense Fresh, Archived, and Recently read are a black box. Someone not involved in programming The Arsse (for legal reasons) would probably have to look at the source code of TTRSS and write a specification defining the parameters of these feeds.

For Fresh and Recently read, there's clearly some temporal cut-off, but this is not apparently defined anywhere.

In the case of Archived, are articles automatically archived, or is this entirely manual? If it is only manual it can probably be ignored: the API has no means of archiving articles.

TTRSS has a set of "special" virtual feeds: 1. All articles 2. Fresh articles 3. Starred articles 4. Published articles 5. Archived articles 6. Recently read The names are fairly obvious from a semantic standpoint, but in a technical sense Fresh, Archived, and Recently read are a black box. Someone not involved in programming The Arsse (for legal reasons) would probably have to look at the source code of TTRSS and write a specification defining the parameters of these feeds. For Fresh and Recently read, there's clearly some temporal cut-off, but this is not apparently defined anywhere. In the case of Archived, are articles automatically archived, or is this entirely manual? If it is only manual it can probably be ignored: the API has no means of archiving articles.

jking added this to the 0.2.0 milestone

2017-10-06 10:47:52 -04:00

jking added the

help wanted

feature

api

labels

2017-10-06 10:47:52 -04:00

jking commented

2017-10-06 16:13:17 -04:00

Author

Owner

There is a freshness maximum age in preferences which defaults to 24 hours. Recently read is probably simply a view of read articles sorted in descending order by read timestamp.

The archive appears to be entirely manual, as there is no similar preference for auto-archiving. It's possible that archiving blocks purging as starring does in NextCloud News, but as archiving is an inert feature in the TTRSS protocol and no other prospective protocol obviously has an archive, this point is moot.

There is a freshness maximum age in preferences which defaults to 24 hours. Recently read is probably simply a view of read articles sorted in descending order by read timestamp. The archive appears to be entirely manual, as there is no similar preference for auto-archiving. It's possible that archiving blocks purging as starring does in NextCloud News, but as archiving is an inert feature in the TTRSS protocol and no other prospective protocol obviously has an archive, this point is moot.

jking commented

2017-11-02 17:22:18 -04:00

Author

Owner

The "Recently read" feed appears to actually use the same 24-hour cut-off as the "Fresh" feed. This will be relevant for getHeadlines only.

The "Recently read" feed appears to actually use the same 24-hour cut-off as the "Fresh" feed. This will be relevant for `getHeadlines` only.

jking commented

2017-11-19 23:56:49 -05:00

Author

Owner

The "Fresh" feed is only ever unread articles.

jking referenced this issue from a commit