ttrv (Reddit in your terminal)

authors:

~deepend


table of contents

ttrv is a TUI Reddit client.

Setup §

1) Create the right Reddit app §

  • Go to https://www.reddit.com/prefs/apps → create another app…
  • Type: “installed app” (not “script”, not “web app”)
  • Redirect URI (must match exactly): http://127.0.0.1:65000/ ← note trailing slash
  • Copy the client ID (14-char string under the app name). Installed app has no secret.

2) Put creds in the right file §

Create or edit ~/.config/ttrv/ttrv.cfg:

[ttrv]
oauth_client_id = YOUR_CLIENT_ID
oauth_client_secret =
oauth_redirect_uri = http://127.0.0.1:65000/
oauth_redirect_port = 65000
autologin = True
persistent = True
  • Make a starter config: ttrv --copy-config
  • Refresh token is stored at: ~/.local/share/ttrv/refresh-token

3) First login §

Run ttrv, press u, authorize in the browser; it will callback to http://127.0.0.1:65000/.

Clear any bad cached token §

ttrv --clear-auth
# or
rm -f ~/.local/share/ttrv/refresh-token

Common “invalid client id” causes §

  • Wrong app type (must be installed app)
  • Redirect mismatch (anything other than http://127.0.0.1:65000/, missing slash, different port)

GitHub: https://github.com/tildeclub/ttrv