FreshRSS Reader

# FreshRSS

Query headlines from a self-hosted FreshRSS instance via the Google Reader compatible API.

## Setup

Set these environment variables:

```bash export FRESHRSS_URL="https://your-freshrss-instance.com" export FRESHRSS_USER="your-username" export FRESHRSS_API_PASSWORD="your-api-password" ```

API password is set in FreshRSS → Settings → Profile → API Management.

## Commands

### Get latest headlines

```bash {baseDir}/scripts/freshrss.sh headlines --count 10 ```

### Get headlines from the last N hours

```bash {baseDir}/scripts/freshrss.sh headlines --hours 2 ```

### Get headlines from a specific category

```bash {baseDir}/scripts/freshrss.sh headlines --category "Technology" --count 15 ```

### Get only unread headlines

```bash {baseDir}/scripts/freshrss.sh headlines --unread --count 20 ```

### Combine filters

```bash {baseDir}/scripts/freshrss.sh headlines --category "News" --hours 4 --count 10 --unread ```

### List categories

```bash {baseDir}/scripts/freshrss.sh categories ```

### List feeds

```bash {baseDir}/scripts/freshrss.sh feeds ```

## Output

Headlines are formatted as: ``` [date] [source] Title URL Categories: cat1, cat2 ```

## Notes

- Default count is 20 headlines if not specified - Time filtering uses `--hours` for relative time (e.g., last 2 hours) - Category names are case-sensitive and must match your FreshRSS categories - Use `categories` command first to see available category names