tblogs

A fast, modern, and hackable terminal blog reader written in Go. No external API dependencies—just a local config file and RSS/Atom feeds.

---

Features

• Browse and follow a curated list of tech/dev blogs
• Read posts from any RSS or Atom feed
• Save your favorite posts
• Search and filter blogs
• All data stored locally in a config file (no external API)
• Cross-platform: macOS, Linux, Windows
• Keyboard-driven TUI (Terminal User Interface)

---

Installation

Homebrew (recommended, after release)

brew tap ezeoleaf/tap
brew install tblogs

Download a Release

• Go to Releases and download the binary for your OS.
• Unpack and move it to a directory in your $PATH (e.g., /usr/local/bin).

Build from Source

git clone https://github.com/ezeoleaf/tblogs.git
cd tblogs
make build
./bin/tblogs

---

Usage

tblogs

• Use keyboard shortcuts to navigate:
  • Ctrl+B — Blogs
  • Ctrl+T — Home
  • Ctrl+P — Saved Posts
  • Ctrl+H — Help
  • Ctrl+F — Search
  • Ctrl+S — Save/follow
  • Ctrl+D — Delete saved post
  • Ctrl+L — Toggle last login mode. When on, only posts published after the last login date are shown.
• Select a blog to view its posts (fetched live from the feed)
• Press Enter on a post to open it in your browser

---

Configuration

• Config is stored in the OS-appropriate location:
  • macOS/Linux: ~/.config/tblogs/data.yml
  • Windows: %APPDATA%\tblogs\data.yml
• On first run, the config is created and pre-populated with a curated list of blogs.
• You can edit the config file directly to add/remove blogs, or use the app UI.
• Default blogs are defined in internal/config/default_blogs.yml.

---

Releases & Distribution

• Binaries are built automatically for each release (macOS, Linux, Windows).
• See the Releases page for downloads.

---

Screenshots

---

Contributing

Pull requests and issues are welcome! See CONTRIBUTING.md.

---

License

Apache License 2.0