https://github.com/ppowo/feedlet
Lightweight feed aggregator supporting RSS, Reddit, and custom scrapers with SSE auto-refresh
https://github.com/ppowo/feedlet
feed-aggregator go golang hacker-news reddit rss self-hosted server-sent-events
Last synced: 21 days ago
JSON representation
Lightweight feed aggregator supporting RSS, Reddit, and custom scrapers with SSE auto-refresh
- Host: GitHub
- URL: https://github.com/ppowo/feedlet
- Owner: ppowo
- License: mit
- Created: 2025-10-26T10:03:14.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2026-05-30T20:39:30.000Z (21 days ago)
- Last Synced: 2026-05-30T21:19:35.884Z (21 days ago)
- Topics: feed-aggregator, go, golang, hacker-news, reddit, rss, self-hosted, server-sent-events
- Language: Go
- Homepage:
- Size: 207 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Feedlet
Minimal RSS feed aggregator with tiling layout.
## Features
- Multiple source types (RSS, Reddit, Hacker News, custom scrapers)
- Auto-refresh via SSE
- Embedded configuration
## Quick Start
```bash
# Development with auto-reload
mage dev
# Build for Linux x86_64
mage build
# Run
./target/feedlet
```
Server runs on `http://localhost:3737`
## Configuration
Edit `internal/config/config.go` and rebuild:
```go
{
Name: "r/programming",
Type: "reddit",
URL: "https://old.reddit.com/r/programming/top/.rss?t=month",
Interval: 600,
IntervalJitter: 120,
Enabled: true,
Days: 7,
}
```
**Source types:** `rss`, `reddit`, `hnalgolia`, `tildes`, `desuarchive`, `meltzerwiki`
`hnalgolia` sources fetch Hacker News directly from `hn.algolia.com`.
`tildes` sources fetch topics from [Tildes](https://tildes.net).
`desuarchive` sources fetch threads from DesuArchive (4chan archives).
`meltzerwiki` sources fetch the latest Dave Meltzer 5★+ matches from Wikipedia.
## Logging
Logs to stdout and OS log directory:
- macOS: `~/Library/Logs/feedlet/`
- Linux: `~/.local/state/feedlet/logs/`
Auto-rotates daily, keeps 3 days.
## Mage Commands
- `mage dev` - Run with auto-reload
- `mage build` - Build for Linux x86_64 to `target/`
- `mage clean` - Remove build artifacts
- `mage setup` - Install tools