Tuir: Difference between revisions
From wikinotes
No edit summary |
|||
(2 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
Commandline reddit client.<br> | Commandline reddit client.<br> | ||
Fork of [[rtv]] to keep it alive. | Fork of [[rtv]] to keep it alive. | ||
{{ WARNING | | |||
[[rtv]] is once again being maintained, and tuir is not.<br> | |||
the king is dead, long live the king. | |||
}} | |||
= Documentation = | = Documentation = | ||
Line 21: | Line 26: | ||
|- | |- | ||
| <code>~/.config/tuir/mailcap</code> || associate mimetypes to programs | | <code>~/.config/tuir/mailcap</code> || associate mimetypes to programs | ||
|- | |||
| <code>~/.local/share/tuir</code> || ephemeral data, like refresh tokens | |||
|- | |- | ||
|} | |} | ||
Line 51: | Line 58: | ||
=== OAUTH token creation === | === OAUTH token creation === | ||
<blockquote> | <blockquote> | ||
From '''July 2021 - Aug 2021''', you needed to create/assign your own OAUTH token. | |||
{{ expand | {{ expand |
Latest revision as of 23:37, 29 December 2023
Commandline reddit client.
Fork of rtv to keep it alive.
WARNING:
rtv is once again being maintained, and tuir is not.
the king is dead, long live the king.
Documentation
gitlab https://gitlab.com/ajak/tuir hotkeys https://gitlab.com/ajak/tuir/-/blob/master/CONTROLS.md mailcap docs http://sand.truman.edu/~dbindner/guide/x2059.htm
Locations
~/.config/tuir/tuir.cfg
configure tuir ~/.config/tuir/mailcap
associate mimetypes to programs ~/.local/share/tuir
ephemeral data, like refresh tokens
Install
pacaur -S tuir tuir --copy-mailcap # replaces your ~/.config/tuir/.mailcap with defaults tuir --copy-config # replace your ~/.config/tuir/tuir.cfg with defaults
Configuration
Environment
tuir respects EDITOR, BROWSER, and URLVIEWER environment variables. If you would prefer to to override these you may.
export TUIR_EDITOR=nvim export TUIR_BROWSER=w3m export TUIR_URLVIEWER=urlviewConfiguration
OAUTH token creation
From July 2021 - Aug 2021, you needed to create/assign your own OAUTH token.
Create Token
- https://www.reddit.com/prefs/apps/ - create a new app type: installed app redirect uri: http://127.0.0.1:65000/ - token will be 3rd line under created token's name
Use Token
- copy token from https://www.reddit.com/prefs/apps/ (3rd line under app title)# ~/.config/tuir/tuir.cfg oauth_client_id = ${YOUR_TOKEN} oauth_client_secret = oauth_redirect_uri = http://127.0.0.1:65000/
Login
- tuir - press 'u' to login
vi hotkeys
todo: vi hotkeys
#SUBMISSION_OPEN_IN_BROWSER = o, <LF>, <KEY_ENTER> # #SUBREDDIT_OPEN_IN_BROWSER = o, <LF>, <KEY_ENTER> PROMPT = / # --> f SUBREDDIT_SEARCH = f # --> /logging
Logging is disabled by default, but enable it
# ~/.config/tuir/tuir.cfg [tuir] log = /var/tmp/tuir.log
Usage
/front # reddit frontpage /u/me # your posts /ghibli # go to /r/ghibli# ===== # setup # ===== u # login # ========== # navigation # ========== f # search selected reddit (or all reddit if on frontpage) p # toggle subreddit/frontpage s # list subscribed subreddits i # view inbox / # type subreddit name (ex: '/archlinux') # ========= # post list # ========= j/k # up/down h # back to list l # view comments enter # open c # comment C # private message # ======== # settings # ======== F2/F3 # cycle themes
Themes
rtv --list-themes rtv --theme colorblind-dark