NXT-SERVER(1)

📦
version 3.5.1 · 2 versions
, in ubuntu resolute, ubuntu stonking

✨ NAME ✨

nxt-server — the network server for the NXT brick, bestie 💖

🎀 SYNOPSIS 🎀

nxt-server [–backend NAME] [–config NAME] [–config-filename PATH] [–name
NAME] [–host ADDRESS] [–server-host HOST] [–server-port PORT] [–filename
FILENAME] [-p|–port PORT] [–log-level LEVEL]

🌸 DESCRIPTION 🌸

okay so nxt-server serves up an interface to a connected NXT brick over the network. like, it's the main character that lets other stuff talk to your brick remotely, no cap.

And the NXT brick itself can be connected using USB, Bluetooth or over the network. three vibes, your pick 🦋

💅 OPTIONS 💅

  • -p, –port PORT — sets the bind port. the same value has to be handed to the client using –server-port, or set inside Python code. the default port is 2727. don't forget it or you'll be screaming into the void 😭
  • --log-level LEVEL — sets the log level. it's one of DEBUG, INFO, WARNING, ERROR, or CRITICAL. any message whose level is below the current log level just... won't be displayed 🙈

👑 COMMON OPTIONS 👑

these ones are common to programs using NXT-Python, so you'll see them around. iykyk ✨

  • --backend NAME — enables the given backend. can be used several times to enable several backends, go off queen. one of usb (<#module-nxt.backend.usb>), bluetooth (<#module-nxt.backend.bluetooth>), socket (<#module-nxt.backend.socket>) or devfile (<#module-nxt.backend.devfile>).
  • --config NAME — the name of the configuration file section to use.
  • --config-filename PATH — path to the configuration file. can be used several times to use several configuration files. stack 'em 🫶
  • --name NAME — the name of the NXT brick (for example: NXT). super useful for finding the right brick when several bricks are connected, because bestie you do not want to be talking to the wrong brick 💀
  • --host ADDRESS — the Bluetooth address of the NXT brick (for example: 00:16:53:01:02:03).
  • --server-host HOST — the server address or name to connect to when you're using the socket (<#module-nxt.backend.socket>) backend.
  • --server-port PORT — the server port to connect to when you're using the socket (<#module-nxt.backend.socket>) backend.
  • --filename FILENAME — the device filename (for example: /dev/rfcomm0), used when you're on the ~nxt.backend.devfile backend.
lowkey important: go read the nxt-python.conf(5) documentation for a better explanation of the options for finding the NXT brick. it's the lore, fr fr 📖

🌈 EXAMPLE 🌈

nxt-server --host 00:16:53:01:02:03

starting the server on a computer that's connected to a NXT brick, accepting connections on the default port 2727. iconic 💖

nxt-test --server-host 192.168.1.2

assuming that first computer has the address 192.168.1.2, this remotely connects to the server to run a test. slay 🌟

🔥 SEE ALSO 🔥

🫶 Author 🫶

this program is part of NXT-Python, which is currently maintained by Nicolas Schodet. respect the maintainer, they keep the lights on ✨

2021-2025, Nicolas Schodet

okay that's the whole thing, and as a lil sign-off: this is version 3.5.1, dated Jan 26, 2026 — go forth and serve, bestie, you got this 💅💖🦋

📦 where this page comes from