added readme
This commit is contained in:
46
README.md
Normal file
46
README.md
Normal file
@ -0,0 +1,46 @@
|
||||
# keybase-jitsi-bot
|
||||
A bot for Keybase that start Jitsi meetings
|
||||
|
||||
This package requires the keybase binary installed on your system, and works on linux, macOS, and Windows 10
|
||||
|
||||
#### Tested on:
|
||||
- Ubuntu Latest
|
||||
- macOS Latest
|
||||
- Windows Latest
|
||||
|
||||
## Running on the command line:
|
||||
#### Installation:
|
||||
- `git clone https://github.com/haukened/keybase-jitsi-bot.git`
|
||||
- `cd keybase-jitsi-bot`
|
||||
- `go get -u ./...`
|
||||
- `go build`
|
||||
- `go install`
|
||||
|
||||
(The typical `go install github.com/haukened/boom-bot` may or may not work due to experimental branch dependencies, and the above proceedure always works even though its longer).
|
||||
#### Running:
|
||||
```
|
||||
-debug
|
||||
enables command debugging
|
||||
```
|
||||
|
||||
#### Example:
|
||||
`jitsi-bot --debug`
|
||||
|
||||
## Running in the docker container:
|
||||
#### Pulling the container:
|
||||
|
||||
`docker pull haukeness/keybase-jitsi-bot`
|
||||
|
||||
#### Running the container:
|
||||
You need to set ENV vars instead of passing command line flags:
|
||||
|
||||
Required by keybase: (Must set all of these)
|
||||
- `KEYBASE_USERNAME=foo`
|
||||
- `KEYBASE_PAPERKEY="bar baz ..."`
|
||||
- `KEYBASE_SERVICE=1`
|
||||
|
||||
Required by this package: (Set the values you feel like, if you don't set them they won't be used)
|
||||
- `BOT_DEBUG=true`
|
||||
|
||||
#### Example:
|
||||
`docker run --name myJitsi --rm -d -e KEYBASE_USERNAME=FOO -e KEYBASE_PAPERKEY="bar baz ..." -e KEYBASE_SERVICE=1 -e BOT_DEBUG=true haukeness/keybase-jitsi-bot`
|
||||
Reference in New Issue
Block a user