qirc - small IRC-to-GTP daemon to play Go over IRC
References
| Branch | Commit | Author | Date |
|---|---|---|---|
| master | fix/improve qirc_wrapper | Sylvain Gauthier | 2021-09-13 09:05 |
qirc
qirc is a program to browse, publish and join games of Go/Weiqi/Baduk through IRC.
It uses the main channel as a game lobby to publish games (through a simple protocol over IRC text messages), and then exchanges game moves between two players using private direct messages.
It then forwards the game parameters and successive moves using the GTP protocol to a UNIX socket named qircconn in the current directory, for a graphical client to connect to it.
**It is not a graphical client. You cannot play Go with this tool alone. You need a graphical client that can connect to a UNIX domain socket, such as weiqi**
Build/install
No particular dependencies are required. You will only need make and a C compiler. Only tested on Linux but expected to work on any UNIX/POSIX system.
$ git clone https://pedantic.software/git/qirc
$ cd qirc/
$ sudo make install
How to
Type:
$ qirc <nick> <server> <channel>
To log as <nick> on the IRC server <server>, using <channel> as a lobby.
Upon successful connection, you will have a simple prompt to type commands:
> names list
to list users connected to the lobby,
> games fetch
to get a list of current open games you can join,
> games list
to display the list of games once you fetched them,
> join <gameID>
to join the game with ID <gameID>. Note that the game ID is the integer between brackets "[]" in the game's title displayed with games list.
You can create and publish a new game with:
> newgame [size=<size>] [color=black|white] [level=<level>] [rules=chinese|korean|japanese] [handicap=<n>] [komi=<k>]
All game parameters are optional, the default being:
size=19 color=black level=30kyu rules=chinese handicap=0 komi=7.5
The color refers to the color you will be playing.
Start a game
Once you have joined a game (or someone joined yours), qirc will prompt you with a message asking you to connect your client to the UNIX socket.
weiqi is such a client that can connect to a UNIX socket and behave like a GTP graphical interface. You can use the qirc_wrapper script that will automatically start weiqi (or any other client) automatically once the UNIX socket is created.