2020-06-10 21:00:50 +00:00
|
|
|
# [soju]
|
2020-02-04 09:50:28 +00:00
|
|
|
|
2022-04-28 12:12:31 +00:00
|
|
|
[](https://builds.sr.ht/~emersion/soju/commits/master?)
|
2020-05-01 19:58:29 +00:00
|
|
|
|
2022-06-27 12:30:28 +00:00
|
|
|
soju is a user-friendly IRC bouncer. soju connects to upstream IRC servers on
|
|
|
|
|
behalf of the user to provide extra functionality. soju supports many features
|
|
|
|
|
such as multiple users, numerous [IRCv3] extensions, chat history playback and
|
|
|
|
|
detached channels. It is well-suited for both small and large deployments.
|
2020-02-17 11:19:27 +00:00
|
|
|
|
2020-03-04 17:27:33 +00:00
|
|
|
## Usage
|
|
|
|
|
|
2021-05-21 22:01:06 +00:00
|
|
|
* [Getting started]
|
|
|
|
|
* [Man page]
|
2020-06-12 12:06:15 +00:00
|
|
|
|
2021-04-19 14:35:18 +00:00
|
|
|
## Building and installing
|
2020-06-12 12:06:15 +00:00
|
|
|
|
2021-06-24 19:32:54 +00:00
|
|
|
Dependencies:
|
|
|
|
|
|
|
|
|
|
- Go
|
2022-02-08 15:10:19 +00:00
|
|
|
- BSD or GNU make
|
2022-09-11 11:57:00 +00:00
|
|
|
- a C89 compiler (optional, for SQLite)
|
2021-06-24 19:32:54 +00:00
|
|
|
- scdoc (optional, for man pages)
|
|
|
|
|
|
2021-04-19 14:35:18 +00:00
|
|
|
For end users, a `Makefile` is provided:
|
|
|
|
|
|
|
|
|
|
make
|
|
|
|
|
sudo make install
|
|
|
|
|
|
|
|
|
|
For development, you can use `go run ./cmd/soju` as usual.
|
2020-03-19 13:33:49 +00:00
|
|
|
|
2022-09-11 11:57:00 +00:00
|
|
|
To link with the system libsqlite3, set `GOFLAGS="-tags=libsqlite3"`. To disable
|
2023-02-22 20:12:22 +00:00
|
|
|
SQLite support, set `GOFLAGS="-tags=nosqlite"`. To use an alternative SQLite
|
|
|
|
|
library that does not require CGO, set `GOFLAGS="-tags=moderncsqlite"`. To
|
|
|
|
|
build with PAM authentication support, set `GOFLAGS="-tags=pam"`.
|
2022-09-26 17:21:06 +00:00
|
|
|
|
2020-02-17 11:19:27 +00:00
|
|
|
## Contributing
|
|
|
|
|
|
2020-03-19 13:33:49 +00:00
|
|
|
Send patches on the [mailing list] or on [GitHub], report bugs on the
|
2021-05-21 22:04:22 +00:00
|
|
|
[issue tracker]. Discuss in [#soju on Libera Chat][IRC channel].
|
2020-02-04 09:50:28 +00:00
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
2020-02-07 16:41:51 +00:00
|
|
|
AGPLv3, see LICENSE.
|
|
|
|
|
|
2020-06-12 12:37:43 +00:00
|
|
|
Copyright (C) 2020 The soju Contributors
|
2020-02-17 11:19:27 +00:00
|
|
|
|
2020-06-10 21:00:50 +00:00
|
|
|
[soju]: https://soju.im
|
2021-05-21 22:01:06 +00:00
|
|
|
[Getting started]: doc/getting-started.md
|
2021-05-23 19:41:01 +00:00
|
|
|
[Man page]: https://soju.im/doc/soju.1.html
|
2020-07-24 07:49:54 +00:00
|
|
|
[mailing list]: https://lists.sr.ht/~emersion/soju-dev
|
2020-03-19 13:33:49 +00:00
|
|
|
[GitHub]: https://github.com/emersion/soju
|
2020-03-13 17:13:03 +00:00
|
|
|
[issue tracker]: https://todo.sr.ht/~emersion/soju
|
2021-05-21 22:04:22 +00:00
|
|
|
[IRC channel]: ircs://irc.libera.chat/#soju
|
2022-06-27 12:30:28 +00:00
|
|
|
[IRCv3]: https://ircv3.net/
|
