Skip to content

README.md

Latest commit

 

History

History
74 lines (50 loc) · 1.6 KB

README.md

File metadata and controls

74 lines (50 loc) · 1.6 KB

Feedlet

Minimal RSS feed aggregator with tiling layout and knowledge retention bar.

Features

  • Multiple source types (RSS, Reddit, Hacker News, custom scrapers)
  • Auto-refresh via SSE
  • Knowledge bar (random Java tidbits on each refresh)
  • Embedded configuration

Quick Start

# 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:

{
    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, cagematch

hnalgolia sources fetch Hacker News directly from hn.algolia.com.

cagematch sources fetch current-year top-rated wrestling matches directly from Cagematch.

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

Knowledge Bar

Shows random Java concepts on each page load/refresh. Covers:

  • OOP pillars (encapsulation, inheritance, polymorphism, abstraction)
  • Collections, generics, exceptions
  • Concurrency, streams, lambdas
  • Design patterns, SOLID principles

Edit internal/knowledge/knowledge.go to customize.