~acdw/mrgrctrnl

ERMAHGERD MRGRC TRNLS

clone

read-only
https://git.sr.ht/~acdw/mrgrctrnl
read/write
git@git.sr.ht:~acdw/mrgrctrnl

You can also use your local clone with git send-email.

#MERGIRC TURNEL

a configurable ssh tunneler that I use for IRC

this is a small shell script that'll set up an IRC tunnel between hosts that you can configure using a file.

When you run mrgrctrnl, it'll automagically tunnel the hosts and let you sign into IRC on your own computer. Yay!

#Why

I like running weechat from my computer but have it connected to others. For example, I like to stay connected to tilde.town's IRC from my laptop. According to instructions from ~nick, you can just set up an SSH tunnel. But I have multiple servers! So I made this script.

#Why the stupid name?

gersbermps meme edited so she's holding terminals

#Config file

The config file is located at $XDG_CONFIG_HOME/mrgrctrnl/config. Each row is an ssh tunnel to run, with whitespace-separeted fields. A # begins a comment that goes to the end of the line.

# machine    user local           remote          key               rest
example.com  ted  localhost:6989  localhost:6667  /path/to/key.pub  [..]

machine, user, local, and remote are required. key and rest are optional.

rest is more command-line options, if there's anything else you'd like to include in the command.

#Usage

mrgrctrnl: make magic ssh tunnels
usage:	mrgrctrnl [-h] [-k]
	mrgrctrnl [-n] [-c CONF | -s SSH]

options:
	-h	show this help
	-k	kill all processes and exit
	-r	restart mrgrctrnl
	-n	do a dry run: just print what would happen
	-c CONFIG	use a different CONFIG file instead of
			$XDG_CONFIG_HOME/mrgrctrnl/config
	-s CMDLINE	directly input an ssh CMDLINE --
			don't load the config file.

#Requirements

  • POSIX environment
  • ssh

#Install

# make install

#Uninstall

# make uninstall