Watch

mirror of https://github.com/daniel-j-h/meshcore-irc-bridge.git synced 2026-08-28 20:23:26 +01:00

Use your favorite IRC client to join the mesh

irc mesh meshcore

Python 100%

Find a file

Repository files (latest commit first)
Filename	Latest commit message	Latest commit date
daniel-j-h b19c3a44b6 Adds header image		2026-02-19 22:53:50 +01:00
.gitignore	Initial commit	2026-02-16 23:22:11 +01:00
about.png	Adds header image	2026-02-19 22:53:50 +01:00
LICENSE.md	Initial commit	2026-02-16 23:22:11 +01:00
meshcore-irc-bridge.py	Adds outgoing mesh messaging	2026-02-19 22:50:28 +01:00
README.md	Adds header image	2026-02-19 22:53:50 +01:00
requirements.in	Initial commit	2026-02-16 23:22:11 +01:00
requirements.txt	Initial commit	2026-02-16 23:22:11 +01:00

README.md

meshcore-irc-bridge

Simple IRC server bridge on top of MeshCore

Use your favorite IRC client to join the mesh

Usage

Start the bridge implementing the IRC server protocol on top of MeshCore

python meshcore-irc-bridge.py --serial /dev/serial/by-id/usb-Heltec..

Use your favorite IRC client and

Connect to irc://127.0.0.1:6667
Join the #public channel

Clients

Tested IRC clients

Setup with irssi

$ irssi

/network add meshcore -nick daniel
/server add -network meshcore -nocap -auto 127.0.0.1 6667
/channel add -auto #public meshcore

/connect meshcore

Setup with weechat

$ weechat

/server add meshcore 127.0.0.1/6667 -notls
/set irc.server.meshcore.autoconnect on
/set irc.server.meshcore.nicks daniel
/set irc.server.meshcore.autojoin #public

/connect meshcore

Limitations

Very basic features implemented against RFC 1459
Channel: Public (MeshCore) maps to #public (IRC); no other channels
Tested with a few basic IRC clients

To debug the protocol, start the bridge server with the --verbose flag.

License

Distributed under the MIT License (MIT).