feed-forager

Branches

master (2026-01-02 14:50:17 +0000)

Files

Name
public/index.php
src/AtomParser.php
src/Feed.php
src/FeedParser.php
src/NitterParser.php
src/Post.php
src/RssParser.php
src/functions.php
.dockerignore
.gitignore
Dockerfile
README.md
screenshot.png
# Feed Forager

Your own stupid simple personal RSS feed aggregator.

Screenshot


## Run

Create a file called `feeds.txt` in the root of the project and add URLs of the RSS/Atom feeds, one-per-line.

```txt
https://example.org/feed.rss
```

The easiest way to get started is to run PHPs built-in webserver.

```
PHP_CLI_SERVER_WORKERS=$(nproc) php -S localhost:8009 -t public
```

There is also a Docker container:

```
docker build -t feed-forager .
docker run \
    --name feed-forager \
    -e PHP_CLI_SERVER_WORKERS=$(nproc) \
    -d \
    -p 8009:80 \
    -v $PWD/feeds.txt:/var/www/html/feeds.txt \
    feed-forager
```

## Featured Feeds

If you want to highlight posts from your favourite feeds simply add a `*` to the start of the feed URL in `feeds.txt`

```txt
https://example.org/feed.rss
*https://example.org/roadrunner.rss
```