NAME

nxt-screenshot - Capture screen utility for the NXT brick

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

nxt-screenshot takes a capture of a connected NXT brick and write the captured image to a FILE.

The NXT brick can be connected using USB, Bluetooth or over the network.

A wide range of image formats is supported, thanks to the Python Imaging Library.

OPTIONS

FILE: Filename to write captured image to.

--log-level LEVEL: Set the log level. One of DEBUG, INFO, WARNING, ERROR, or CRITICAL. Messages whose level is below the current log level will not be displayed.

COMMON OPTIONS

Those options are common to programs using NXT-Python.

--backend NAME: Enable given backend. Can be used several times to enable several backends. One of usb, bluetooth, socket or devfile.
--config NAME: Name of configuration file section to use.
--config-filename PATH: Path to configuration file. Can be used several times to use several configuration files.
--name NAME: Name of NXT brick (for example: NXT). Useful to find the right brick if several bricks are connected.
--host ADDRESS: Bluetooth address of the NXT brick (for example: 00:16:53:01:02:03).
--server-host HOST: Server address or name to connect to when using socket backend.
--server-port PORT: Server port to connect to when using socket backend.
--filename FILENAME: Device filename (for example: /dev/rfcomm0), when using ~nxt.backend.devfile backend.

See nxt-python.conf(5) documentation for better explanation of the options to find the NXT brick.

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.

AUTHOR

This program is part of NXT-Python which is currently maintained by Nicolas Schodet.

COPYRIGHT

2021-2025, Nicolas Schodet

January 12, 2025

3.5.1