Urwid
About
Urwid is a console user interface library for Python on Linux, OSX, Cygwin or other unix-like OS and partially supports Windows OS (see below).
It includes many features useful for text console application developers including:
Applications resize quickly and smoothly
Automatic, programmable text alignment and wrapping
Simple markup for setting text attributes within blocks of text
Powerful list box with programmable content for scrolling all widget types
Your choice of event loops: Twisted, Glib, Tornado, asyncio, trio, ZeroMQ or select-based loop
Pre-built widgets include edit boxes, buttons, check boxes and radio buttons
Display modules include raw, curses, and experimental LCD and web displays
Support for UTF-8, simple 8-bit and CJK encodings
24-bit (true color), 256 color, and 88 color mode support
Compatible with Python 3.9+ and PyPy
- Home Page:
Installation
To install using pip
pip install urwidFor advanced functionality extra requirements need to be installed. Example for ZeroMQ event loop and LCD display:
pip install urwid[serial,zmq]Alternatively if you are on Debian or Ubuntu
apt-get install python3-urwidWindows support notes
Windows support is limited to the Windows 10+ due to ANSI support requirement.
Not supported:
Terminal widget and all related render API (TermCanvas, TermCharset, TermModes, TermScroller)
Any file descriptors except sockets (Windows OS limitation)
ZMQEventLoop.
Special requirements:
Extra libraries required for curses display support:
pip install urwid[curses]CursesDisplay incorrectly handles mouse input in case of fast actions.
Only UTF-8 mode is supported.
Testing
To run tests locally, install & run tox. You must have appropriate Python versions installed to run tox for each of them.
To test code in all Python versions:
tox # Test all versions specified in tox.ini
tox -e py39 # Test Python 3.9 only
tox -e py313t # Test Python 3.13 with free-threading
tox -e pypy3 # Test PyPy3
tox -e py39,py310,pypy3 # Test specific versionsTesting different Python implementations
CPython standard (default)
Tests all optional extras including C extensions (glib, zmq, twisted).
tox -e py313Free-threaded CPython (3.13+)
Tests with compatible extras (tornado, trio, twisted, serial). Excludes C extensions without free-threading wheel support.
tox -e py313t # Python 3.13 free-threaded (PEP 703)
tox -e py314t # Python 3.14 free-threaded
tox -e py315t # Python 3.15 free-threadedPyPy3
Tests with compatible extras (tornado, trio, serial). Excludes problematic C extensions.
tox -e pypy3GraalPy
Tests with compatible extras (tornado, serial). Excludes extras that need C extensions GraalPy doesn’t support (glib, zmq) or that have known compatibility issues (trio, twisted). GraalPy also ships no _curses module, so curses-dependent tests are expected to fail, and the Terminal widget (urwid.vterm) is unsupported since its fcntl/pty usage doesn’t work on GraalPy, so its tests are skipped rather than run.
tox -e graalpy311 # GraalPy 3.11
tox -e graalpy312 # GraalPy 3.12Supported Python versions
Urwid supports:
CPython 3.9, 3.10, 3.11, 3.12, 3.13, 3.14, 3.15
CPython 3.13+ with free-threading (PEP 703 --disable-gil)
PyPy 3.x
GraalPy 3.11, 3.12 (experimental)
Python implementation notes
CPython (standard Python)
Full support for all optional features. All extras (curses, glib, serial, tornado, trio, twisted, zmq) can be installed.
CPython with Free-Threading (3.13, 3.14, 3.15+)
Urwid core and pure-Python event loops are fully supported. Some extras require C extensions that may not have free-threading wheels available:
✅ Supported: core, tornado, trio, twisted (24.10.0+), serial, lcd
❌ Unsupported: glib, zmq (require C extensions with free-threading wheel support)
For free-threading Python, install with compatible extras:
python3.13 -m pip install 'urwid[tornado,trio,serial]'PyPy
Urwid core is fully supported. Some extras may have compatibility issues:
✅ Supported: core, tornado, trio, serial, lcd
⚠️ Limited: twisted (may have issues, test before using)
❌ Unsupported: glib, zmq (C extensions with limited PyPy support)
GraalPy (experimental)
Urwid core and the select/asyncio event loops are supported. Some extras, display modules, and the Terminal widget are not:
✅ Supported: core, tornado, serial, lcd
❌ Unsupported: curses (GraalPy ships no _curses module), glib, zmq, twisted, trio (no C extension support, or known compatibility issues), Terminal widget/urwid.vterm (like on Windows, fcntl/pty usage doesn’t work on GraalPy)
5 maintainers
Release files for urwid 4.1.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| urwid-4.1.7.tar.gz | 333.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| urwid-4.1.7-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 694.4 kB
Release files / urwid-4.1.7.tar.gz
| Download URL | urwid-4.1.7.tar.gz |
|---|---|
| Size | 333.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e69c299f0e9cdedb839d5ec6d58d31b08fa6895cfc5dfd59c8cb016377aab26f
|
|
BLAKE2b-256 checksum How to use checksums |
6f55ae4b607277b6c6a7d02e145e9a24c777e5bd2b9189d7145f0afc731bf639
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 23, 2026.
Transparency logRelease files / urwid-4.1.7-py3-none-any.whl
| Download URL | urwid-4.1.7-py3-none-any.whl |
|---|---|
| Size | 361.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
29d65128bc64c406c605a50276b4f84fbda1da032751f7673cbb25631fbfbbc3
|
|
BLAKE2b-256 checksum How to use checksums |
81029c1556e9bfcda12c9779ab367c2b430e7d6a50b00752c3f111d426676a9c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 23, 2026.
Transparency log
