An open API service indexing awesome lists of open source software.

https://github.com/h2337/rssnix

Unix-style filesystem-based RSS/Atom/JSON Feed fetcher/reader
https://github.com/h2337/rssnix

atom atom-feed go golang json-feed jsonfeed news rss rss-feed rss-feed-parser rss-reader

Last synced: 6 months ago
JSON representation

Unix-style filesystem-based RSS/Atom/JSON Feed fetcher/reader

Awesome Lists containing this project

README

          

## TOC

* [Demonstration](#demonstration)
* [Installation](#installation)
* [Packages](#packages)
* [Flags](#flags)
* [Config](#config)

## Demonstration

![Demo](https://github.com/h2337/file-hosting/blob/3613fb4d60f0fc64ce77d8c56279bcd6bdf769a3/rssnix-demo2.gif?raw=true)

## Installation

You need to have Go >=1.19 installed.

`git clone https://github.com/h2337/rssnix --depth=1 && cd rssnix && go install`

## Packages

Arch Linux AUR Package (build newest version) AUR

Arch Linux AUR Package (binary newest version) AUR

Arch Linux AUR Package (build from git) AUR

## Flags

`config`
- Opens config file with `$EDITOR`

`update [feed name]`
- If [feed name] argument is given and is space-delimited list of feeds, then these feeds are updated
- If no [feed name] argument is given then all feeds are updated

`open [feed name]`
- If [feed name] argument is given then the said feed's directory is opened with the configured viewer
- If no [feed name] argument is given then the root feeds directory is opened with the configured viewer

`add [feed name] [feed url]`
- Adds a new feed to the config file

`import [OPML URL or file path]`
- Imports feeds from OPML file

`refetch [feed name]`
- delete and refetch given feed(s) or all feeds if no argument is given

`version`
- Prints the rssnix version

## Config

Config file is expected to be at `~/.config/rssnix/config.ini`.

Sample config file:

```
[settings]
viewer = vim
feed_directory = ~/rssnix

[feeds]
CNN-Tech = http://rss.cnn.com/rss/edition_technology.rss
HackerNews = https://news.ycombinator.com/rss
```
(Tip: `ranger` is another great candidate for `viewer`)