From 5f58e639355f31c4de910aa09dbe9b9abe5a9bbc Mon Sep 17 00:00:00 2001
From: deepend-tildeclub <58404188+deepend-tildeclub@users.noreply.github.com>
Date: Mon, 29 Sep 2025 16:12:53 -0600
Subject: [PATCH] Add setup guide for ttrv Reddit client

Added documentation for setting up the ttrv Reddit client, including app creation, configuration, and common issues.
---
 wiki/source/ttrv.md | 53 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)
 create mode 100644 wiki/source/ttrv.md

diff --git a/wiki/source/ttrv.md b/wiki/source/ttrv.md
new file mode 100644
index 0000000..0e4c46d
--- /dev/null
+++ b/wiki/source/ttrv.md
@@ -0,0 +1,53 @@
+---
+
+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)