No longer maintained. NostrFeedz-cli was the command-line companion to Nostr Feedz, which is now archived. Development of the reader continues in Readstr by PrivKey.
A beautiful command-line interface for Nostr-Feedz - your RSS and Nostr feed reader with cross-device synchronization.
- Pleb_Signer (NIP-55 via D-Bus) - Recommended for Linux desktop
- NIP-46 remote signer support
- nsec private key (fallback)
- RSS & Nostr Feeds - Subscribe to RSS feeds and Nostr long-form content (NIP-23)
- Cross-Device Sync - Sync subscriptions and read status via Nostr (kinds 30404, 30405)
- Tags & Categories - Organize feeds with tags and categories
- Uncategorized view - Find feeds without organization
- Images - External viewer integration (sxiv, feh, imv, eog)
- Image caching with background downloads
- Navigation with arrow keys
- Automatic cache cleanup
- Videos - Video player support (mpv, vlc, mplayer)
- YouTube video and Shorts playback
- Navigation with Shift+arrow keys
- Tiling window manager friendly
- Local SQLite database for offline reading
- Image caching (500MB limit, 30-day expiration)
- Favorites persistence
- Feed list with unread counts
- Tags for flexible grouping
- Categories for hierarchical organization
- Article aggregation across multiple feeds
- Go 1.21 or later
- SQLite3
- Optional: Image viewer (sxiv, feh, imv, eog)
- Optional: Video player (mpv, vlc, mplayer)
- Optional: Pleb_Signer for NIP-55 authentication
git clone https://github.com/plebone/nostrfeedz-cli
cd nostrfeedz-cli
go build -o nostrfeedz ./cmd/nostrfeedzgo install github.com/plebone/nostrfeedz-cli/cmd/nostrfeedz@latest-
Launch the app:
nostrfeedz
-
Choose authentication method:
-
Option 1 (Recommended): Pleb_Signer (NIP-55 via D-Bus)
- Requires Pleb_Signer running
- Most secure - keys never leave the signer app
- Press
1and then Enter
-
Option 2: Remote Signer (NIP-46)
- For desktop signers like nsecBunker
- Enter your bunker URL
- Format:
bunker://<pubkey>?relay=<relay-url>
-
Option 3: Private Key
- Enter your nsec (private key)
⚠️ Note: Your key will be stored locally
-
-
Start adding feeds:
- Press
ato add a new feed - Enter RSS URL or Nostr npub
- Press
Configuration is stored in ~/.config/nostrfeedz/config.yaml
nostr:
npub: "npub1..." # Auto-filled after login
nsec: "" # Only if using private key auth
relays:
- "wss://relay.damus.io"
- "wss://nos.lol"
- "wss://relay.snort.social"
# Pleb_Signer (NIP-55 via D-Bus) - Recommended for Linux
pleb_signer:
enabled: true # Set to true for Pleb_Signer
key_id: "" # Optional: specific key to use
remote_signer:
enabled: false # Set to true for NIP-46
bunker_url: "bunker://..."
sync:
enabled: true
auto_sync_interval: "15m"
reading:
mark_read_behavior: "on-open"
organization_mode: "tags"
display:
theme: "default"
feed_list_width: 30
article_list_width: 40q/Ctrl+C- Quit?- Show helpTab- Cycle between panels
↑/k- Previous feed↓/j- Next feedEnter- Open feeda- Add new feedd- Delete feedr- Refresh feeds- Sync with Nostr
↑/k- Previous article↓/j- Next articleEnter- Open articlem- Mark as read/unreadf- Toggle favorite
↑/k- Scroll up↓/j- Scroll downSpace- Page downo- Open in browserEsc- Go back
NostrFeedz CLI integrates with Pleb_Signer, a secure Nostr signer for Linux:
-
Install Pleb_Signer:
# See: https://github.com/PlebOne/Pleb_Signer -
Start Pleb_Signer and unlock it
-
Run NostrFeedz CLI and select option 1
Benefits:
- ✅ Keys never leave the signer app
- ✅ User approval for each signature
- ✅ System tray integration
- ✅ Auto-approve for trusted apps
Architecture supports NIP-46 remote signers (implementation in progress):
- nsecBunker - Desktop/web remote signer
- Amber via relay bridge
- Any NIP-46 compatible signer
- Kind 30404 - Subscription list sync
- Kind 30405 - Read status sync
Your subscriptions and read status are synced across all devices using replaceable Nostr events.
wss://relay.damus.io
wss://nos.lol
wss://relay.snort.social
wss://relay.nostr.band
wss://nostr-pub.wellorder.net
Data is stored locally in ~/.local/share/nostrfeedz/feeds.db (SQLite)
- Feeds and subscriptions
- Article cache
- Read status
- Favorites
- Tags and categories
- Project structure and dependencies
- Database schema and operations
- Configuration management
- Nostr client with multi-signer support (Pleb_Signer NIP-55, NIP-46 architecture)
- Pleb_Signer (NIP-55) integration via D-Bus
- Basic TUI with authentication flow
- Feed list view
- Subscription sync (Kind 30404) - Cross-device feed list
- Read status sync (Kind 30405) - Cross-device read tracking
- Tag import and storage
- RSS feed metadata fetching
- Nostr profile metadata fetching
- Dark terminal color scheme
- RSS feed article fetching
- Nostr feed fetching (NIP-23 long-form content)
- Article list and reader views
- Tag display in TUI
- Remote Signer (NIP-46) implementation
- Publish local changes back to Nostr
- Continuous background sync
- Search functionality
- Category management UI
- Guide directory integration
- Video feed support
- Markdown rendering with syntax highlighting
Contributions are welcome! Please feel free to submit a Pull Request.
MIT License - see LICENSE file for details
Built with:
- Bubble Tea - TUI framework
- Lip Gloss - Styling
- go-nostr - Nostr protocol
- gofeed - RSS parsing
- Web App: https://nostrfeedz.com
- GitHub: https://github.com/PlebOne/Nostr-Feedz
- Nostr: npub13hyx3qsqk3r7ctjqrr49uskut4yqjsxt8uvu4rekr55p08wyhf0qq90nt7
↑/↓ork/j- Navigate up/downEnter- Open selected itemEsc- Go backTab- Switch view (Feeds/Tags/Categories)q- Quit
s- Sync from Nostr- Unread counts shown next to each feed
↑/↓- Scroll through articlesEnter- Read article (marks as read)f- Toggle favorite
↑/↓- Scroll articlei- View image (if available)←/→- Navigate between images (if multiple)v- Play video (if available)Shift+←/→- Navigate between videos (if multiple)
- Navigate with
↑/↓ - Press
Enterto see all articles from feeds with that tag/category - Uncategorized category shows feeds without assigned category
- Quick Start Guide - Get started quickly
- NIP-55 Setup Guide - Pleb_Signer authentication
- Image Viewing - External image viewer setup
- Video Player - Video playback configuration
- Tags and Categories - Organization features
- Setting Up Tags & Categories - Configure in Nostr
- TODO & Roadmap - Future plans and tasks
- Troubleshooting - Common issues and solutions
Version: 0.1.0-dev (Active Development)
- Authentication (Pleb_Signer NIP-55, NIP-46 architecture, nsec)
- Feed syncing from Nostr (kind 30404)
- Read status sync (kind 30405)
- RSS and Nostr feed fetching
- Article reading with markdown rendering
- Image viewing (external viewers)
- Video playback (mpv, vlc)
- YouTube video and Shorts support
- Tags and Categories organization
- Unread count badges
- Image caching
- Process management for external apps
- Unread counts require ESC to feeds view to refresh
- Debug output still present (will be removed)
- Tags/Categories need to be set up in NostrFeedz.com first
See TODO.md for complete roadmap and task list.