https://github.com/sajattack/discourse-tui
Terminal UI for Discourse forums
https://github.com/sajattack/discourse-tui
Last synced: 11 months ago
JSON representation
Terminal UI for Discourse forums
- Host: GitHub
- URL: https://github.com/sajattack/discourse-tui
- Owner: sajattack
- License: mit
- Created: 2017-12-27T00:22:27.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2019-03-25T05:32:22.000Z (over 7 years ago)
- Last Synced: 2025-05-13T02:18:46.444Z (about 1 year ago)
- Language: Rust
- Size: 34.2 KB
- Stars: 11
- Watchers: 3
- Forks: 2
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# discourse-tui
Terminal UI for Discourse forums
## Dependencies
* Cargo
* ncurses
## Setup
```sh
mkdir -p ~/.config/discourse-tui
cp theme.toml ~/.config/discourse-tui
cargo build --release
sudo cp target/release/discourse-tui /usr/bin
```
## Run (unauthenticated)
```sh
discourse-tui
```
## Setup Api Key
### First you need to register discourse-tui as the handler for discourse:// URIs
```sh
cp discourse-tui.desktop ~/.local/share/applications
```
Add this line to ~/.config/mimeapps.list, under \[Added Associations\] and \[Default Applications\]
```
x-scheme-handler/discourse=discourse-tui.desktop
```
You may need to logout for this to have an effect.
### Now, back to discourse-tui
```sh
discourse-tui --new-key
```
Click the link
Click "Authorize"
You should see a terminal flash open briefly, this is discourse-tui opening and completing the authentication.
Now just run
```sh
discourse-tui
```
The TUI will open with the URL you specified in the --new-key phase and you will be logged in.
## Troubleshooting
* If discourse-tui doesn't flash open when you click "Authorize", you will need to manually copy the `discourse://auth_redirect?payload=` URI as an argument to discourse-tui.
Try opening the network tab of your browser's developer tools, refreshing the authorize page, clicking authorize, and look for this URI.
* Blank screen in tmux - add this to your ~/.tmux.conf `set -g default-terminal "screen-256color"`