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:: http://urwid.org/

Installation

To install using pip

pip install urwid

For 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-urwid

Windows 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 py39,py10,pypy3  # Test Python 3.9, Python 3.10 & pypy3

Supported Python versions

3.9
3.10
3.11
3.12
3.13
3.14
pypy3

Authors

Creator

wardi

Maintainers

and3rson, tonycpsu, ulidtko, penguinolog

Contributors

1in7billion, abadger, agrenott, akorb, alethiophile, aleufroy, alobbs, amjltc295, and-semakin, andrewshadura, andy-z, anttin2020, Apteryks, Arfrever, AutoAwesome, belak, berney, bk2204, BkPHcgQL3V, bwesterb, carlos-jenkins, Certseeds, Chipsterjulien, chrisspen, cltrudeau, Codeberg-AsGithubAlternative-buhtz, cortesi, d0c-s4vage, derdon, dholth, dimays, dlo, dnaeon, doddo, douglas-larocca, drestebon, dsotr, dwf, EdwardBetts, elenril, EnricoBilla, extempore, fabiand, floppym, flowblok, fmoreau, goncalopp, Gordin, GregIngelmo, grzaks, gurupras, HarveyHunt, Hoolean, hukka, hydratim, ids1024, imrek, isovector, itaisod, ixxra, jeblair, johndeaton, jonblack, jspricke, kedder, Kelketek, KennethNielsen, kesipyc, kkrolczyk, Kwpolska, Lahorde, laike9m, larsks, lfam, lgbaldoni, lighth7015, livibetter, Lothiraldan, Mad-ness, madebr, magniff, marlox-ouda, mattymo, mdtrooper, mgk, mimi1vx, mobyte0, MonAaraj, MonthlyPython, mountainstorm, mselee, mwhudson, naquad, nchavez324, neumond, nolash, ntamas, nyov, ocarneiro, okayzed, pquentin, rbanffy, ReddyKilowatt, regebro, renegarcia, rianhunter, roburban, RRMoelker, rwarren, scopatz, seanhussey, seonon, shadedKE, sithglan, Sjc1000, sporkexec, squrky, ssbr, techdragon, thehunmonkgroup, thisch, thornycrackers, TomasTomecek, tompickering, tony, ttanner, tu500, uSpike, vega0, vit1251, waveform80, Wesmania, xandfury, xndcn, zhongshangwu, zrax

Release files for urwid 4.1.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for urwid 4.1.5
File	Size	Uploaded
urwid-4.1.5.tar.gz	1.0 MB	Sep 18, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for urwid 4.1.5
File	Interpreter	ABI	Platform	Reset
urwid-4.1.5-py3-none-any.whl 355.0 kB Sep 18, 2026	Python 3	none	any	Details

Total release size:1.4 MB

Release files / urwid-4.1.5.tar.gz

Download URL	urwid-4.1.5.tar.gz
Size	1.0 MB
Tags	Source
SHA-256 checksum How to use checksums	`cfae4dace2565dd3725c0047150d68dcb662cf350eb4f0cefef64b8cd88a2251`
BLAKE2b-256 checksum How to use checksums	`52f7111e5df1310a1287fd57ed3c09fb3a0b2b857bd192a02dd14fa92c89a9d2`
Upload date	Sep 18, 2026
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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/urwid/urwid
Publishing commit: github.com/urwid/urwid/tree/c53a25a85cec429d59d3a84253023771d2944a72

Workflow

Publishing configuration: github.com/urwid/urwid/blob/c53a25a85cec429d59d3a84253023771d2944a72/.github/workflows/pythonpackage.yml
Publishing logs: github.com/urwid/urwid/actions/runs/35346324700/attempts/1

Artifact

Subject: urwid-4.1.5.tar.gz
SHA-256 checksum: cfae4dace2565dd3725c0047150d68dcb662cf350eb4f0cefef64b8cd88a2251 Verifying attestations

Release files / urwid-4.1.5-py3-none-any.whl

Download URL	urwid-4.1.5-py3-none-any.whl
Size	355.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b25b8dd0515cd46535dd86fdf678704e9522db6b94ad2e05b164a716e0856119`
BLAKE2b-256 checksum How to use checksums	`b95a17c16a7dbf86d501bfed0076c9879b14e7a27981a74fd3a0edfd2550617f`
Upload date	Sep 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/urwid/urwid
Publishing commit: github.com/urwid/urwid/tree/c53a25a85cec429d59d3a84253023771d2944a72

Workflow

Publishing configuration: github.com/urwid/urwid/blob/c53a25a85cec429d59d3a84253023771d2944a72/.github/workflows/pythonpackage.yml
Publishing logs: github.com/urwid/urwid/actions/runs/35346324700/attempts/1

Artifact

Subject: urwid-4.1.5-py3-none-any.whl
SHA-256 checksum: b25b8dd0515cd46535dd86fdf678704e9522db6b94ad2e05b164a716e0856119 Verifying attestations