NXT-SCREENSHOT(1)

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

👑 NAME 👑

nxt-screenshot — bestie, it's the screen capture utility for the NXT brick, and it lives in the NXT-Python world 💖

📸 SYNOPSIS 📸

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

🌸 DESCRIPTION 🌸

okay so here's the whole vibe: nxt-screenshot takes a capture of a connected NXT brick and writes that captured image straight into a FILE. yes, screenshotting your little robot bestie. iconic behavior.

Your NXT brick can be connected via USB, Bluetooth, or over the network — pick your fighter, all three are valid 🫶

And the image formats?? A wide range of them is supported, thanks to the Python Imaging Library. it's giving versatile. it's giving ✨choices✨.

💅 OPTIONS 💅

  • FILE — the filename you want the captured image written to. that's the destination, bestie, the place the pic goes.
  • --log-level LEVEL — sets the log level. one of DEBUG, INFO, WARNING, ERROR, or CRITICAL. no cap: any message whose level is below the current log level will not be displayed. so if you crank it up, the chatty stuff gets left on read 🔇

🧚 COMMON OPTIONS 🧚

these options are common to programs using NXT-Python. shared lore, iykyk 💜

  • --backend NAME — enables a given backend. can be used several times to enable several backends (yes, stacking, we love to see it). one of usb, bluetooth, socket or 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. more files, more power 🌈
  • --name NAME — the name of the NXT brick (for example: NXT). super useful when you've got several bricks connected and you need to find the right one. finding your main character brick among the crowd, fr fr 👑
  • --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 using the socket backend.
  • --server-port PORT — the server port to connect to when using the socket backend.
  • --filename FILENAME — the device filename (for example: /dev/rfcomm0), used when you're on the ~nxt.backend.devfile backend.
💡 heads up bestie: go read the nxt-python.conf(5) documentation for a better explanation of the options to find the NXT brick. it explains the whole finding-your-brick situation way better.

🔥 EXAMPLE 🔥

nxt-screenshot --host 00:16:53:01:02:03 capture.png

Capture screen from connected NXT using its Bluetooth address. Save the result image in capture.png.

literally one line and you're done. ate 🍓

🦋 SEE ALSO 🦋

💖 Author 💖

This program is part of NXT-Python, which is currently maintained by Nicolas Schodet. thank you for your service 🫶

2021-2025, Nicolas Schodet

and that's the whole page, bestie!! this little manual is version 3.5.1, dated Jan 26, 2026, and it's from NXT-Python. go forth and screenshot your brick 💅✨

📦 where this page comes from