Skip to main content

NAD Serial: Python library to control NAD amplifiers, tuners and receivers over serial (RS-232) or Ethernet (telnet)

Python GitHub Release License Maintainer
GitHub Sponsors PayPal BuyMeCoffee Patreon

Introduction

NAD Serial lets you control NAD amplifiers, tuners and receivers over serial (RS-232) or Ethernet (telnet).

Features

  • Asynchronous, built on serialx.
  • Connects over serial (RS-232) or Ethernet (telnet).
  • Detects the device model and build and loads the matching configuration.
  • Detects the device type for models without configuration.
  • Validates settings and values against the configuration before sending them.
  • Read, set, increment and decrement any supported setting.
  • Reads the source names on supported devices.
  • Supports zones on multi-zone amplifiers and receivers.

Supported protocol

If your device follows the second generation NAD protocol (v2.x), it is supported by NAD Serial. This protocol is used by NAD amplifiers, tuners and receivers with a serial (RS-232) or Ethernet port.

The binary protocol that some NAD devices, like the D-series, use on TCP port 50001 is not supported.

The serial and Ethernet commands are identical. All communication is plain ASCII text. Every command and response has the format:

<Prefix>.<Variable><Operator><Value>

The prefix groups related variables, e.g. Main, Zone2, Source1 or Tuner. Prefix and variable together name a setting, e.g. Main.Volume. Every message is terminated by a carriage return and/or line feed.

Operator Meaning Example
? Query the value Main.Volume?
= Set the value Main.Volume=-30
+ Increment or cycle to the next value Main.Volume+
- Decrement or cycle to the previous value Main.Volume-

The device responds with the = operator and the resulting value, e.g. Main.Volume=-30.

Supported devices

The following devices are known to work:

Receivers:

  • T755
  • T757

Additionally, NAD Serial includes untested configuration files for the following devices:

Receivers:

  • T758
  • T765
  • T775
  • T777
  • T778
  • T785
  • T787

Surround preamplifiers:

  • M15HD
  • M17
  • T175
  • T187

Amplifiers:

  • C328
  • C338
  • C356
  • C368
  • C388

Tuners:

  • C427

Other NAD devices that use the supported protocol should work too, with a basic set of settings: power, model, version, volume, mute and source.

Connecting

USB to serial adapter

If your device has a serial port, use a USB to serial adapter to connect it. See the documentation of your device for the location of the serial port and how to wire it.

The serial port uses 115200 baud, 8 data bits, no parity, 1 stop bit (8N1) and no flow control.

Ethernet

If your device has an Ethernet port use a network cable to connect your device to a router.

Use socket://<ip address>:23 as the URL.

Serial to Ethernet/WiFi bridge

A serial to Ethernet/WiFi bridge is useful when the device is not close to your computer. Build your own using an ESP32 and esp-link, or buy an off-the-shelf product. Configure the bridge for 115200 baud, 8N1.

Use socket://<ip address>:<port> or rfc2217://<ip address>:<port> as the URL, depending on which protocol the bridge supports.

ESPHome Serial Proxy

Install ESPHome Serial Proxy on an ESP32 and use esphome://<ip address>:<port>/?port_name=<port name> as the URL.

Installation

Install NAD Serial with pip:

pip3 install nad_serial

Contribution and appreciation

Do you enjoy using NAD Serial? You can contribute or show your appreciation, in the following ways.

Contribute your device model

Is your device supported by NAD Serial but not listed under Supported devices? Let me know your device model so I can improve the overview of supported devices.

Is there no configuration file for your device model yet, or is the configuration file incomplete or incorrect? Create a configuration file and submit a pull request with the new or updated configuration file.

Star this GitHub page

Help other NAD device users find NAD Serial by starring this GitHub page. Click ⭐ Star on the top right of the GitHub page.

Support my work

Please consider supporting my work through one of the following platforms. Your contribution is greatly appreciated and keeps me motivated:

GitHub Sponsors PayPal BuyMeCoffee Patreon

Hire me

If you're in need of a freelance Python developer for your project please contact me. You can find my email address on my GitHub profile.

Metadata

Release files for nad-serial 0.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nad-serial 0.0.1
File Size Uploaded Provenance Actions
nad_serial-0.0.1.tar.gz 78.8 kB With provenance Details for nad_serial-0.0.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for nad-serial 0.0.1
File Interpreter ABI Platform Actions
nad_serial-0.0.1-py3-none-any.whl Python 3 none any Details for nad_serial-0.0.1-py3-none-any.whl

Total release size: 161.5 kB

Release files / nad_serial-0.0.1.tar.gz

Download URL nad_serial-0.0.1.tar.gz
Size 78.8 kB
Tags Source
SHA-256 checksum
How to use checksums
a0ddf08c3ca5d22bc42108ac16e7750084407a56909302146627bb342e6f7f84
BLAKE2b-256 checksum
How to use checksums
48862c8cfea1bc820fa959d9d22efd608a4d9aa6283077f4a72b1924a73f99e9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 27, 2026.

Transparency log

Release files / nad_serial-0.0.1-py3-none-any.whl

Download URL nad_serial-0.0.1-py3-none-any.whl
Size 82.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
155c3e5243de93d29cf357dbc9e7f68a8064b5f1e59dd67a1858d97c3eba3299
BLAKE2b-256 checksum
How to use checksums
69c19d9a1efcf7019923e0cb5597ada24e250263a264423eee5eb569547405ac
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 27, 2026.

Transparency log

Security for nad-serial 0.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for nad_serial-0.0.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 27, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page