retr0chat telnet server
Go to file
ed 2950cfc254 v1.1.9 2021-09-02 23:20:34 +02:00
.vscode workaround powershell quirks 2020-12-22 17:20:28 +01:00
bin support ironpython + jython 2020-01-20 04:16:26 +00:00
clients workaround powershell quirks 2020-12-22 17:20:28 +01:00
docs v1.1.9 2021-09-02 23:20:34 +02:00
r0c v1.1.9 2021-09-02 23:20:34 +02:00
scripts more backporting from copyparty 2021-09-02 23:15:14 +02:00
test optimize 2021-07-08 22:54:32 +02:00
.editorconfig this thing broke stuff 2018-01-08 23:21:30 +01:00
.gitattributes workaround powershell quirks 2020-12-22 17:20:28 +01:00
.gitignore ironpython support (sufficiently cursed) 2020-12-22 23:15:50 +01:00
LICENSE Initial commit 2018-01-07 06:53:56 +01:00
README.md v1.1.8 2020-12-22 23:30:34 +01:00
r0c.sublime-project fix tab size 2018-01-07 21:03:05 +01:00
setup.py v1.1.9 2021-09-02 23:20:34 +02:00
start-r0c.bat windows fixes 2020-01-20 01:42:02 +00:00
start-r0c.ps1 windows fixes 2020-01-20 01:42:02 +00:00
start-r0c.sh cleanup 2020-01-19 19:06:16 +00:00

README.md

r0c telnet server

screenshot of telnet connected to a r0c server

  • download the latest release (standalone): r0c.py

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 is no longer spammy as of windows 10.0.15063 (win10 1703 / LTSC)

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