https://github.com/cshaa/irc-signal-bridge

A bridge between IRC and Signal
https://github.com/cshaa/irc-signal-bridge

Last synced: 9 days ago
JSON representation

A bridge between IRC and Signal

• Host: GitHub
• URL: https://github.com/cshaa/irc-signal-bridge
• Owner: cshaa
• License: cc0-1.0
• Created: 2024-09-04T00:02:32.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2024-10-12T23:14:17.000Z (4 months ago)
• Last Synced: 2025-01-17T21:12:53.834Z (10 days ago)
• Language: TypeScript
• Size: 26.4 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# irc-signal-bridge

Install [signal-cli](https://github.com/AsamK/signal-cli/) and register an

account with it. Use a different account than the one you use for your regular

Signal activity. Test that you can send and receive messages. Add the bot into a

new group, then use `signal-cli listGroups` to get the group ID.

Install [just](https://github.com/casey/just?tab=readme-ov-file#readme) and

[Deno](https://deno.com/). Create the following config file:

```jsonc

{

  "$schema": "./schema.json",

  "accountNumber": "+123456789", // your Signal phone number

  "ircServer": "irc.libera.chat", // IRC server

  "ircNick": "mybot^signal", // the nick your bot should use on IRC

  "ircPassword": "pass1!", // optional IRC password for the nick

  "ircTunnels": [

    {

      "ircChannel": "#mychan", // name of an IRC channel

      "groupId": "asdfASDF123=" // id of a Signal group as listed by `signal-cli listGroups`

    }

  ]

}

```

Then launch the bridge using `just run config.json`.

## Docker

To use with Docker, first either set up `signal-cli`...

```sh

# link it to an existing account

signal-cli link # use `signal-cli addDevice --uri ...` on the other device

# or register a new account

signal-cli register ...

```

... or copy a `signal-cli` setup from a different machine to your

`~/.local/share/signal-cli` folder. Then, build & start the container via:

```sh

just docker-run

```

You can stop it via `just docker-stop`.