Metadata-Version: 2.4
Name: feedctl
Version: 0.1.1
Summary: A terminal-based RSS reader
Author-email: Avikant Srivastava <contact@avikant.com>
License-Expression: MIT
Project-URL: Repository, https://github.com/avikant/rss-tui
Keywords: rss,tui,terminal,reader,textual
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Terminals
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: textual>=6.11.0
Requires-Dist: sqlalchemy>=2.0.48
Requires-Dist: feedparser>=6.0.11
Requires-Dist: aiohttp>=3.13.3
Requires-Dist: rich>=14.2.0
Provides-Extra: dev
Requires-Dist: textual-dev>=1.8.0; extra == "dev"
Requires-Dist: textual-serve>=1.1.3; extra == "dev"
Requires-Dist: build>=1.0.0; extra == "dev"
Requires-Dist: twine>=5.0.0; extra == "dev"

# feedctl

A terminal-based RSS reader built with [Textual](https://textual.textualize.io/).

## Features

- Browse RSS feeds in a clean three-column TUI
- Mark articles as read/unread (Space)
- Refresh feeds on demand (`r`)
- Theme switching via command palette (`Ctrl+P`)
- Articles stored locally in SQLite

## Installation

```bash
pip install feedctl
```

## Usage

```bash
feedctl
```

## Configuration

On first run, feedctl will ask you to set up your config file at `~/.config/feedctl/config.ini`:

```toml
[app]
theme = "default"

[[feeds]]
name = "Hacker News"
url = "https://news.ycombinator.com/rss"

[[feeds]]
name = "Reddit Programming"
url = "https://www.reddit.com/r/programming/.rss"
```

## Keybindings

| Key | Action |
|-----|--------|
| `→` | Focus articles column |
| `←` | Focus feeds column |
| `Space` | Mark article as read |
| `r` | Refresh feeds |
| `Ctrl+P` | Command palette (theme switcher, etc.) |
| `q` | Quit |
