https://github.com/maetthu/republik-feeder
RSS feed generator service for republik.ch
https://github.com/maetthu/republik-feeder
republik rss
Last synced: 6 months ago
JSON representation
RSS feed generator service for republik.ch
- Host: GitHub
- URL: https://github.com/maetthu/republik-feeder
- Owner: maetthu
- License: mit
- Created: 2020-05-24T10:18:31.000Z (about 6 years ago)
- Default Branch: main
- Last Pushed: 2025-12-13T14:54:21.000Z (7 months ago)
- Last Synced: 2025-12-15T07:14:25.991Z (7 months ago)
- Topics: republik, rss
- Language: Go
- Homepage:
- Size: 84 KB
- Stars: 15
- Watchers: 1
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# republik-feeder
Quick and simple RSS service for [republik.ch](https://www.republik.ch) content. Listens for HTTP requests and returns
an RSS feed for most recent articles and narrated articles as a podcast feed.
> **Note**
> A paid [republik.ch](https://www.republik.ch) account is required for this tool to work.
> If the feed returns an empty list, make sure your subscription is already active.
## Feeds
* /articles the most recent articles
```
$ http http://localhost:8080/articles
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Date: Sun, 24 May 2020 20:54:45 GMT
Transfer-Encoding: chunked
Republik - RSS Feed
https://www.republik.ch
Republik - RSS Feed
kontakt@republik.ch (Republik)
Sun, 24 May 2020 22:54:45 +0200
...
```
* /podcast narrated articles as a podcast feed
```
$ http http://localhost:8080/podcast
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Date: Fri, 28 Oct 2022 19:26:57 GMT
Transfer-Encoding: chunked
Republik - RSS Feed
https://www.republik.ch
Republik - Podcast Feed
go podcast v1.3.1 (github.com/eduncan911/podcast)
de-CH
Fri, 28 Oct 2022 21:26:56 +0200
Fri, 28 Oct 2022 21:26:56 +0200
...
```
## Installation
* REPUBLIK_FEEDER_COOKIE: Contents of the connect.sid cookie after login in browser.
* REPUBLIK_FEEDER_URL: (optional) Root URL where this service is reachable, e.g https://example.org/feeds/republik
* REPUBLIK_FEEDER_ARTICLE_LIMIT: (optional) Number of articles in feed (default: 20)
### Manual
* [Download tarball from release page](https://github.com/maetthu/republik-feeder/releases)
* Run
```
$ export REPUBLIK_FEEDER_COOKIE="s%3Asomething..." REPUBLIK_FEEDER_URL="https://example.org/feeds/republik" REPUBLIK_FEEDER_ARTICLE_LIMIT="25"
$ ./republik-feeder :8080
```
### Docker
```
$ export REPUBLIK_FEEDER_COOKIE="s%3Asomething..." REPUBLIK_FEEDER_URL="https://example.org/feeds/republik" REPUBLIK_FEEDER_ARTICLE_LIMIT="25"
$ docker run -p 8080:8080 -e REPUBLIK_FEEDER_COOKIE=$REPUBLIK_FEEDER_COOKIE -e $REPUBLIK_FEEDER_URL=REPUBLIK_FEEDER_URL ghcr.io/maetthu/republik-feeder/republik-feeder:latest
```
### Docker compose
```
version: '3'
services:
republik-feeder:
image: "ghcr.io/maetthu/republik-feeder/republik-feeder:latest"
user: "65534:65534"
ports:
- "8080:8080"
environment:
REPUBLIK_FEEDER_COOKIE: "s%3Asomething..."
REPUBLIK_FEEDER_URL: "https://example.org/feeds/republik"
REPUBLIK_FEEDER_ARTICLE_LIMIT: "25"
```