gomuks/README.md

59 lines
2.4 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-04-10 20:35:27 +02:00
[![Build Status](https://travis-ci.org/tulir/gomuks.svg?branch=master)](https://travis-ci.org/tulir/gomuks)
2018-04-22 19:23:33 +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-04-17 16:29:12 +02:00
![Chat Preview](chat-preview.png)
2018-03-16 15:33:33 +01:00
2018-11-13 23:00:35 +01:00
A terminal Matrix client written in Go using [mautrix](https://github.com/matrix-org/mautrix) 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
2019-02-04 18:13:24 +01:00
0. Install [Go](https://golang.org/) 1.11 or higher
1. Clone the repo: `git clone https://github.com/tulir/gomuks.git && cd gomuks`
2. Build: `go build`
2018-03-16 15:35:52 +01:00
2019-02-04 18:13:24 +01:00
Simply pull changes (`git pull`) and run `go build` again to update.
2018-10-18 14:55:17 +02:00
2019-02-04 18:13:24 +01:00
## Developing
2018-10-18 14:55:17 +02:00
For debugging, use `tail -f /tmp/gomuks-debug.log` and write to it using the methods in the `maunium.net/go/gomuks/debug` package:
```go
import (
"maunium.net/go/gomuks/debug"
)
...
func Foo() {
debug.Print("WHY ISN'T IT WORKING?!?!?")
}
```
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
* `/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
2018-10-18 14:55:17 +02:00
* `/setstate <room id> <event type> <state key/-> <content>` - Change room state