Project

fmog

0.0
No release in over 3 years
fmog (Feed MogMog) is a command-line RSS/Atom feed aggregator. Subscribe to feeds, fetch updates, and read items — all from your terminal, with JSON output for piping.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Development

~> 5.0
~> 13.0
~> 3.0
~> 1.9

Runtime

~> 0.3
~> 2.0
~> 1.3
~> 10.0
 Project Readme

fmog (Feed MogMog)

A CLI feed aggregator written in Ruby. Subscribe to and read RSS/Atom feeds from your terminal.

Installation

gem install fmog

Or try it without installing (like npx):

gem exec fmog feed list

Usage

Feed Management

# Add a feed
fmog feed add https://example.com/feed.xml

# List all feeds
fmog feed list

# Fetch all feeds
fmog feed fetch

# Fetch a specific feed
fmog feed fetch 1

# Remove a feed
fmog feed remove 1

Item (Article) Management

# List items
fmog item list

# Show only unread items
fmog item list --unread

# Filter items by feed
fmog item list --feed 1

# Limit the number of items
fmog item list --limit 10

# Show item details
fmog item show 1

# Mark as read
fmog item read 1

# Mark as unread
fmog item unread 1

Output Format

  • Terminal (TTY): Human-readable table format
  • Pipe/Redirect: JSON Lines (one JSON object per line)
# Pipe JSON Lines to other commands
fmog item list --unread | jq '.title'

Data Storage

~/.local/share/fmog/fmog.db (SQLite)

Development

# Run tests
bundle exec rake test

# Run type check
bundle exec rake steep

# Run full CI (tests + type check)
bundle exec rake ci