retr0chat telnet server
Go to file
ed ae68ab449c black 2020-01-19 16:11:18 +00:00
.vscode vscode 2020-01-19 15:46:39 +00:00
bin refactor for pypi (nothing works) 2018-03-20 05:11:18 +01:00
clients support ancient bash 2018-02-10 20:36:32 +01:00
docs update bot list 2018-08-31 00:35:26 +02:00
r0c black 2020-01-19 16:11:18 +00:00
scripts version 1.1.4 2018-08-31 00:45:16 +02:00
test black 2020-01-19 16:11:18 +00:00
.editorconfig this thing broke stuff 2018-01-08 23:21:30 +01:00
.gitattributes add winxp screenshot 2018-01-16 20:40:05 +01:00
.gitignore vscode 2020-01-19 15:46:39 +00:00
LICENSE Initial commit 2018-01-07 06:53:56 +01:00
README.md version 1.1.3 2018-08-22 00:38:35 +02:00
r0c.sublime-project fix tab size 2018-01-07 21:03:05 +01:00
setup.py black 2020-01-19 16:11:18 +00:00
start-r0c.bat refactor for pypi (nothing works) 2018-03-20 05:11:18 +01:00
start-r0c.sh refactor for pypi (nothing works) 2018-03-20 05:11:18 +01:00

README.md

r0c telnet server

screenshot of telnet connected to a r0c server

summary

imagine being stuck on ancient gear, in the middle of nowhere, on a slow connection between machines that are even more archaic than the toaster you're trying to keep from falling apart

retr0chat is the lightweight, no-dependencies, runs-anywhere solution for when life gives you lemons

  • tries to be irssi
  • zero dependencies on python 2.6, 2.7, 3.x
  • supports telnet, netcat, /dev/tcp clients
  • fallbacks for inhumane conditions
    • linemode
    • no vt100 / ansi escape codes

windows clients

  • use putty in telnet mode
  • or the powershell client
  • or enable Telnet Client in control panel -> programs -> programs and features -> turn windows features on or off, then press WIN+R and run telnet r0c.int

putty is the best option;

  • windows-telnet has a bug (since win7) where unicode letters become unstable the more text you have on the screen (starts flickering and then disappear one by one)
  • the powershell client wastes a LOT of data (an entire kilobyte for each new message, totally unbelievable, who could possibly afford that) because powershell's scrolling is glitchy af

linux clients

most to least recommended

client example
telnet telnet r0c.int
socat socat -,raw,echo=0 tcp:r0c.int:531
bash mostly internals
netcat nc r0c.int 531

you can even exec 147<>/dev/tcp/r0c.int/531;cat<&147&while IFS= read -rn1 x;do [ -z "$x" ]&&x=$'\n';printf %s "$x">&147;done (disconnect using exec 147<&-; killall cat #sorry)

firewall rules

telnet uses port 23 by default, so on the server you'll want to port-forward 23 to 2323 (and 531 to 1531 for plaintext):

iptables -A INPUT -p tcp --dport 23 -m state --state NEW -j ACCEPT
iptables -A INPUT -p tcp --dport 531 -m state --state NEW -j ACCEPT
iptables -A INPUT -p tcp --dport 2323 -m state --state NEW -j ACCEPT
iptables -A INPUT -p tcp --dport 1531 -m state --state NEW -j ACCEPT
iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 23 -j REDIRECT --to-port 2323
iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 531 -j REDIRECT --to-port 1531

documentation

not really but there is a list of commands and a list of hotkeys