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
|
% Generated Feeds
You can generate a feed (in Atom or JSON format) for almost anything displayed in headlines buffer (e.g. actual feeds, Labels, Categories, etc.) by clicking this icon:
Note that subscribing to your own feed of search results is going to cause duplicate articles on each and every feed update. See this forum thread for details: https://discourse.tt-rss.org/t/behaviour-of-search-feeds/122/2
## Data protection
Feed URLs are protected using random unique keys which are specific to each generated feed. Key can be regenerated at any time, invalidating previous URL.
You can clear all generated feeds in Preferences (`Feeds` → `Published & shared articles`).
## Anatomy of a generated feed URL
```
http://example.com/tt-rss/public.php?op=rss&id=61&is_cat=1&view-mode=adaptive&key=...
```
Note: `backend.php` would also work.
- ``id`` (integer) - requested feed ID
- ``is_cat`` (boolean) - whether the feed is a category
- ``view-mode`` (string) - see below
- ``key`` (string) - automatically generated access key, specific to feed id
### Optional parameters:
- ``login``, ``pass`` - see above
- ``format`` - since version:1.6.0 specifies output format, possible values: ``atom``, ``json``
- ``limit`` - amount of articles to output, default: 30
- ``offset`` - start output while skipping this amount of articles, default: 0
- ``order`` - override default headlines order
- ``ts`` - output articles newer than timestamp in [strtotime](http://www.php.net/manual/en/function.strtotime.php)
accepted format (since version:1.12) i.e. stuff like <code>ts=1%20month%20ago</code>
### Special feed IDs:
- ``-1`` - Starred articles
- ``-2`` - Published articles
- ``-3`` - Fresh articles
- ``-4`` - All articles
- ``0`` - Archived articles
Feed ID values less than -10 are considered Labels.
### Special category IDs (is\_cat=1):
- ``0`` - Uncategorized
- ``-1`` - Special category (includes Starred, Published, etc.)
- ``-2`` - Labels category (includes your labels)
### View mode values:
Note: It’s probably not a very good idea to use Adaptive view mode for
generated feeds.
- <code>adaptive</code> - shows unread articles only when they are
unread articles, shows everything otherwise
- <code>marked</code> (this means starred), <code>has\_note</code>,
<code>published</code>, <code>unread</code>,
<code>unread\_first</code> - should be self explanatory
Actual output may differ between modes for several special feeds for
usability reasons, e.g. recently read feed ignores <code>unread</code>
specifier because unread articles are never part of the feed).
### Order values:
- ``default`` - depends on the feed: either import batch date or (for published and starred feeds) ``last_published`` and ``last_marked``
- ``title`` - sort by title
- ``date_reverse`` - reverse sort by batch date
- ``feed_dates`` - sort by feed-provided article dates
See also: [PublishArticles](PublishArticles)
|
