# Hemingway

An economical RSS reader for your terminal. I needed an RSS feed reader and I'm learning Rust, so I decided to build one myself. Hemingway aims to be small and easy to use.

## Updates

Check the [changelog](/CHANGELOG)!

## Misc.

Hemingway stores your feeds list in a `.hemrc` file in your home directory. This file is in JSON format, mostly because it's easy to work with. Hemingway will create the `.hemrc` file the first time you run it.

## Installation

```bash
$ cargo install hemingway
```

## Usage

### Check for updates

**Shows you up to 5 of the newest articles if there's been an update to the site since you last ran Hemingway**

```bash
$ hem
```

> 👉 Heads up! This will create a `.hemrc` in your home folder if the file doesn't exist (ie you're running Hemingway for the first time).

### Display `n` newest articles from all your feeds (defaults to 1)

```bash
$ hem top 3 # shows the 3 newest articles from all feeds
```

### Add a feed

```bash
$ hem add https://example.com/feed.xml
```

### Remove feeds

```bash
$ hem remove
```

Lists out all your feeds. Move up and down the list with the arrow keys, select feeds with the space bar. Click `enter` to delete selected feeds.

### List out your saved feeds

```bash
$ hem list
```
