ricochet-irc

IRC interface to Ricochet-Refresh (v3.0.29)

ricochet-irc is an IRC interface to the R2: Ricochet-Refresh P2P chat network.

For an introduction to Ricochet itself, please refer to README-upstream.md.

Building

Debian GNU/Linux 12 (bookworm)

apt-get update
apt-get install -y git
apt-get install -y cmake tor build-essential \
    libprotobuf-dev protobuf-compiler libssl-dev qtbase5-dev

git clone https://github.com/wfr/ricochet-irc/
cd ricochet-irc
git submodule update --init src/extern/tor
git submodule update --init src/extern/fmt

mkdir build
cmake -S ./src -B ./build -G"Unix Makefiles" -DCMAKE_BUILD_TYPE=Debug \
  -DRICOCHET_REFRESH_INSTALL_DESKTOP=OFF -DUSE_SUBMODULE_FMT=ON \
  -DENABLE_GUI=off
cmake --build ./build -j$(nproc)

Usage

./ricochet-irc --help

Usage: ricochet-irc [options]
Anonymous peer-to-peer instant messaging, IRC gateway

Options:
  --config <config-path>    Select configuration directory.
  --host <host>             Set IRC server host.
  --i-know-what-i-am-doing  Allow --host option
  --port <port>             Set IRC server port.
  --generate-password       Generate random IRC password.
  --debug, --verbose        Verbose output
  -h, --help                Displays help on commandline options.
  --help-all                Displays help including Qt specific options.
  -v, --version             Displays version information.

IRC interface

Once you are connected to the IRC server, your client is automatically joined into a control channel #ricochet:

    @ricochet |  ___ _            _        _     ___ ___  ___       ____
    @ricochet | | _ (_)__ ___  __| |_  ___| |_  |_ _| _ \/ __| __ _|__ /
    @ricochet | |   / / _/ _ \/ _| ' \/ -_)  _|  | ||   / (__  \ V /|_ \
    @ricochet | |_|_\_\__\___/\__|_||_\___|\__| |___|_|_\\___|  \_/|___/ devbuild
    @ricochet |
    @ricochet | COMMANDS:
    @ricochet |  * help
    @ricochet |  * id                            -- print your ricochet id
    @ricochet |  * add ID NICKNAME MESSAGE       -- add a contact
    @ricochet |  * delete NICKNAME               -- delete a contact
    @ricochet |  * rename NICKNAME NEW_NICKNAME  -- rename a contact
    @ricochet |  * request list                  -- list incoming requests
    @ricochet |  * request accept ID NICKNAME    -- accept incoming request
    @ricochet |  * request reject ID             -- reject incoming request
    @ricochet |
    @ricochet | Tor status: offline
           -- | ricochet has changed topic for #ricochet to "ricochet:fdmls67o6sf7ok726y5xfrxurhknoul5vg5augtes43w2eue6eu3nbad"
    @ricochet | Tor status: ready
          --> | afriend (~afriend@ricochet:sczutjtt4vobmm2fpc5w5usz5pogrliggdzwmqhgoslvo7zph764sdqd) has joined #ricochet

Online/Offline status

ricochet-irc connects to the Ricochet network when an IRC client is attached. You will appear offline to your contacts as soon as you disconnect from the IRC server.

Changes

CHANGES.md

Miscellaneous notes

Convert Hidden Service key to Ricochet format

echo $(cut -c 33-95 hs_ed25519_secret_key | base64 -w 0)

License

GPLv3

Other

Please report bugs in the issue tracker.

Donations

If you feel like inviting me (<[email protected]>) to a coffee, ...

• Algorand: D3CI5EKC7IRLJMGV74NSKJD6CDXDGS6DT2OQZ4T6NUAB5RIZMTEM37DODI
• Monero/XMR: 4245uqJmyoWbWx7w41TL2scKrgk6MtdiYR8ffFiCenJhDx227AbqbU7enMUjwYkHv9W7K6TKZDCLTEnV8ApXih3uNP1B6B3