---
name: "notcurses-input"
section: "1"
platform: "linux"
package: "notcurses"
version: "3.0.17-3"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/notcurses-input"
---

# notcurses-input(1)

Read and display input events

## NAME

notcurses-input - Read and display input events

## SYNOPSIS

**notcurses-input** \[**-v**\] \[**-m**\]

## DESCRIPTION

**notcurses-input** reads from stdin and decodes the input to stdout, including synthesized events and mouse events. To exit, generate EOF (usually Ctrl+'d').

Each event will be printed on a single line. Leading that line is a series of modifier indicators:

- •

  'A'/'a': Alt was or was not pressed.

- •

  'C'/'c': Ctrl was or was not pressed.

- •

  'S'/'s': Shift was or was not pressed.

- •

  'U'/'u': Super was or was not pressed

- •

  'M'/'m': Meta was or was not pressed.

- •

  'H'/'h': Hyper was or was not pressed.

- •

  'X'/'x': CapsLock was or was not pressed.

- •

  '#'/'.': NumLock was or was not pressed.

- •

  'L'/'R'/'P'/'u': Key was a release, repeat, press, or of unknown type.

By default, mice events are enabled.

## OPTIONS

**-v**: Increase verbosity. **-m**: Inhibit mice events.

## NOTES

Mouse events are only generated for button presses and releases, and for movement while a button is held down.

## SEE ALSO

**[tack(1)](/tack/1.md)**, **[notcurses(3)](/notcurses/3.md)**, **[notcurses\_input(3)](/notcurses_input/3.md)**

## AUTHORS

nick black ⟨nickblack@linux.com⟩\\c.