mirror of
https://github.com/tildeclub/site.git
synced 2026-08-25 11:59:23 +00:00
49bcc06b56
Software words and website words are capitalized (or, as another option, all caps), articles in the "tilde.club" category must have most words capitalized (may capitalize word in case of doubt), and the rest of the titles must have first word, of the title, capitalized, with the rest of the (non-software) words, of the title, all lowercase. Signed-off-by: keyboardan <keyboardan@tilde.club>
53 lines
1.4 KiB
Markdown
53 lines
1.4 KiB
Markdown
---
|
|
title: Ttrv (Reddit in your terminal)
|
|
author: deepend
|
|
category: software
|
|
---
|
|
|
|
`ttrv` is a TUI Reddit client.
|
|
|
|
## Setup
|
|
|
|
### 1) Create the right Reddit app
|
|
|
|
* Go to [https://www.reddit.com/prefs/apps](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`:
|
|
|
|
```ini
|
|
[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
|
|
|
|
```bash
|
|
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/](http://127.0.0.1:65000/)**, missing slash, different port)
|
|
|
|
**GitHub:** [https://github.com/tildeclub/ttrv](https://github.com/tildeclub/ttrv)
|