Introduction

OldNews is a terminal-based client for TheOldReader. It provides the ability to read news feeds while using TheOldReader as the server for your RSS/atom subscriptions.

OldNews is and generally always will be fairly opinionated about the "best" way to make use of TheOldReader (AKA how I like to use it); but where possible I want to keep it quite general so it will be useful to anyone.

Installing

pipx

The application can be installed using pipx:

$ pipx install oldnews

uv

The application can be installed using uv:

uv tool install oldnews

If you don't have uv installed you can use uvx.sh to perform the installation. For GNU/Linux or macOS or similar:

curl -LsSf uvx.sh/oldnews/install.sh | sh

or on Windows:

powershell -ExecutionPolicy ByPass -c "irm https://uvx.sh/oldnews/install.ps1 | iex"

Once installed run the oldnews command.

File locations

OldNews stores files in an oldnews directory within both $XDG_DATA_HOME and $XDG_CONFIG_HOME. If you wish to fully remove anything to do with OldNews you will need to remove those directories too.

Expanding for the common locations, the files normally created are:

• ~/.config/oldnews/configuration.json -- The configuration file.
• ~/.local/share/oldnews/* -- The locally-held data.

Questions and feedback

If you need help, or have any ideas, please feel free to raise an issue or start a discussion.

TODO

See the TODO tag in issues to see what I'm planning.