Skip to main content

A simple line based serial terminal GUI.

Project description

A simple line based serial terminal GUI written in Python. This is a tool that’s useful for talking to a variety of serial based hardware that can involve custom protocols or just a standard command line interface. It runs on anything that supports Python and Qt.

TinyCom is inspired by the original CuteCom.


  • Line oriented input and output, with configurable line ending.

  • Customizeable serial port configuration.

  • Automatically enumerates platform serial ports.

  • History of input lines, to easily regenerate them with a click.

  • Log the session to a file.

Runtime Requirements

This is just an overview of runtime requirements. All major versions of both the Python interpreter and QT API are supported.


For simplicity, instructions for only PyQt4 and Python2 are listed here. However, you can adjust to use any combination of Python2/Python3 and PyQt4/PyQt5/Pyside if you prefer when it comes to runtime dependencies.

On Ubuntu, first install dependencies using the system package manager.

sudo apt-get install python python-qt4 python-serial python-pip

Then, use pip to install tinycom.

pip install [--user] tinycom

Or, if you’re installing from source:

pip install [--user] tinycom-<version>.tar.bz2

The –user option causes tinycom to be installed in your home directory under ~/.local.

Then, if you somehow get fed up with TinyCom’s awesomeness, uninstall it.

pip uninstall tinycom


Just execute tinycom.


Main Window

Main Window


TinyCom can use PyQt4, PyQt5, or PySide for its Qt API. As long as you have one installed, it will be automatically detected and used at runtime. However, if you wish to force a specific Qt API, you can set the QT_API environment variable to one of the following values when running.

QT_API=pyqt4 tinycom
QT_API=pyqt5 tinycom
QT_API=pyside tinycom


TinyCom is licensed under GPL Version 3. See the LICENSE.txt file. is licensed under 3-clause BSD. is MIT licensed.

TinyCom Release Notes

Version 1.1 22 Feb 2017

  • Ignore pylint wrong-import-position warning

  • Convert to rst long_description for PyPi

  • Switch sdist to gztar by default

  • Full support for PyQt4, PyQt5, and Pyside at runtime

  • Remove dead code comment

  • Enable universal package support by default

Version 1.0 20 Feb 2017

  • Initial alpha release.

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

tinycom-1.1.tar.gz (74.6 kB view hashes)

Uploaded source

Built Distribution

tinycom-1.1-py2.py3-none-any.whl (23.9 kB view hashes)

Uploaded py2 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