marvin

A simple and modular IRC bot

git clone https://git.8pit.net/marvin.git

 1marvin - A modular irc bot written in go.
 2
 3INSTALLATION
 4	To install, run `go get -u github.com/nmeum/marvin`.
 5
 6USAGE
 7	marvin accepts three command line flags: '-h', '-v', and '-c'.
 8
 9	When '-h' is used marvin writes the help message to stderr and
10	exits with exit status 2. With '-v' marvin writes everything it
11	reads from the TCP socket to stdout. The last flag '-c' allows
12	the caller to specify the path of a configuration file described
13	in greater detail below.
14
15CONFIGURATION
16	marvin is configured using a small json file. There is a core
17	configuration file which can be specified with the '-c' command
18	line flag and in addition to that there is a json configuration
19	file for each standalone module.
20
21	The core configuration file allows you to specify mandatory
22	information for the bot, e.g. which network to connect to, which
23	username to use, which channels to join, et cetera. The
24	available configuration variables are documented in the `config
25	struct` defined in the file `config.go`.
26
27MODULES
28	marvin is a very modular irc bot. Each module has its own
29	configuration file and can be enabled or disabled. Most modules
30	are enabled by default.
31
32	To enable a module you have to add its module initialization
33	function to the `moduleInits` slice defined in the file
34	`modules.go`. The module initialization function is mostly
35	called `Init`. To add it to the array you need to import it
36	first of cause.
37
38	Modules are configured in the specified `configs` directory
39	which defaults to `$HOME/marvin`. You can specify a different
40	configuration directory in the core configuration file. The
41	available configuration variables are defined in the individual
42	module, please consult the code to get an overview of the
43	available options.
44
45LICENSE
46	This program is free software: you can redistribute it and/or
47	modify it under the terms of the GNU Affero General Public
48	License as published by the Free Software Foundation, either
49	version 3 of the License, or (at your option) any later version.
50
51	This program is distributed in the hope that it will be useful,
52	but WITHOUT ANY WARRANTY; without even the implied warranty of
53	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
54	Affero General Public License for more details.
55
56	You should have received a copy of the GNU Affero General Public
57	License along with this program. If not, see
58	<http://www.gnu.org/licenses/>.