2018-02-24 17:15:45 +01:00
|
|
|
# gomuks
|
2018-03-23 00:21:43 +01:00
|
|
|
|
|
|
|
|
[](LICENSE)
|
|
|
|
|
[](https://github.com/tulir/gomuks/releases)
|
2018-04-10 20:35:27 +02:00
|
|
|
[](https://travis-ci.org/tulir/gomuks)
|
2018-04-22 19:23:33 +02:00
|
|
|
[](https://codeclimate.com/github/tulir/gomuks)
|
|
|
|
|
[](https://codeclimate.com/github/tulir/gomuks)
|
2018-03-23 00:21:43 +01:00
|
|
|
|
2018-04-17 16:29:12 +02:00
|
|
|
|
2018-03-16 15:33:33 +01:00
|
|
|
|
2018-03-15 20:53:50 +01:00
|
|
|
A terminal Matrix client written in Go using [gomatrix](https://github.com/matrix-org/gomatrix) and [tview](https://github.com/rivo/tview).
|
2018-03-13 22:02:19 +01:00
|
|
|
|
2018-03-20 11:16:32 +01:00
|
|
|
Basic usage is possible, but expect bugs and missing features.
|
2018-03-15 20:53:50 +01:00
|
|
|
|
2018-03-16 15:46:05 +01:00
|
|
|
## Discussion
|
|
|
|
|
Matrix room: [#gomuks:maunium.net](https://matrix.to/#/#gomuks:maunium.net)
|
|
|
|
|
|
2018-03-15 20:53:50 +01:00
|
|
|
## Installation
|
|
|
|
|
Once the client becomes actually usable, I'll start making GitHub releases with
|
2018-06-11 20:38:42 +02:00
|
|
|
precompiled executables. For now, you can either download
|
2018-05-15 19:15:14 +02:00
|
|
|
a CI build from [dl.maunium.net/programs/gomuks](https://dl.maunium.net/programs/gomuks)
|
|
|
|
|
or compile from source:
|
2018-03-15 20:53:50 +01:00
|
|
|
|
2018-04-02 12:39:18 +02:00
|
|
|
0. Install [Go](https://golang.org/) 1.10 or higher
|
2018-03-15 20:53:50 +01:00
|
|
|
1. Run `go get -u maunium.net/go/gomuks`
|
|
|
|
|
2. gomuks should now be in `$GOPATH/bin/gomuks`
|
2018-03-16 15:35:52 +01:00
|
|
|
|
|
|
|
|
## Usage
|
2018-05-20 23:39:20 +02:00
|
|
|
- switch rooms - `Ctrl + ↑` `Ctrl + ↓` `Alt + ↑` `Alt + ↓`
|
|
|
|
|
- scroll chat (line) - `↑` `↓`
|
|
|
|
|
- scroll chat (page) - `PgUp` `PgDown`
|
|
|
|
|
- jump to room - `Alt + Enter`, then `Tab` and `Enter` to navigate and select room
|
2018-03-16 15:35:52 +01:00
|
|
|
|
|
|
|
|
### Commands
|
2018-06-30 22:26:40 +02:00
|
|
|
* `help` - Is a known command
|
|
|
|
|
* `me <text>` - Send an emote
|
|
|
|
|
* `quit` - Close gomuks
|
|
|
|
|
* `clearcache` - Clear room state and close gomuks
|
|
|
|
|
* `leave` - Leave the current room
|
|
|
|
|
* `join <room>` - Join the room with the given room ID or alias
|
|
|
|
|
* `toggle <rooms/users/baremessages/images/typingnotif>` - Change user preferences
|
|
|
|
|
* `logout` - Log out, clear caches and go back to the login view
|
|
|
|
|
* `send <room id> <event type> <content>` - Send a custom event
|
|
|
|
|
* `setstate <room id> <event type> <state key/`-`> <content>` - Change room state
|
