Add first version of docs/help/setup.md and link to it in README.md
This commit is contained in:
parent
81e9548827
commit
d14eaa3148
2 changed files with 46 additions and 2 deletions
|
@ -4,8 +4,8 @@ Python3 event-driven modular IRC bot!
|
||||||
## Dependencies
|
## Dependencies
|
||||||
[BeautifulSoup4](https://pypi.python.org/pypi/beautifulsoup4), [requests](https://pypi.org/project/requests/), [scrypt](https://pypi.python.org/pypi/scrypt), [suds](https://pypi.python.org/pypi/suds-jurko) and [twitter](https://pypi.python.org/pypi/twitter). Use `pip3 install -r requirements.txt` to install them all at once.
|
[BeautifulSoup4](https://pypi.python.org/pypi/beautifulsoup4), [requests](https://pypi.org/project/requests/), [scrypt](https://pypi.python.org/pypi/scrypt), [suds](https://pypi.python.org/pypi/suds-jurko) and [twitter](https://pypi.python.org/pypi/twitter). Use `pip3 install -r requirements.txt` to install them all at once.
|
||||||
|
|
||||||
## Configurating
|
## Setup
|
||||||
To get BitBot off the ground, there's some API-keys and the like in bot.conf.example. move it to bot.conf, fill in the API keys you want (and remove the ones you don't want - this will automatically disable the modules that rely on them.)
|
See [docs/help/setup.md](docs/help/setup.md).
|
||||||
|
|
||||||
Run `./start.py` to run the bot with default settings (`--help` for more information) which will ask you for server details the first time you run it (run it again after filling out that information to get the bot going.) If you need to add more servers, use `./start.py --add-server`.
|
Run `./start.py` to run the bot with default settings (`--help` for more information) which will ask you for server details the first time you run it (run it again after filling out that information to get the bot going.) If you need to add more servers, use `./start.py --add-server`.
|
||||||
|
|
||||||
|
|
44
docs/help/setup.md
Normal file
44
docs/help/setup.md
Normal file
|
@ -0,0 +1,44 @@
|
||||||
|
## Setting up BitBot
|
||||||
|
|
||||||
|
* Move `bot.conf.example` to `bot.conf` and fill in the config options you care about. Ones blank or removed will disable relevant functionality.
|
||||||
|
* Run `./start.py -a` to add a server.
|
||||||
|
* Run `./start.py -m permissions -M master-password` to get the master admin password (needed to add regular admin accounts)
|
||||||
|
* Run `./start.py` to start the bot.
|
||||||
|
* Join `#bitbot` on a server with the bot (or invite it to another channel)
|
||||||
|
* `/msg <bot> register <password here>` to register your nickname with the bot
|
||||||
|
* `/msg <bot> masterlogin <master admin password>` to login as master admin
|
||||||
|
* `/msg <bot> givepermission <your nickname> *` to give your account admin permissions
|
||||||
|
|
||||||
|
### Configure client TLS certificate
|
||||||
|
|
||||||
|
Generate a TLS keypair and point `bot.conf`'s `tls-key` to the private key and `tls-certificate` to the public key.
|
||||||
|
|
||||||
|
### Configure SASL
|
||||||
|
|
||||||
|
Configure the bot to use SASL to authenticate (usually used for `NickServ` identification)
|
||||||
|
|
||||||
|
`EXTERNAL` usually mean client TLS certificate authentication; `USERPASS` is a BitBot-specific term that selects the strongest user/password algorithm.
|
||||||
|
|
||||||
|
> /msg <bot> config server sasl userpass <username>:<password>
|
||||||
|
> /msg <bot> config server sasl plain <username>:<password>
|
||||||
|
> /msg <bot> config server sasl scram-sha-1 <username>:<password>
|
||||||
|
> /msg <bot> config server sasl scram-sha-256 <username>:<password>
|
||||||
|
> /msg <bot> config server sasl external
|
||||||
|
|
||||||
|
### Commands on-connect
|
||||||
|
|
||||||
|
The `perform.py` module allows the bot to execute a saved list of raw IRC commands against a server it's connecting to. Use `/msg <bot> performadd <raw irc command>` to add to the current server's list of commands (`%nick%` in a raw command will be replaced with the bot's current nick.)
|
||||||
|
|
||||||
|
### Config options
|
||||||
|
|
||||||
|
#### View available config options
|
||||||
|
|
||||||
|
> /msg <bot> config bot|server|channel|user
|
||||||
|
|
||||||
|
#### Set config options
|
||||||
|
|
||||||
|
> /msg <bot> config bot <setting> <value>
|
||||||
|
> /msg <bot> config server <setting> <value>
|
||||||
|
> /msg <bot> config channel:#bitbot <setting> <value>
|
||||||
|
> /msg <bot> config user <setting> <value>
|
||||||
|
> /msg <bot> config user:other_user <setting> <value>
|
Loading…
Reference in a new issue