Skip to main content

Ultra simple command line serial client.

Project description


PyPI PyPI: supported Python Build status Code style

An ultra simple command line serial client.

Getting started

Install it using

pip install nanocom

and connect to your serial port using

nanocom --port /dev/ttyUSB0 --baudrate 115200


Running nanocom --help will display all the cli options. The following options are available

-p, --port

The path to the serial port. On macOS it will be something like /dev/tty.usbserial and on Linux probably something like /dev/ttyUSB0. This option is required.

-b, --baudrate

The baudrate of the serial port. This is typically something like 9600 or 115200 but any integer is accepted. If not given, this option defaults to 115200.

-m, --map

A character map, key, value pair, such that when the key character is entered into the client the value string will be sent instead. The value string can be multiple characters and multiple character maps are allowed. An example would be if you wanted to send a carriage return and a new line when a new line character was given you would use --map "\n" "\r\n".

-c, --exit-char

The exit character where the Ctrl key and this character are used to exit the client. The character must be one of A to Z, [, \, ], or _. For example if you gave the option --exit-char \\ then the client would exit when you pressed Ctrl + \.


This project is licensed under the MIT license (LICENSE or

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nanocom-2.0.1.tar.gz (4.8 kB view hashes)

Uploaded source

Built Distribution

nanocom-2.0.1-py3-none-any.whl (5.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page