soju/README.md

# soju

[![builds.sr.ht status](https://builds.sr.ht/~emersion/soju/.build.yml.svg)](https://builds.sr.ht/~emersion/soju/.build.yml?)

A user-friendly IRC bouncer.

- Multi-user
- Support multiple clients for a single user, with proper backlog
  synchronization
- Support connecting to multiple upstream servers via a single IRC connection
  to the bouncer

## Usage

    go run ./cmd/sojuctl create-user <username>
    go run ./cmd/soju -listen irc+insecure://127.0.0.1:6667

Then connect with username `<username>/chat.freenode.net` and join `#soju`.

See the man page at `doc/soju.1.scd` for more information.

## Contributing

Send patches on the [mailing list] or on [GitHub], report bugs on the
[issue tracker]. Discuss in #soju on Freenode.

## License

AGPLv3, see LICENSE.

Copyright (C) 2020 Simon Ser

[mailing list]: https://lists.sr.ht/~emersion/public-inbox
[GitHub]: https://github.com/emersion/soju
[issue tracker]: https://todo.sr.ht/~emersion/soju
Rename project to soju 2020-03-13 17:13:03 +00:00			`# soju`
Add LICENSE and README.md 2020-02-04 09:50:28 +00:00
readme: add CI badge 2020-05-01 19:58:29 +00:00			`[![builds.sr.ht status](https://builds.sr.ht/~emersion/soju/.build.yml.svg)](https://builds.sr.ht/~emersion/soju/.build.yml?)`

readme: add some high-level goals, add contributing links 2020-02-17 11:19:27 +00:00			`A user-friendly IRC bouncer.`

			`- Multi-user`
			`- Support multiple clients for a single user, with proper backlog`
			`synchronization`
			`- Support connecting to multiple upstream servers via a single IRC connection`
			`to the bouncer`

readme: add instructions to initialize database 2020-03-04 17:27:33 +00:00			`## Usage`

Strip client & network name from username 2020-03-16 08:32:18 +00:00			`go run ./cmd/sojuctl create-user <username>`
Allow multiple listeners, default to ircs Users can now specify multiple "listen" directives in their configuration file. If -listen is specified on the CLI, it's added to the list of listeners. Listeners are now parsed as URLs. If the scheme is missing "ircs" is assumed. URLs allow to enable/disable TLS on a per-listener basis and will be used for Unix sockets too. The default listening address is changed from irc+insecure://:6667 to ircs://:6697. This avoids setting up an insecure listener opened to everybody. 2020-06-04 18:10:17 +00:00			`go run ./cmd/soju -listen irc+insecure://127.0.0.1:6667`
readme: add instructions to initialize database 2020-03-04 17:27:33 +00:00
readme: advise connecting with "<username>/<network>" This matches znc's behavior and is more consistent with the multiple-upstream mode (where channels and nicks are suffixed with "/<network>" as well). 2020-03-31 16:41:14 +00:00			Then connect with username `<username>/chat.freenode.net` and join `#soju`.
Auto-save IRC networks 2020-03-12 20:28:09 +00:00
readme: fix ref to manpage 2020-04-16 16:55:21 +00:00			See the man page at `doc/soju.1.scd` for more information.
readme: add ref to man page, add link to GitHub repo 2020-03-19 13:33:49 +00:00
readme: add some high-level goals, add contributing links 2020-02-17 11:19:27 +00:00			`## Contributing`

readme: add ref to man page, add link to GitHub repo 2020-03-19 13:33:49 +00:00			`Send patches on the [mailing list] or on [GitHub], report bugs on the`
Fix deadlocks in single-upstream mode 2020-03-20 09:42:17 +00:00			`[issue tracker]. Discuss in #soju on Freenode.`
Add LICENSE and README.md 2020-02-04 09:50:28 +00:00
			`## License`

Switch license to AGPLv3 2020-02-07 16:41:51 +00:00			`AGPLv3, see LICENSE.`

			`Copyright (C) 2020 Simon Ser`
readme: add some high-level goals, add contributing links 2020-02-17 11:19:27 +00:00
			`[mailing list]: https://lists.sr.ht/~emersion/public-inbox`
readme: add ref to man page, add link to GitHub repo 2020-03-19 13:33:49 +00:00			`[GitHub]: https://github.com/emersion/soju`
Rename project to soju 2020-03-13 17:13:03 +00:00			`[issue tracker]: https://todo.sr.ht/~emersion/soju`