{"author":null,"author_email":"Ian Ward ","bugtrack_url":null,"classifiers":["Development Status :: 5 - Production/Stable","Environment :: Console","Environment :: Console :: Curses","Intended Audience :: Developers","License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL)","Operating System :: MacOS :: MacOS X","Operating System :: Microsoft :: Windows","Operating System :: POSIX","Operating System :: Unix","Programming Language :: Python :: 3","Programming Language :: Python :: 3 :: Only","Programming Language :: Python :: 3.10","Programming Language :: Python :: 3.11","Programming Language :: Python :: 3.12","Programming Language :: Python :: 3.13","Programming Language :: Python :: 3.9","Programming Language :: Python :: Implementation :: CPython","Programming Language :: Python :: Implementation :: PyPy","Topic :: Software Development :: Libraries :: Python Modules","Topic :: Software Development :: Widget Sets"],"description":"Urwid\n=====\n|pypi| |docs| |gitter| |ci| |pre-commit| |coveralls|\n\nAbout\n=====\n\nUrwid is a console user interface library for Python on Linux, OSX, Cygwin or other unix-like OS\nand partially supports Windows OS (see below).\n\nIt includes many features useful for text console application developers including:\n\n- Applications resize quickly and smoothly\n- Automatic, programmable text alignment and wrapping\n- Simple markup for setting text attributes within blocks of text\n- Powerful list box with programmable content for scrolling all widget types\n- Your choice of event loops: Twisted, Glib, Tornado, asyncio, trio, ZeroMQ or select-based loop\n- Pre-built widgets include edit boxes, buttons, check boxes and radio buttons\n- Display modules include raw, curses, and experimental LCD and web displays\n- Support for UTF-8, simple 8-bit and CJK encodings\n- 24-bit (true color), 256 color, and 88 color mode support\n- Compatible with Python 3.7+ and PyPy\n\nHome Page:\n http://urwid.org/\n\nInstallation\n============\n\nTo install using pip\n\n.. code:: bash\n\n pip install urwid\n\nFor advanced functionality extra requirements need to be installed.\nExample for ZeroMQ event loop and LCD display:\n\n.. code:: bash\n\n pip install urwid[serial,zmq]\n\nAlternatively if you are on Debian or Ubuntu\n\n.. code:: bash\n\n apt-get install python3-urwid\n\nWindows support notes\n=====================\n\n* Not supported:\n\n1. Terminal widget and all related render API (TermCanvas, TermCharset, TermModes, TermScroller)\n2. Any file descriptors except sockets (Windows OS limitation)\n3. ZMQEventLoop.\n\n* Special requirements:\n\n1. Extra libraries required for curses display support:\n\n.. code-block:: bash\n\n pip install urwid[curses]\n\n* CursesDisplay incorrectly handles mouse input in case of fast actions.\n* Only UTF-8 mode is supported.\n\n\nTesting\n=======\n\nTo run tests locally, install & run `tox`. You must have\nappropriate Python versions installed to run `tox` for\neach of them.\n\nTo test code in all Python versions:\n\n.. code:: bash\n\n tox # Test all versions specified in tox.ini:\n tox -e py39 # Test Python 3.9 only\n tox -e py39,py10,pypy3 # Test Python 3.9, Python 3.10 & pypy3\n\nSupported Python versions\n=========================\n\n- 3.9\n- 3.10\n- 3.11\n- 3.12\n- 3.13\n- pypy3\n\nAuthors\n=======\n\nCreator\n-------\n\n`wardi `_\n\nMaintainers\n-----------\n\n`and3rson `_,\n`tonycpsu `_,\n`ulidtko `_,\n`penguinolog `_\n\nContributors\n------------\n\n`1in7billion `_,\n`abadger `_,\n`agrenott `_,\n`akorb `_,\n`alethiophile `_,\n`aleufroy `_,\n`alobbs `_,\n`amjltc295 `_,\n`and-semakin `_,\n`andrewshadura `_,\n`andy-z `_,\n`anttin2020 `_,\n`Apteryks `_,\n`Arfrever `_,\n`AutoAwesome `_,\n`belak `_,\n`berney `_,\n`bk2204 `_,\n`BkPHcgQL3V `_,\n`bwesterb `_,\n`carlos-jenkins `_,\n`Certseeds `_,\n`Chipsterjulien `_,\n`chrisspen `_,\n`cltrudeau `_,\n`Codeberg-AsGithubAlternative-buhtz `_,\n`cortesi `_,\n`d0c-s4vage `_,\n`derdon `_,\n`dholth `_,\n`dimays `_,\n`dlo `_,\n`dnaeon `_,\n`doddo `_,\n`douglas-larocca `_,\n`drestebon `_,\n`dsotr `_,\n`dwf `_,\n`EdwardBetts `_,\n`elenril `_,\n`EnricoBilla `_,\n`extempore `_,\n`fabiand `_,\n`floppym `_,\n`flowblok `_,\n`fmoreau `_,\n`goncalopp `_,\n`Gordin `_,\n`GregIngelmo `_,\n`grzaks `_,\n`gurupras `_,\n`HarveyHunt `_,\n`Hoolean `_,\n`hukka `_,\n`hydratim `_,\n`ids1024 `_,\n`imrek `_,\n`isovector `_,\n`itaisod `_,\n`ixxra `_,\n`jeblair `_,\n`johndeaton `_,\n`jonblack `_,\n`jspricke `_,\n`kedder `_,\n`Kelketek `_,\n`KennethNielsen `_,\n`kesipyc `_,\n`kkrolczyk `_,\n`Kwpolska `_,\n`Lahorde `_,\n`laike9m `_,\n`larsks `_,\n`lfam `_,\n`lgbaldoni `_,\n`lighth7015 `_,\n`livibetter `_,\n`Lothiraldan `_,\n`Mad-ness `_,\n`madebr `_,\n`magniff `_,\n`marlox-ouda `_,\n`mattymo `_,\n`mdtrooper `_,\n`mgk `_,\n`mimi1vx `_,\n`mobyte0 `_,\n`MonAaraj `_,\n`MonthlyPython `_,\n`mountainstorm `_,\n`mselee `_,\n`mwhudson `_,\n`naquad `_,\n`nchavez324 `_,\n`neumond `_,\n`nolash `_,\n`ntamas `_,\n`nyov `_,\n`ocarneiro `_,\n`okayzed `_,\n`pquentin `_,\n`rbanffy `_,\n`ReddyKilowatt `_,\n`regebro `_,\n`renegarcia `_,\n`rianhunter `_,\n`roburban `_,\n`RRMoelker `_,\n`rwarren `_,\n`scopatz `_,\n`seanhussey `_,\n`seonon `_,\n`shadedKE `_,\n`sithglan `_,\n`Sjc1000 `_,\n`sporkexec `_,\n`squrky `_,\n`ssbr `_,\n`techdragon `_,\n`thehunmonkgroup `_,\n`thisch `_,\n`thornycrackers `_,\n`TomasTomecek `_,\n`tompickering `_,\n`tony `_,\n`ttanner `_,\n`tu500 `_,\n`uSpike `_,\n`vega0 `_,\n`vit1251 `_,\n`waveform80 `_,\n`Wesmania `_,\n`xandfury `_,\n`xndcn `_,\n`zhongshangwu `_,\n`zrax `_\n\n\n.. |pypi| image:: https://img.shields.io/pypi/v/urwid\n :alt: current version on PyPi\n :target: https://pypi.python.org/pypi/urwid\n\n.. |docs| image:: https://github.com/urwid/urwid/actions/workflows/documentation.yml/badge.svg?branch=master\n :alt: Documentation Status\n :target: https://urwid.org\n\n.. |gitter| image:: https://img.shields.io/gitter/room/urwid/community\n :alt: Gitter\n :target: https://gitter.im/urwid/community\n\n.. |ci| image:: https://github.com/urwid/urwid/actions/workflows/pythonpackage.yml/badge.svg?branch=master\n :target: https://github.com/urwid/urwid/actions\n :alt: CI status\n\n.. |pre-commit| image:: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit\n :target: https://github.com/pre-commit/pre-commit\n :alt: pre-commit\n\n.. |coveralls| image:: https://coveralls.io/repos/github/urwid/urwid/badge.svg\n :alt: test coverage\n :target: https://coveralls.io/github/urwid/urwid\n","description_content_type":"text/x-rst","docs_url":null,"download_url":null,"downloads":{"last_day":-1,"last_month":-1,"last_week":-1},"dynamic":["License-File"],"home_page":null,"keywords":"curses, ui, widget, scroll, listbox, user interface, text layout, console, ncurses","license":"LGPL-2.1-only","license_expression":null,"license_files":["COPYING"],"maintainer":null,"maintainer_email":null,"name":"urwid","package_url":"https://pypi.org/project/urwid/","platform":"unix-like","project_url":"https://pypi.org/project/urwid/","project_urls":{"Bug Tracker":"https://github.com/urwid/urwid/issues","Documentation":"https://urwid.org/manual/index.html","Homepage":"https://urwid.org/","Repository":"https://github.com/urwid/urwid"},"provides_extra":["curses","glib","tornado","trio","twisted","zmq","serial","lcd"],"release_url":"https://pypi.org/project/urwid/3.0.2/","requires_dist":["wcwidth","windows-curses; sys_platform == \"win32\" and extra == \"curses\"","PyGObject; extra == \"glib\"","tornado>=5.0; extra == \"tornado\"","trio>=0.24.0; extra == \"trio\"","exceptiongroup; python_version < \"3.11\" and extra == \"trio\"","twisted; extra == \"twisted\"","zmq; extra == \"zmq\"","pyserial; extra == \"serial\"","pyserial; extra == \"lcd\""],"requires_python":">=3.9.0","summary":"A full-featured console (xterm et al.) user interface library","version":"3.0.2","yanked":false,"yanked_reason":null}

Dependency	Optional
wcwidth	false
exceptiongroup	true
PyGObject	true
pyserial	true
tornado	true
trio	true
twisted	true
windows-curses	true
zmq	true

Package search

urwid

project_urls

Dependencies

All package metadata

Releases