---
name: "nxt-push"
section: "1"
platform: "linux"
package: "python3-nxt"
version: "3.5.1-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/nxt-push"
---

# nxt-push(1)

Push files to a NXT brick

## NAME

nxt-push - Push files to a NXT brick

## SYNOPSIS

**nxt-push** \[**–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-push** uploads files to a connected NXT brick file system.

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

## OPTIONS

- ***FILE*…**

  Names of files to send to the NXT brick.

- **--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)](/nxt-python.conf/5.md)** documentation for better explanation of the options to find the NXT brick.

## EXAMPLE

- **nxt-push --host 00:16:53:01:02:03 MotorControl22.rxe**

  Sends the **MotorControl22.rxe** file to a connected NXT using its Bluetooth address to find it.

## SEE ALSO

**[nxt-python.conf(5)](/nxt-python.conf/5.md)**

NXT-Python documentation \<*https://ni.srht.site/nxt-python/latest/*\>

## AUTHOR

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

## COPYRIGHT

2021-2025, Nicolas Schodet