2015-08-25 00:37:56 +08:00
|
|
|
# gotty-client
|
2015-08-25 00:57:18 +08:00
|
|
|
:wrench: [GoTTY](https://github.com/yudai/gotty) client for your terminal
|
2015-08-25 00:51:46 +08:00
|
|
|
|
2015-09-29 04:12:02 +08:00
|
|
|
|
|
|
|
|
|
2015-08-25 19:33:56 +08:00
|
|
|
[](https://travis-ci.org/moul/gotty-client)
|
2015-08-25 00:51:46 +08:00
|
|
|
[](https://godoc.org/github.com/moul/gotty-client)
|
|
|
|
|
|
2015-08-28 21:47:26 +08:00
|
|
|
```ruby
|
2015-08-28 21:46:00 +08:00
|
|
|
+----------------+ +----------------+ +-------------+
|
|
|
|
|
| | | +---------> /bin/bash |
|
|
|
|
|
+---> Browser -----+ | gotty | | +-------------+
|
2015-09-28 03:57:49 +08:00
|
|
|
+-------+ | | | | | | |
|
2015-08-28 21:46:00 +08:00
|
|
|
| | | +----------------+ | | | | +-------------+
|
|
|
|
|
| Bob +---+ +--->---websockets+---------> /bin/bash |
|
|
|
|
|
| | | +================+ | | | | +-------------+
|
2015-09-28 03:57:49 +08:00
|
|
|
+-------+ | |................| | | | |
|
2015-08-28 21:46:00 +08:00
|
|
|
+--->..gotty-client.-----+ | | | +-------------+
|
|
|
|
|
|................| | +---------> /bin/bash |
|
|
|
|
|
+================+ +----------------+ +-------------+
|
|
|
|
|
|
2015-08-28 21:47:26 +08:00
|
|
|
^ ^ ^ ^ ^
|
|
|
|
|
| | | | |
|
2015-08-28 21:46:00 +08:00
|
|
|
```
|
|
|
|
|
|
2015-08-25 00:55:24 +08:00
|
|
|
## Usage
|
|
|
|
|
|
2015-10-11 05:42:05 +08:00
|
|
|
Server side ([GoTTY](https://github.com/yudai/gotty))
|
2015-08-25 00:55:24 +08:00
|
|
|
|
|
|
|
|
```console
|
|
|
|
|
$ gotty -p 9191 sh -c 'while true; do date; sleep 1; done'
|
|
|
|
|
2015/08/24 18:54:31 Server is starting with command: sh -c while true; do date; sleep 1; done
|
|
|
|
|
2015/08/24 18:54:31 URL: http://[::1]:9191/
|
|
|
|
|
2015/08/24 18:54:34 GET /ws
|
|
|
|
|
2015/08/24 18:54:34 New client connected: 127.0.0.1:61811
|
|
|
|
|
2015/08/24 18:54:34 Command is running for client 127.0.0.1:61811 with PID 64834
|
|
|
|
|
2015/08/24 18:54:39 Command exited for: 127.0.0.1:61811
|
|
|
|
|
2015/08/24 18:54:39 Connection closed: 127.0.0.1:61811
|
2015-10-11 05:42:05 +08:00
|
|
|
...
|
2015-08-25 00:55:24 +08:00
|
|
|
```
|
|
|
|
|
|
2015-10-11 05:42:05 +08:00
|
|
|
**Client side**
|
|
|
|
|
|
2015-08-25 00:55:24 +08:00
|
|
|
```console
|
|
|
|
|
$ gotty-client http://localhost:9191/
|
|
|
|
|
INFO[0000] New title: GoTTY - sh -c while true; do date; sleep 1; done (jean-michel-van-damme.local)
|
|
|
|
|
WARN[0000] Unhandled protocol message: json pref: 2{}
|
|
|
|
|
Mon Aug 24 18:54:34 CEST 2015
|
|
|
|
|
Mon Aug 24 18:54:35 CEST 2015
|
|
|
|
|
Mon Aug 24 18:54:36 CEST 2015
|
|
|
|
|
Mon Aug 24 18:54:37 CEST 2015
|
|
|
|
|
Mon Aug 24 18:54:38 CEST 2015
|
|
|
|
|
^C
|
|
|
|
|
```
|
|
|
|
|
|
2015-10-11 05:42:05 +08:00
|
|
|
## Install
|
|
|
|
|
|
|
|
|
|
Install latest version using Golang (recommended)
|
|
|
|
|
|
|
|
|
|
```console
|
|
|
|
|
$ go get github.com/moul/gotty-client/cmd/gotty-client
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
Install latest version using Homebrew (Mac OS X)
|
|
|
|
|
|
|
|
|
|
```console
|
|
|
|
|
$ brew install https://raw.githubusercontent.com/moul/gotty-client/master/contrib/homebrew/gotty-client.rb --HEAD
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
or the latest released version
|
|
|
|
|
|
|
|
|
|
```console
|
|
|
|
|
$ brew install https://raw.githubusercontent.com/moul/ssh2docker/master/contrib/homebrew/assh.rb
|
|
|
|
|
```
|
|
|
|
|
|
2015-09-28 03:57:49 +08:00
|
|
|
## Changelog
|
|
|
|
|
|
2015-10-11 05:27:25 +08:00
|
|
|
### master (unreleased)
|
|
|
|
|
|
|
|
|
|
* No entry
|
|
|
|
|
|
|
|
|
|
[full commits list](https://github.com/moul/gotty-client/compare/v1.1.0...master)
|
|
|
|
|
|
2015-10-11 05:25:48 +08:00
|
|
|
### v1.1.0 (2015-10-10)
|
2015-09-28 03:57:49 +08:00
|
|
|
|
2015-10-11 05:24:41 +08:00
|
|
|
* Handling arguments + using mutexes (thanks to [@QuentinPerez](https://github.com/QuentinPerez))
|
|
|
|
|
* Add logo ([#9](https://github.com/moul/gotty-client/issues/9))
|
2015-10-11 05:10:09 +08:00
|
|
|
* Using codegansta/cli for CLI parsing ([#3](https://github.com/moul/gotty-client/issues/3))
|
2015-10-11 05:08:23 +08:00
|
|
|
* Fix panic when running on older GoTTY server ([#13](https://github.com/moul/gotty-client/issues/13))
|
2015-09-28 03:57:49 +08:00
|
|
|
* Add 'homebrew support' ([#1](https://github.com/moul/gotty-client/issues/1))
|
|
|
|
|
* Add Changelog ([#5](https://github.com/moul/gotty-client/issues/5))
|
2015-09-28 04:27:37 +08:00
|
|
|
* Add GOXC configuration to build binaries for multiple architectures ([#2](https://github.com/moul/gotty-client/issues/2))
|
2015-09-28 03:57:49 +08:00
|
|
|
|
2015-10-11 05:25:48 +08:00
|
|
|
[full commits list](https://github.com/moul/gotty-client/compare/v1.0.1...v1.1.0)
|
2015-09-28 03:57:49 +08:00
|
|
|
|
|
|
|
|
### [v1.0.1](https://github.com/moul/gotty-client/releases/tag/v1.0.1) (2015-09-27)
|
|
|
|
|
|
|
|
|
|
* Using party to manage dependencies
|
|
|
|
|
|
|
|
|
|
[full commits list](https://github.com/moul/gotty-client/compare/v1.0.0...v1.0.1)
|
|
|
|
|
|
|
|
|
|
### [v1.0.0](https://github.com/moul/gotty-client/releases/tag/v1.0.0) (2015-09-27)
|
|
|
|
|
|
|
|
|
|
Compatible with [GoTTY](https://github.com/yudai/gotty) version: [v0.0.10](https://github.com/yudai/gotty/releases/tag/v0.0.10)
|
|
|
|
|
|
|
|
|
|
#### Features
|
|
|
|
|
|
|
|
|
|
* Support **basic-auth**
|
|
|
|
|
* Support **terminal-(re)size**
|
|
|
|
|
* Support **write**
|
|
|
|
|
* Support **title**
|
|
|
|
|
* Support **custom URI**
|
|
|
|
|
|
|
|
|
|
[full commits list](https://github.com/moul/gotty-client/compare/cf0c1146c7ce20fe0bd65764c13253bc575cd43a...v1.0.0)
|
|
|
|
|
|
2015-08-25 00:51:46 +08:00
|
|
|
## License
|
|
|
|
|
|
|
|
|
|
MIT
|
