RCON(1)

💅 RCON(1) — like, the rcon page, bestie ✨

okay so real talk: this is rcon, from the USER COMMANDS section of your manual, and it's literally the command line source rcon client you've been looking for. no cap. let's get into it 🎀

---

✨ NAME ✨

rcon — command line source rcon client 🦋

---

🌸 SYNOPSIS 🌸

rcon [options] command

---

💖 DESCRIPTION 💖

so rcon is your girl for being a command line remote console client for source game servers. iconic behavior honestly. 👑

she supports a configuration file so you can safely store your rcon passwords — yes bestie, safely, we love that for us 🔐✨

she'll execute the command you give her, or — plot twist — if you give her no command at all, she'll read a whole list of commands from standard input. main character energy fr fr 💅

---

🌈 OPTIONS 🌈

• -c, --config filename — point her at a different path for the configuration file. the default is $HOME/.rconrc 🏠
• -d, --debug — turns on debug mode. the packages she sends and receives get shown right there on your terminal. she's being transparent with you 🫶
• -h, --help — usage. the classic. the legend. 💫
• -H, --host hostname — hostname or IP address of the server 🌐
• -m, --minecraft — Minecraft compatibility mode 🟩 (yes, that Minecraft)
• -n, --nowait — don't wait for a reply from the server, just send and quit. in and out, no strings 💨
• -p, --port port — port or service name 🔌
• -P, --password password — the remote console password of the server 🔑
• -s, --server name — use this server from the configuration file 📖

---

🎀 FILES 🎀

• ~/.rconrc — the default configuration filename for rcon. that's her home 💖

---

🧚 CONFIGURATION FILE 🧚

the configuration file has to be in the key file format (which everyone commonly calls an INI file) and it must follow this schema exactly:

[myserver]
hostname = 173.43.63.111
port = 27003
password = somepass
# remove the line below if it the server is not minecraft
minecraft = true

once you've got that, you can use this server straight from the command line with the -s parameter:

rcon -s myserver status

and here's the slay part: the command line still trumps the configuration file. so this next one would override the port to 27010:

rcon -s myserver -p 27010 status

---

🦋 INTERPRETER 🦋

okay this is lowkey the coolest part — rcon can also be used as a script interpreter 🧚‍♀️ just specify the rcon binary in the she bang. lines that start with a hash sign get ignored, and every other non-empty line gets treated as a command. this script right here runs two commands:

#!/usr/bin/rcon -s myserver

# Query status
status

# List plugins
sm plugins list

---

⭐ EXAMPLES ⭐

send status to a server with a given IP, port and password:

rcon -H 173.43.63.11 -p 27003 -P somepass status

send a patch of commands to a server:

echo -e "status\nsm plugins list" | rcon -s myserver

---

💀 BUGS 💀

report bugs at https://github.com/n0la/rcon — she wants to hear from you bestie 🙈

---

👑 AUTHOR 👑

Copyright (c) 2016 Florian Stinglmayr <fstinglmayr@gmail.com> 💜

---

ngl, copyright and version stuff is the boring bit but we keep it because respect: this is version 0.5, dated September 19, 2016, living in the USER COMMANDS section, and that's the whole page 🍓

periodt. you're gonna do great. mwah 💋