gomuks/README.md

38 lines
1.6 KiB
Markdown
Raw Normal View History

2018-02-24 17:15:45 +01:00
# gomuks
2018-03-23 00:21:43 +01:00
![Languages](https://img.shields.io/github/languages/top/tulir/gomuks.svg)
[![License](https://img.shields.io/github/license/tulir/gomuks.svg)](LICENSE)
[![Release](https://img.shields.io/github/release/tulir/gomuks/all.svg)](https://github.com/tulir/gomuks/releases)
2018-03-27 12:12:26 +02:00
[![Maintainability](https://img.shields.io/codeclimate/maintainability/tulir/gomuks.svg)](https://codeclimate.com/github/tulir/gomuks)
[![Coverage](https://img.shields.io/codeclimate/coverage/tulir/gomuks.svg)](https://codeclimate.com/github/tulir/gomuks)
2018-03-23 00:21:43 +01:00
2018-03-26 21:04:28 +02:00
![Preview](https://img.mau.lu/tlVuN.png)
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
precompiled executables and maybe even some Linux packages.
For now, you'll have to compile from source:
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-03-20 22:49:37 +01:00
Switch between rooms with ctrl + up/down arrow (alt+arrows works too).
2018-03-16 15:35:52 +01:00
2018-03-20 22:49:37 +01:00
Scroll chat with page up/down (half of height per click) or up/down arrow (1 row per click)
2018-03-16 15:35:52 +01:00
### Commands
* `/quit` - Close gomuks
* `/clearcache` - Clear room state cache and close gomuks
* `/leave` - Leave the current room
* `/join <room>` - Join the room with the given room ID or alias
2018-03-20 22:49:37 +01:00
* `/panic` - Trigger a test panic