System Servicesserialcommunicationterminalmodemzmodemscripting

minicom

Minicom is a friendly menu-driven serial communication program that emulates ANSI and VT102 terminals. It includes a dialing directory and supports auto Zmodem downloads.

Description

Minicom serves as a clone of the MS-DOS Telix communication program, providing serial terminal emulation for Linux and Unix-like systems. It is designed for connecting to serial devices, modems, and remote systems via serial ports, with features like a dialing directory for easy access to common connections and automatic Zmodem file transfers.

Common use cases include debugging embedded systems, accessing router consoles, modem dialing for legacy networks, and automating login sequences to Unix systems or BBSes. The tool supports setup menus for configuring ports, baud rates, and protocols, making it versatile for hardware interfacing and serial debugging tasks.

Associated utilities like ascii-xfr handle ASCII protocol file transfers, runscript enables automation through scripting, and xminicom provides a color-enabled X11 wrapper for graphical environments.

How It Works

Minicom operates as a terminal emulator supporting ANSI and VT102 protocols over serial devices. It connects to specified devices with configurable baud rates, initializes modems if needed, and handles input/output translation including character sets like ISO8859. File transfers use protocols such as Zmodem or ASCII via ascii-xfr, while runscript interprets scripts using expect-like pattern matching, sending strings with escape sequences (\n, \r, control characters), variables, conditionals, and shell command execution (! <command>) to automate interactions. Configuration is stored in /etc/minicom, with options overrideable via command line or MINICOM environment variable.

Installation

bash
sudo apt install minicom

Flags

-b, --baudrateset baudrate (ignore the value from config)
-D, --deviceset device name (ignore the value from config)
-s, --setupenter setup mode
-o, --noinitdo not initialize modem & lockfiles at startup
-m, --metakeyuse meta or alt key for commands
-M, --metakey8use 8bit meta key for commands
-l, --ansiliteral; assume screen uses non IBM-PC character set
-L, --isodon't assume screen uses ISO8859

Examples

Display help for ascii-xfr showing ASCII file transfer options
ascii-xfr -h
Show minicom usage and available command line options
minicom -h
Invoke runscript interpreter for automating tasks like login from minicom
runscript scriptname [logfile [homedir]]
Launch color-enabled minicom wrapper in xterm or rxvt
xminicom minicom-options
Send file using ASCII protocol
ascii-xfr -s filename
Receive file using ASCII protocol
ascii-xfr -r filename
Enter minicom setup mode
minicom -s
Example runscript command to forcefully exit minicom without hanging up the line
! killall -9 minicom
Updated 2026-04-16kali.org ↗