A free, MIT-licensed, open-source TTY workbench in the browser: serial terminal, Device Detective, session recorder, ANSI log viewer, dump explainer, escape lab, accessibility RTT, and Teletype museum. https://tty000.com/

Is tty000 free and open source?

Yes. MIT License at https://tty000.com/LICENSE. Download the site at https://tty000.com/tty000.zip. No account. Donations to CashApp $t3xus are optional.

Is tty000 a PuTTY or minicom alternative?

Yes, for in-browser serial work. Use https://tty000.com/serial or /workbench. Firefox and Safari use the local helper or Demo UART.

Does serial data leave my computer?

No, unless you export a file or you chose host ports on a Debian machine that has the cable.

Does it work in Firefox and Safari?

Yes. Use Demo UART, the local helper, or Debian host ports. Web Serial is Chromium only.

Where should bots read the product?

https://tty000.com/llms.txt, /llms-full.txt, /product.json, and /product.xml.

TTY000

Loading the workbench

Skip to TTY

Setup Help API

A TTY in the browser

Six tools.One glass.Nothing uploaded.

Serial on a wire, logs that still have their colors, escapes that broke a CLI, a dump that finally speaks English, a typed conversation, and ten characters a second on paper. Pick a tool below. Help has the steps if you want them.

Open Workbench USB setup

Downloads

Small download

Local helper

One Python file. Firefox and Safari use it to reach a USB adapter on this computer. Read the source first if you like.

python3 server.py --helper

Download server.py Setup steps View the source

Setup

Give this page a USB port.

Browsers guard serial hardware, and each one guards it differently. Pick the row that matches you — two of the three need nothing installed.

No install

Demo UART

A fake board that boots, echoes, and answers AT. Every browser, every OS, including phones. Use it to learn the workbench before you plug anything in.

Open Serial and pick Demo UART

No install

Web Serial

Chrome, Edge, and other Chromium browsers can open a real USB port after one permission prompt. Nothing to download and nothing to run.

Checking this browser…

Small download

The local helper

Firefox and Safari have no Web Serial. A ~18 KB Python script on your machine owns the port instead and hands it to the browser. Instructions below.

Read the steps

The local helper

Three commands, then a browser tab

The helper is one file with no dependencies on macOS or Linux. It listens on 127.0.0.1:7682, talks to your USB adapter, and serves the same workbench from your own machine. Nothing it reads leaves the machine.

Step 1 · Get the file

One script. Read it first if you like — it is short, and it is the same file this site runs on.

Download server.py View the source

Step 2 · Set up and run

Install Python 3

Windows has no Python by default. Use the store package or the installer, and tick Add python.exe to PATH.
```
winget install -e --id Python.Python.3.12
```
No winget? Get it from python.org/downloads.
Add the one dependency

Windows is the only platform that needs a package: pyserial provides the COM port access.
```
py -m pip install --user pyserial
```
Start the helper

Open PowerShell in your Downloads folder and run it. Leave the window open while you work.
```
cd $HOME\Downloads
py server.py --helper
```
Open the workbench

Go to http://127.0.0.1:7682/. Your COM ports appear under How to reach the wire.

Driver missing? Most cheap adapters need CP210x or CH340 drivers on Windows.

Check Python 3

macOS ships it. If the command prints a version you are done — there are no packages to install.
```
python3 --version
```
Missing? macOS offers the Command Line Tools, or use brew install python.
Start the helper

Open Terminal in the folder you downloaded to. Leave it running while you work.
```
cd ~/Downloads
python3 server.py --helper
```
Open the workbench

Go to http://127.0.0.1:7682/. Your adapter shows up as /dev/cu.usbserial-* or /dev/cu.usbmodem*.
Stop it when you are done

Press Ctrl C in Terminal. Nothing is left running and nothing was installed.

Pick /dev/cu.* rather than /dev/tty.* — the tty device blocks waiting for carrier detect.

Check Python 3

Almost every distribution already has it, and the helper needs no pip packages here.
```
python3 --version
# Debian or Ubuntu, if missing:
sudo apt install python3
```
Let your user reach the port

Serial devices belong to the dialout group. Add yourself once, then log out and back in for it to take effect.
```
sudo usermod -aG dialout $USER
```
Arch and openSUSE use uucp instead of dialout.

Start the helper

cd ~/Downloads
python3 server.py --helper

Open the workbench

Go to http://127.0.0.1:7682/. Ports appear as /dev/ttyUSB0 or /dev/ttyACM0.

Hosting tty000 for a lab? TTY000_SERIAL=1 on the server exposes that machine's UARTs to any browser. See the README.

If it will not connect

The four usual causes

The port list is empty: The adapter is not enumerating. Unplug and replug it, then reload the helper page. On Windows this is nearly always a missing CP210x or CH340 driver.
Permission denied on Linux: You are not in dialout yet, or you have not logged out since adding yourself. Check with groups; the change does not apply to an existing session.
The browser will not reach 127.0.0.1: An HTTPS page cannot call plain http://127.0.0.1. That is why you open the helper's own address in a tab instead of loading it from this site.
Connected, but the output is garbage: Wrong baud rate. Try the profile for your board, or press Guess baud and let it sweep for the rate with the most printable text.

tty000

A TTY in the browser. Enable JavaScript to use the workbench, or read the catalogs:

Six tools.One glass.Nothing uploaded.

Local helper

Give this page a USB port.

Demo UART

Web Serial

The local helper

Three commands, then a browser tab

Step 1 · Get the file

Step 2 · Set up and run

Install Python 3

Add the one dependency

Start the helper

Open the workbench

Check Python 3

Start the helper

Open the workbench

Stop it when you are done

Check Python 3

Let your user reach the port

Start the helper

Open the workbench

The four usual causes

You

Far

About tty000