---
name: "nut-recorder"
section: "8"
platform: "linux"
package: "nut"
version: "2.8.5-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/nut-recorder"
---

# nut-recorder(8)

Utility to record device status and values changes

## NAME

nut-recorder - Utility to record device status and values changes

## SYNOPSIS

**nut-recorder** *device-name* \[output-file\] \[interval\]

## DESCRIPTION

**nut-recorder** is an utility to record sequences from running devices (such as power failures, or any other value changes) from [**upsd**(8)](/upsd/8.md) data server, and dump it in a .seq format.

The .seq file can then be used by the [**dummy-ups**(8)](/dummy-ups/8.md) driver to replay the sequence.

## OPTIONS

*device-name*

Record the changes of this device. The format for this option is *devname\[@hostname\[:port\]\]*. The default hostname is "localhost".

*output-file*

Optional. Data will be saved to this file. The default is *dummy-device.seq*.

*interval*

Optional. The status of the device will be checked every *interval*. The default is 5 seconds.

## EXAMPLES

To record data from *ups1@host1* every 10 seconds:

```
:; nut-recorder ups1@host1' ups1-output.seq 10
. . .
battery.charge: 100.0
battery.voltage: 13.9
battery.voltage.nominal: 13.6
ups.status: OL
. . .
battery.charge: 90.0
ups.status: OB
. . .
```

You can then define a dummy device in [**ups.conf**(5)](/ups.conf/5.md):

```
[ups-test]
        driver = dummy-ups
        port = ups1-output.seq
```

## AUTHOR

Arnaud Quette

## SEE ALSO

### The dummy-ups driver:

[**dummy-ups**(8)](/dummy-ups/8.md)

### The logging daemon:

[**upslog**(8)](/upslog/8.md)

### Internet resources:

The NUT (Network UPS Tools) home page: https://www.networkupstools.org/historic/v2.8.5/