NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #1692 most downloaded on PyPI
A full-featured console (xterm et al.) user interface library
Latest stable
5.1.1
Last release 12 days ago
10 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
3 versions withdrawn
withdrawn after publishing
14 years old
117 releases · first in 2012
Drag across the ruler to compare, or tap a release to open it.
CheckBox(checked_symbol=...) is keyword-only: passing it as the sixth positional argument raises TypeError by @penguinolog in https://github.com/urwid
CheckBox(checked_symbol=...) is keyword-only: passing it as the sixth positional argument raises TypeError by @penguinolog in https://github.com/urwid/urwid/pull/1603max_cols and max_rows to keep the old limits by @penguinolog in https://github.com/urwid/urwid/pull/1608shrink_to_fit=True to Overlay, Filler and OverlayStack.open(): a 'pack' top widget or body taller than the screen that also supports BOX sizing is rendered as a box at the rows available instead of being cut off at the bottom, so a dialog keeps its border and buttons by @penguinolog in https://github.com/urwid/urwid/pull/1624ListBox(flow=True): the list reports FLOW sizing over a body that knows its length, so a dialog takes the rows of its content and scrolls only when the screen is too short by @penguinolog in https://github.com/urwid/urwid/pull/1625Frame when its body does, and add Frame(flow=True) to report FLOW sizing over such a body by @penguinolog in https://github.com/urwid/urwid/pull/1626Frame(min_body_rows=..., trim_first=...) to choose which part of a Frame keeps its rows on a short screen by @penguinolog in https://github.com/urwid/urwid/pull/1627WidgetSizingError naming the widget, the size and the sizing modes it supports when a widget gets a size it cannot handle, instead of an unrelated ValueError or AttributeError from deep inside urwid; it subclasses the exception it replaces by @penguinolog in https://github.com/urwid/urwid/pull/1612ListBox.set_scrollpos() to scroll the view to an exact row, and wheel="view" for ListBox, TreeListBox and Table, where the mouse wheel scrolls the view rather than moving the focus by @penguinolog in https://github.com/urwid/urwid/pull/1616Table(footer=...) for a row below the body, and header_drop / footer_drop thresholds that give the body room on a short screen by @penguinolog in https://github.com/urwid/urwid/pull/1609Table.set_focus(position, coming_from=...), and unfocused_focus_attr_func= to compute the unfocused focus attribute per child in Pile, Columns, GridFlow, ListBox, Tabs and Table by @penguinolog in https://github.com/urwid/urwid/pull/1615ScrollBar options to Table as scrollbar_<name> keywords by @penguinolog in https://github.com/urwid/urwid/pull/1601unchecked_symbol= and mixed_symbol= to CheckBox, all three symbol keywords to RadioButton, CheckBox.Symbols with common state marks, and more ScrollBar symbols by @penguinolog in https://github.com/urwid/urwid/pull/1603max_cols / max_rows to its Screen() and html_page() by @penguinolog in https://github.com/urwid/urwid/pull/1608urwid.testing.VirtualClockEventLoop, whose alarms fire on a clock the test advances, and urwid.testing.attrs_for_text() by @penguinolog in https://github.com/urwid/urwid/pull/1620VirtualClockEventLoop.run_until_idle() to run every pending alarm and readable watched file and then return by @penguinolog in https://github.com/urwid/urwid/pull/1621ScriptedScreen(inputs=None), a screen that feeds no input and keeps a started loop running for run_until_idle() by @penguinolog in https://github.com/urwid/urwid/pull/1622Table to the enclosing widget unless an "activate" handler returns a true value; a handler that returns None no longer consumes the key by @penguinolog in https://github.com/urwid/urwid/pull/1614Frame body when the header and footer fill the Frame but render() still shows a body row by @penguinolog in https://github.com/urwid/urwid/pull/1626TextCanvas whose attr or cs list is shorter than text, such as attr=[]; such lines were counted by rows() but left out of content() by @penguinolog in https://github.com/urwid/urwid/pull/1611Pile, Columns, GridFlow, Tabs or Table without waiting for the cyclic garbage collector by @penguinolog in https://github.com/urwid/urwid/pull/1613TextCanvas attribute and character set runs, and show the source of each example program by @penguinolog in https://github.com/urwid/urwid/pull/1611Full Changelog: https://github.com/urwid/urwid/compare/5.1.0...5.1.1
Your coding agent can read these notes before it upgrades. Set up the MCP server →
…decode curses mouse events on PyPy; also see "Security fixes" above by @penguinolog in https://github.com/urwid/urwid/pull/1599
pipe_dir, so any local user could list it, type into another user's application and read its screen. Session files now live in a 0700 directory per user under hashed names, the daemon runs with umask 077, and max_clients counts only the user's own sessions (GHSA-xm5p-pwm6-5w65) by @penguinolog in https://github.com/urwid/urwid/security/advisories/GHSA-xm5p-pwm6-5w65Terminal child off the host terminal: a child that selected the IBM PC character set could run OSC 52, OSC 2 or CSI commands on the host terminal through a UTF-8 encoded C1 control; also see "Bug fixes" below: Harden the displays against hostile input and failed start or stop by @penguinolog in https://github.com/urwid/urwid/pull/1599Table: a fixed header over a scrolling body of rows whose columns share their widths, with TableColumn (packed, given or weighted width, per-column attribute map), TableRow and TableLayout for shared widths outside a Table by @penguinolog in https://github.com/urwid/urwid/pull/1550 and https://github.com/urwid/urwid/pull/1559Tabs: a row of tab labels over the selected tab's body, with overflow markers, an optional underline row, the Command.NEXT_TAB and Command.PREVIOUS_TAB commands and the "focus changed" signal by @penguinolog in https://github.com/urwid/urwid/pull/1566 and https://github.com/urwid/urwid/pull/1594Edit(placeholder=...), whole-value validation (validator=, Severity, ValidationMessage, the "validation" signal) and completion (text_completer=, the "completion_cycle" signal) by @penguinolog in https://github.com/urwid/urwid/pull/1561CommandMap.bind_readline(), Edit(undo_limit=...) with undo and redo, and Edit(kill_buffer=...) with yank by @penguinolog in https://github.com/urwid/urwid/pull/1565Pile, Columns, ListBox and GridFlow take unfocused_focus_attr= by @penguinolog in https://github.com/urwid/urwid/pull/1549get_running_loop() and get_running_loop_or_none() for the MainLoop of the current thread and task; a Terminal built without main_loop= watches its pty on the running loop and shows the child's output by @penguinolog in https://github.com/urwid/urwid/pull/1569MainLoop.call_from_thread() to run a callback on the loop thread from another thread or a signal handler, and MainLoop(poll_interval=...) for screens without event loop support, such as curses by @penguinolog in https://github.com/urwid/urwid/pull/1573urwid.display.websocket.Screen, that any HTTP server library can drive, GuardedEventLoop to keep one application's error off a shared event loop, and examples/websocket_tornado.py by @penguinolog in https://github.com/urwid/urwid/pull/1597OverlayStack: nested dialogs over a base widget, optionally closed on Esc or a click outside by @penguinolog in https://github.com/urwid/urwid/pull/1592FilteredListWalker: a read-only filtered view over a list or deque walker by @penguinolog in https://github.com/urwid/urwid/pull/1593Notifications: timed messages for a footer or a status line by @penguinolog in https://github.com/urwid/urwid/pull/1572Spinner: an activity indicator for work without a total by @penguinolog in https://github.com/urwid/urwid/pull/1585"menu" from Overlay when its top widget leaves Esc unhandled by @penguinolog in https://github.com/urwid/urwid/pull/1547Overlay dialogs on a click outside them: the Overlay signal "click outside" and PopUpLauncher(close_on_click_outside=True), which DropDown turns on by @penguinolog in https://github.com/urwid/urwid/pull/1570"focus changed" from Frame by @penguinolog in https://github.com/urwid/urwid/pull/1563RadioButton.selected_button by @penguinolog in https://github.com/urwid/urwid/pull/1562Edit signal "cancel", sent on the menu key (Esc) by @penguinolog in https://github.com/urwid/urwid/pull/1582ListBox(edge="stop"): Up and Down stop at the ends of the list instead of leaving it by @penguinolog in https://github.com/urwid/urwid/pull/1583TreeWidget.Symbols (TreeSymbols), tree icons of any width, TreeWidget.leaf_icon and connector lines by @penguinolog in https://github.com/urwid/urwid/pull/1571MouseButton: named mouse buttons, including the horizontal wheel and the back and forward buttons by @penguinolog in https://github.com/urwid/urwid/pull/1579Screen.set_title() for the terminal window title; the raw display restores the previous title on stop by @penguinolog in https://github.com/urwid/urwid/pull/1578Screen.copy_to_clipboard() over OSC 52 by @penguinolog in https://github.com/urwid/urwid/pull/1580InputClosedError, a RuntimeError the raw display raises when its input reaches end of file by @penguinolog in https://github.com/urwid/urwid/pull/1581BaseScreen.palette, a read-only view of the registered palette, and register_palette(..., replace=True) by @penguinolog in https://github.com/urwid/urwid/pull/1588urwid.display.lcd, for removal in 6.0 by @penguinolog in https://github.com/urwid/urwid/pull/1587Pile rows from the cursor and keys by @charan-rathore in https://github.com/urwid/urwid/pull/1543Pile rows and Columns columns in focus moves by @penguinolog in https://github.com/urwid/urwid/pull/1545Columns focus only to columns the last layout drew: a Columns wider than the screen no longer scrolls to a hidden column by keys by @penguinolog in https://github.com/urwid/urwid/pull/1550Pile row heights the same for every focus position, and redraw a container when a child it did not draw changes size by @penguinolog in https://github.com/urwid/urwid/pull/1564Padding.left or Overlay.top by @penguinolog in https://github.com/urwid/urwid/pull/1546Overlay top widget at the width it is rendered at, so its last rows are no longer cut off; render a fixed-only widget in a given-width Padding by @penguinolog in https://github.com/urwid/urwid/pull/1596LineBox by @penguinolog in https://github.com/urwid/urwid/pull/1590LineBox title wider than the box with an ellipsis by @penguinolog in https://github.com/urwid/urwid/pull/1548ListBox completes set_focus() by @penguinolog in https://github.com/urwid/urwid/pull/1544ListBox with no rows is drawn or gets a key by @nk-batman21 in https://github.com/urwid/urwid/pull/1552ScrollBar end markers only from 4 rows by @penguinolog in https://github.com/urwid/urwid/pull/1558DropDown with a single option read-only by @penguinolog in https://github.com/urwid/urwid/pull/1560RadioButton is created selected by @penguinolog in https://github.com/urwid/urwid/pull/1577BarGraph rows for interleaved segments of adjacent bars, which raised BarGraphError or drew the wrong colours by @rahul05ranjan in https://github.com/urwid/urwid/pull/1538IEXTEN and FLUSHO in the raw and curses displays, so ctrl v, ctrl o and ctrl y reach the application on macOS and the BSDs by @penguinolog in https://github.com/urwid/urwid/pull/1589Terminal pty watch by its handle, which left the watch registered on tornado and raised AttributeError on trio by @penguinolog in https://github.com/urwid/urwid/pull/1568watch_file() and watch_pipe() callbacks in the main loop of a screen without event loop support, such as curses by @penguinolog in https://github.com/urwid/urwid/pull/1569MainLoop again by @penguinolog in https://github.com/urwid/urwid/pull/1575Overlay, Frame or ListBox without a cycle collection after its contents was read, and close only the owned loop when an AsyncioEventLoop is finalised while another asyncio loop runs by @penguinolog in https://github.com/urwid/urwid/pull/1592Pile and Columns sizing loops (up to 19% less time for Pile.rows and keypress) by @penguinolog in https://github.com/urwid/urwid/pull/1595Pile sizing with 0-high rows (27% less time) by @dexhunter in https://github.com/urwid/urwid/pull/1574Overlay rendering (up to 14% less time for nested dialogs) by @penguinolog in https://github.com/urwid/urwid/pull/1596examples/pop_up.py by @penguinolog in https://github.com/urwid/urwid/pull/1598Full Changelog: https://github.com/urwid/urwid/compare/5.0.1...5.1.0
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Full Changelog: https://github.com/urwid/urwid/compare/5.0.0...5.0.1
…set_terminal_properties(hyperlinks=True) ); see "Breaking Changes" above by @penguinolog in #1415
Text.get_text() carry LayeredAttr for nested attributes, custom screens have to call BaseScreen.resolve_attr() instead of reading the palette, and an attribute an AttrMap maps to None shows the map's None attribute by @penguinolog in #1409AttrSpec foreground and background default to 'inherit'; also a new feature, see "Major features" below: Draw OSC 8 hyperlinks from display attributes by @penguinolog in #1415Columns, Pile, GridFlow, Frame and ListBox get_focus/set_focus methods and 1.1-era list attributes, the Frame header/body/footer getters and setters, ListBox.contents() called as a method, content_delta, shards_delta, shard_cviews_delta, BaseScreen.run_wrapper, font.add_font, WidgetWrap._set_w, AttrWrap.w and Filler.body; MonitoredDeque.insert() with an index without __index__ raises TypeError by @penguinolog in #1402vterm escape compatibility constants and plain-tuple CSI_COMMANDS entries, return WHSettings members from Pile.options() for 'given' and 'weight', and require typing_extensions on Python older than 3.13; also see "Deprecations" below: Unify deprecation warnings and removal versions by @penguinolog in #1421urwid.graphics by @penguinolog in #1163ANSIText keeps bold as a setting of its own: ESC[1;31m is 'dark red,bold', no longer 'light red,bold'; also a new feature, see "New features" below: Read the raw display's attributes back in ANSIText by @penguinolog in #1502colors capability of the terminfo entry raises the count (mintty, vscode and others from 16 to 256); also a new feature, see "New features" below: Read colour depth from terminfo in the raw display by @penguinolog in #1464MonitoredList written at protocol 2 or higher no longer load in older urwid releases; also a new feature, see "New features" below: Make focus lists and list walkers picklable by @penguinolog in #1469Terminal returns a key with no TERM=linux form (shift up, meta f5, focus in) unhandled instead of typing its name into the child; also bug fixes, see "Bug fixes" below by @luantaraschi in #1473 and by @penguinolog in #1498os module has no O_NOFOLLOW and its ASCII and Latin-1 codecs ignore registered error handlers. GraalPy 3.12 stays experimental, and GraalPy 3.13 is listed as experimental too by @penguinolog in #1510Hyperlink, AttrSpec(hyperlink=...), set_terminal_properties(hyperlinks=True)); see "Breaking Changes" above by @penguinolog in #1415Screen(extended_keys=True) tells ctrl i from tab and ctrl enter from enter, and adds the super and hyper modifiers by @penguinolog in #1504urwid.testing: render widgets to text and attribute runs, check their sizing, feed keys and mouse events, and run a MainLoop on ScriptedScreen without a terminal by @penguinolog in #1481MainLoop.paused() to run another program, such as $EDITOR, in the terminal by @penguinolog in #1485Pile, Columns, Frame, ListBox and GridFlow created with select_navigation=True move the focus on tab, shift tab, ctrl n and ctrl p; SelectNavigationMixin and SelectNavigationListContentsMixin give other containers the same behaviour by @penguinolog in #1478detect_term_colors(); see "Breaking Changes" above by @penguinolog in #1464 and in #1466set_ascii_fallbacks() for characters the encoding rejects by @penguinolog in #1479CommandMap.bind() that refuses a key bound twice by @penguinolog in #1472close_on_menu, pop_up_widget and launcher_size by @penguinolog in #1513ListBox.scroll_to_top(), scroll_to_bottom() and focus_next_match() by @penguinolog in #1514Edit.set_edit_text(..., edit_pos=...), the Edit signal "submit" and readline editing commands for Edit by @penguinolog in #1515follow_end to SimpleFocusListWalker, SimpleFocusDequeWalker, MonitoredFocusList and MonitoredFocusDeque by @penguinolog in #1516Text(..., selectable=True), SelectableIcon(cursor_position=None) and Button left, right and cursor_position by @penguinolog in #1517WidgetDisable(..., disabled=False) and a settable WidgetDisable.disabled property by @penguinolog in #1518LineBox titles accept text markup: LineBox(w, title=[("key", "F1"), " Help"]) and set_title() by @penguinolog in #1519ListBox(..., focus_when_empty=False), so an empty list does not take the focus, and an opt-in delegate_selectable that makes ScrollBar and Scrollable report the wrapped widget's selectable() by @penguinolog in #1520Thin5x4Font BigText font, letters for HalfBlock6x5Font and HalfBlockHeavy6x5Font, and the missing ASCII punctuation for every BigText font that has letters by @penguinolog in #1521Edit(..., max_length=None) and a settable Edit.max_length property: a key that would go over it is returned unhandled, and longer text from the constructor, set_edit_text() or insert_text(), or a limit below the current text, raises ValueError by @penguinolog in #1524"focus changed" signal to Pile, Columns and GridFlow, sent with the old and the new focus position after the focus moved, and MonitoredFocusList.set_focus_moved_callback() by @penguinolog in #1528reverse in positions() of the Simple*ListWalker and Simple*DequeWalker classes (removal in 8.0) by @penguinolog in #1451_MOUSE_*_FLAG constants in favour of MouseBit (removal in 6.0) by @penguinolog in #1500shard_tail gap errors from canvas shards of no rows by @penguinolog in #1483rows_max cache and overlays of rowless canvases by @penguinolog in #1486TERM=linux defines them; see "Breaking Changes" above by @penguinolog in #1498__del__ by @penguinolog in #1417/dev/tty on macOS, which kqueue refuses with EINVAL, in SelectEventLoop and the raw display by falling back to select() by @penguinolog in #1522wrap_around walker in ListBox by @penguinolog in #1495base_widget at mock objects by @penguinolog in #1468typing.Generic and failed by @penguinolog in #1510GridFlow mouse event as handled only when a cell handled it or the focus moved, so a parent ListBox scrolls on the wheel over it; a click on empty space now reaches unhandled_input, as for Pile and Columns by @penguinolog in #1526Frame and Overlay get_cursor_coords() and get_focus_path() no longer crash on a missing focus part or a top widget without a cursor, Columns.pack(()) raises ColumnsError, an unknown focus_column raises ValueError, TreeListBox.focus_end() and Filler.move_cursor_to_coords() no longer use the column count as the row count, Overlay rejects clip and weight widths and flow and weight heights, and Pile and Columns reject a float 'given' amount by @penguinolog in #1443(GIVEN, 0), which is not drawn, when the arrow keys or Tab move the focus in Pile, Columns and GridFlow by @penguinolog in #1526Edit cursor before "postchange" is sent for an editing key, through set_edit_pos() so that an override still sees every move by @penguinolog in #1523Edit with wrap="ellipsis" to the cursor: the row with the cursor is clipped and the other rows keep their ellipsis by @penguinolog in #1523IntEdit change signals at most once per key: not again for the leading zeros it removes, and not at all when the text stays the same by @penguinolog in #15230, S, I and | of the BigText fonts apart from O, 5 and l, which they matched, and slope the Half Block 5x4 backtick the right way by @penguinolog in #1521socket.sendall() requires, watch the LCD serial port by its fileno(), and stop split_repr from recursing in subclasses by @penguinolog in #1410tty_signal_keys(start="undefined", stop="undefined") by @penguinolog in #1293Note truncated.
Deprecate non-integer index in deque insert() by @penguinolog in https://github.com/urwid/urwid/pull/1399
_sigcont_handler (removal in 5.0); also a bug fix, see "Major bug fixes" below: Do terminal signal work in the input loop, not in handlers by @penguinolog in https://github.com/urwid/urwid/pull/1369ValueError from select() on descriptors numbered 1024 or higher by @penguinolog in https://github.com/urwid/urwid/pull/1373ANSIText spends on untrusted output (cursor moves, padding, long CSI and OSC sequences); out-of-range SGR colours are ignored instead of raising by @penguinolog in https://github.com/urwid/urwid/pull/1382str and bytes by @penguinolog in https://github.com/urwid/urwid/pull/1386Edit from exposing its text in repr() and in ValueError; refuse control characters as input; stop IntEdit from accepting more digits than int() can convert by @penguinolog in https://github.com/urwid/urwid/pull/1387RecursionError on deep trees, TreeWidgetError instead of an endless loop on a cycle, faster sibling lookup (up to 98% less time), and cached nodes of removed keys are freed by @penguinolog in https://github.com/urwid/urwid/pull/1389_sigcont_handler, see "Deprecations" by @penguinolog in https://github.com/urwid/urwid/pull/1369ZMQEventLoop.watch_file() with a ZMQ socket (raised KeyError), and remove a watch by either the object or its descriptor number by @penguinolog in https://github.com/urwid/urwid/pull/1371draw_screen from spinning at full CPU forever after the terminal can no longer be written to (hangup, broken pipe) by @penguinolog in https://github.com/urwid/urwid/pull/1375run(), so an unrelated task exception no longer stops the application's own loop by @penguinolog in https://github.com/urwid/urwid/pull/1376watch_pipe: no second read task on a pipe that is still readable, no double close of a descriptor that may belong to another file, and no full-CPU spin at end of file (the callback gets b"" once and the watch is removed) by @penguinolog in https://github.com/urwid/urwid/pull/1380ListBox repeating items when a wrapping walker is shorter than the available height by @charan-rathore in https://github.com/urwid/urwid/pull/1381ListBox hangs and slowdowns with many 0-height widgets (up to 98% less time), scrolling keys that never ended on wrapping bodies, ListBoxError from page up, page down and end, and ListBox objects kept alive by their walker by @penguinolog in https://github.com/urwid/urwid/pull/1383GridFlow display widgets on each focus change) were never freed by @penguinolog in https://github.com/urwid/urwid/pull/1393These problems need an unusual setup, an error path, or input from outside the normal range of values.
SelectEventLoop and ZMQEventLoop by @penguinolog in https://github.com/urwid/urwid/pull/1370MainLoop when its event loop or start() fails: remove the idle callback and watches, and restore the terminal mode and screen buffer by @penguinolog in https://github.com/urwid/urwid/pull/1374Columns, and fix overflow errors from widely different weights by @penguinolog in https://github.com/urwid/urwid/pull/1384Pile, and fix overflow errors from large or widely different weights by @penguinolog in https://github.com/urwid/urwid/pull/1385ProgressBar correctly when current or done is negative, zero, NaN, infinite or too large for a float by @penguinolog in https://github.com/urwid/urwid/pull/1388BarGraph and GraphVScale rendering when top is zero or NaN, or a value, line or label is NaN, infinite or too large by @penguinolog in https://github.com/urwid/urwid/pull/1390connect or disconnect_by_key by @penguinolog in https://github.com/urwid/urwid/pull/1391GridFlow, Pile, Columns, MonitoredFocusList, MonitoredFocusDeque, RadioButton), instead of continuing with stale indexes by @penguinolog in https://github.com/urwid/urwid/pull/1397Full Changelog: https://github.com/urwid/urwid/compare/4.2.4...4.2.5
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Full Changelog: https://github.com/urwid/urwid/compare/4.2.3...4.2.4
2026-10-01
Fix Text.pack() wrapping a line after a tab stop by @penguinolog in https://github.com/urwid/urwid/pull/1364
Fix ListBox focus restore on a shrunk body by @penguinolog in https://github.com/urwid/urwid/pull/1365
Full Changelog: https://github.com/urwid/urwid/compare/4.2.3...4.2.4
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Full Changelog: https://github.com/urwid/urwid/compare/4.2.2...4.2.3
2026-09-30
Fix Pile, Columns and GridFlow selectable flag caching by @penguinolog in https://github.com/urwid/urwid/pull/1362
Full Changelog: https://github.com/urwid/urwid/compare/4.2.2...4.2.3
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
AttrMap setters to accept parameters like constructor does by @penguinolog in https://github.com/urwid/urwid/pull/1357Full Changelog: https://github.com/urwid/urwid/compare/4.2.1...4.2.2
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Text render fail and 0 is valid tab size by @penguinolog in https://github.com/urwid/urwid/pull/1354Full Changelog: https://github.com/urwid/urwid/compare/4.2.0...4.2.1
2026-09-29
Fix: Empty Text render fail and 0 is valid tab size by @penguinolog in https://github.com/urwid/urwid/pull/1354
Full Changelog: https://github.com/urwid/urwid/compare/4.2.0...4.2.1
Deprecate monkeypatch of displays by HtmlGenerator by @penguinolog in https://github.com/urwid/urwid/pull/1352
<!-- Release notes generated using configuration in .github/release.yml at master -->
Full Changelog: https://github.com/urwid/urwid/compare/4.1.7...4.2.0
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Full Changelog: https://github.com/urwid/urwid/compare/4.1.6...4.1.7
2026-09-23
Make Text's line translation cache safe for concurrent readers by @penguinolog in https://github.com/urwid/urwid/pull/1338
Full Changelog: https://github.com/urwid/urwid/compare/4.1.6...4.1.7
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Full Changelog: https://github.com/urwid/urwid/compare/4.1.5...4.1.6
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Full Changelog: https://github.com/urwid/urwid/compare/4.1.4...4.1.5
Clarify deprecation warnings by @penguinolog in https://github.com/urwid/urwid/pull/1310
<!-- Release notes generated using configuration in .github/release.yml at master -->
Frame.contents.iter() / len(Frame.contents) by @penguinolog in https://github.com/urwid/urwid/pull/1303Full Changelog: https://github.com/urwid/urwid/compare/4.1.3...4.1.4
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Full Changelog: https://github.com/urwid/urwid/compare/4.1.2...4.1.3
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
raises to docstrings by @penguinolog in https://github.com/urwid/urwid/pull/1286Full Changelog: https://github.com/urwid/urwid/compare/4.1.1...4.1.2
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
SIGTSTP handler for POSIX RAW display and explain behaviour by @penguinolog in https://github.com/urwid/urwid/pull/1271Full Changelog: https://github.com/urwid/urwid/compare/4.1.0...4.1.1
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
ANSIText widget by @penguinolog in https://github.com/urwid/urwid/pull/1265
ANSIText is a Text like widget containing parsed ANSI text including color/style information and basic flags as bel/leds/title.Full Changelog: https://github.com/urwid/urwid/compare/4.0.13...4.1.0
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Full Changelog: https://github.com/urwid/urwid/compare/4.0.12...4.0.13
2026-08-25
Display attributes: add faint text support by @ChrisJr404 in https://github.com/urwid/urwid/pull/1249
Fix sizing related issues by @penguinolog in https://github.com/urwid/urwid/pull/1250
@ChrisJr404 made their first contribution in https://github.com/urwid/urwid/pull/1249
Full Changelog: https://github.com/urwid/urwid/compare/4.0.12...4.0.13
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Full Changelog: https://github.com/urwid/urwid/compare/4.0.11...4.0.12
2026-08-25
Text layout: do not crash when a wide character is clipped on both sides by @luantaraschi in https://github.com/urwid/urwid/pull/1241
Fix web display init by @penguinolog in https://github.com/urwid/urwid/pull/1243
Full Changelog: https://github.com/urwid/urwid/compare/4.0.11...4.0.12
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Padding in GridFlow by @penguinolog in https://github.com/urwid/urwid/pull/1231Full Changelog: https://github.com/urwid/urwid/compare/4.0.10...4.0.11
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
ListWalker API in ListBox calls by @penguinolog in https://github.com/urwid/urwid/pull/1227Full Changelog: https://github.com/urwid/urwid/compare/4.0.9...4.0.10
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
WidgetContainerListContentsMixin typing by @penguinolog in https://github.com/urwid/urwid/pull/1210Full Changelog: https://github.com/urwid/urwid/compare/4.0.8...4.0.9
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Full Changelog: https://github.com/urwid/urwid/compare/4.0.7...4.0.8
2026-07-26
Fix MRO for SimpleFocusListWalker: wrong order causes delayed invalidate by @penguinolog in https://github.com/urwid/urwid/pull/1204
Full Changelog: https://github.com/urwid/urwid/compare/4.0.7...4.0.8
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
MainLoop and signals by @penguinolog in https://github.com/urwid/urwid/pull/1199ListBox expected widget API by @penguinolog in https://github.com/urwid/urwid/pull/1200treetools by @penguinolog in https://github.com/urwid/urwid/pull/1197Full Changelog: https://github.com/urwid/urwid/compare/4.0.6...4.0.7
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Implemented protocol base classes AbstractWidget and internal AbstractBoxWidget, AbstractFlowWidget and AbstractFixedWidget for protocol based typing.
All classes implementing AbstractWidget are considered valid widget (as all required APIs available).
Container widgets as Columns, Pile, GridFlow, Frame, Overlay and Padding now declare expected APIs from widgets depends on sizing parameter in __init__.
AbstractWidget abstract base class/protocol by @penguinolog in https://github.com/urwid/urwid/pull/1196Full Changelog: https://github.com/urwid/urwid/compare/4.0.5...4.0.6
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
_scrollbar_layout and left click handling for Scrollable by @penguinolog in https://github.com/urwid/urwid/pull/1192Filler typing annotations by @penguinolog in https://github.com/urwid/urwid/pull/1183Edit widget to use WidgetWrap as base class and update methods by @penguinolog in https://github.com/urwid/urwid/pull/1180Full Changelog: https://github.com/urwid/urwid/compare/4.0.4...4.0.5
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Full Changelog: https://github.com/urwid/urwid/compare/4.0.3...4.0.4
Deprecation: Deprecate content_delta as unused by @penguinolog in https://github.com/urwid/urwid/pull/1151
<!-- Release notes generated using configuration in .github/release.yml at master -->
content_delta as unused by @penguinolog in https://github.com/urwid/urwid/pull/1151shard_body_row: falsy content_iter raises ValueError by @penguinolog in https://github.com/urwid/urwid/pull/1162Full Changelog: https://github.com/urwid/urwid/compare/4.0.2...4.0.3
2026-06-25
Deprecate content_delta as unused by @penguinolog in https://github.com/urwid/urwid/pull/1151
Fix shard_body_row: falsy content_iter raises ValueError by @penguinolog in https://github.com/urwid/urwid/pull/1162
Mass typing annotations fixes.
Full Changelog: https://github.com/urwid/urwid/compare/4.0.2...4.0.3
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
urwid.display and urwid.event_loop by @penguinolog in https://github.com/urwid/urwid/pull/1138urwid.display by @penguinolog in https://github.com/urwid/urwid/pull/1139urwid.widget by @penguinolog in https://github.com/urwid/urwid/pull/1142urwid.widget.scrollable by @penguinolog in https://github.com/urwid/urwid/pull/1143Full Changelog: https://github.com/urwid/urwid/compare/4.0.1...4.0.2
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Full Changelog: https://github.com/urwid/urwid/compare/4.0.0...4.0.1
Deprecation: Remove deprecated protected methods for version 4 by @penguinolog in https://github.com/urwid/urwid/pull/1078
<!-- Release notes generated using configuration in .github/release.yml at master -->
Filler.get_body and Filler.set_body by @penguinolog in https://github.com/urwid/urwid/pull/1117Full Changelog: https://github.com/urwid/urwid/compare/3.0.5...4.0.0
Un-deprecate user_arg for signals by @penguinolog in https://github.com/urwid/urwid/pull/1092
<!-- Release notes generated using configuration in .github/release.yml at master -->
user_arg for signals by @penguinolog in https://github.com/urwid/urwid/pull/1092Full Changelog: https://github.com/urwid/urwid/compare/3.0.4...3.0.5
Fix CheckBox DeprecationWarning: Use user_args instead of user_arg by @sawdmn in https://github.com/urwid/urwid/pull/1079
<!-- Release notes generated using configuration in .github/release.yml at master -->
Full Changelog: https://github.com/urwid/urwid/compare/3.0.3...3.0.4
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Full Changelog: https://github.com/urwid/urwid/compare/3.0.2...3.0.3
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Full Changelog: https://github.com/urwid/urwid/compare/3.0.1...3.0.2
2025-05-07
Bugfix: Corner case: Scrollbar render for only 1 row height by @penguinolog in https://github.com/urwid/urwid/pull/1021
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
setup.py lead to wrong metadata and mark of release 3.0.0 as Python 3.7 compatible.
Since urwid is distribluted in the pre-packaged format (wheel),
missing setup.py will not affect old toolchain users except special cases (manually enforced sdist usage).AsyncioEventLoop by @penguinolog in https://github.com/urwid/urwid/pull/1019Full Changelog: https://github.com/urwid/urwid/compare/3.0.0...3.0.1
Drop deprecated __super property by @penguinolog in https://github.com/urwid/urwid/pull/956
<!-- Release notes generated using configuration in .github/release.yml at master -->
__super property by @penguinolog in https://github.com/urwid/urwid/pull/956FlowWidget, BoxWidget and FixedWidget widgets by @penguinolog in https://github.com/urwid/urwid/pull/955Canvas and AttrSpec by @penguinolog in https://github.com/urwid/urwid/pull/958bytes based fonts by @penguinolog in https://github.com/urwid/urwid/pull/961TermScroller by @penguinolog in https://github.com/urwid/urwid/pull/960_set_done from the ProgressBar by @penguinolog in https://github.com/urwid/urwid/pull/971CommandMap MutableMapping by @penguinolog in https://github.com/urwid/urwid/pull/969MetaSignals subclass ABCMeta by @penguinolog in https://github.com/urwid/urwid/pull/962MetaSuper should be the last base for classes by @penguinolog in https://github.com/urwid/urwid/pull/972Pile by @penguinolog in https://github.com/urwid/urwid/pull/1006Full Changelog: https://github.com/urwid/urwid/compare/2.6.16...3.0.0
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Full Changelog: https://github.com/urwid/urwid/compare/2.6.15...2.6.16
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
ListBox.rows_max calculation for empty container by @penguinolog in https://github.com/urwid/urwid/pull/910Full Changelog: https://github.com/urwid/urwid/compare/2.6.14...2.6.15
2024-07-03
Fix ListBox.rows_max calculation for empty container by @penguinolog in https://github.com/urwid/urwid/pull/910
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Full Changelog: https://github.com/urwid/urwid/compare/2.6.13...2.6.14
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
ExceptionGroup handling without an external library in python 3.11+ by @penguinolog in https://github.com/urwid/urwid/pull/894Full Changelog: https://github.com/urwid/urwid/compare/2.6.12...2.6.13
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Full Changelog: https://github.com/urwid/urwid/compare/2.6.11...2.6.12
Do not use deprecated positioning in the code and examples by @penguinolog in https://github.com/urwid/urwid/pull/869
<!-- Release notes generated using configuration in .github/release.yml at master -->
Widget.rows annotation by @penguinolog in https://github.com/urwid/urwid/pull/874Full Changelog: https://github.com/urwid/urwid/compare/2.6.10...2.6.11
2024-04-22
Fix Widget.rows annotation by @penguinolog in https://github.com/urwid/urwid/pull/874
Do not use deprecated positioning in the code and examples by @penguinolog in https://github.com/urwid/urwid/pull/869
Docs: partial update of screenshots by @penguinolog in https://github.com/urwid/urwid/pull/873
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
ScrollBar: fully support __length_hint__ if not Sized by @penguinolog in https://github.com/urwid/urwid/pull/863Full Changelog: https://github.com/urwid/urwid/compare/2.6.9...2.6.10
2024-03-25
ScrollBar: fully support __length_hint__ if not Sized by @penguinolog in https://github.com/urwid/urwid/pull/863
Support PEP424 API as marker for limited size of ListBox body by @penguinolog in https://github.com/urwid/urwid/pull/861
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
ListBox by @penguinolog in https://github.com/urwid/urwid/pull/858
Absolute scrolling calculation is resource-hungry and can cause serious issues on the long lists.
This change also rework calculation allowing to use ScrollBar with TreeList (users should prevent infinite load cycle on lazy-load self).<shift> key reading for sgrmouse by @penguinolog in https://github.com/urwid/urwid/pull/859
Historically <shift> key reading was not implemented due to <shift><click> for buttons 1-3 is handled by the most GUI terminal emulators itself.TreeWidget: original widget can be overridden by @penguinolog in https://github.com/urwid/urwid/pull/860Full Changelog: https://github.com/urwid/urwid/compare/2.6.8...2.6.9
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Full Changelog: https://github.com/urwid/urwid/compare/2.6.7...2.6.8
2024-03-04
Fix regression: Overlay not accepted relative positioning by @penguinolog in https://github.com/urwid/urwid/pull/854
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
MainLoop.watch_pipe regression for the callback outcome not False by @penguinolog in https://github.com/urwid/urwid/pull/848min in GridFlow.generate_display_widget by @penguinolog in https://github.com/urwid/urwid/pull/849Full Changelog: https://github.com/urwid/urwid/compare/2.6.6...2.6.7
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
__repr__ and rich repr for the sized containers by @penguinolog in https://github.com/urwid/urwid/pull/844Full Changelog: https://github.com/urwid/urwid/compare/2.6.5...2.6.6
2024-02-27
Fix Columns sizing and pack behavior by @penguinolog in https://github.com/urwid/urwid/pull/846
Extend __repr__ and rich repr for the sized containers by @penguinolog in https://github.com/urwid/urwid/pull/844
TreeWidget: do not use deprecated API in update_expanded_icon by @penguinolog in https://github.com/urwid/urwid/pull/832
<!-- Release notes generated using configuration in .github/release.yml at master -->
wcwidth to select unicode version by @penguinolog in https://github.com/urwid/urwid/pull/840TreeWidget: do not use deprecated API in update_expanded_icon by @penguinolog in https://github.com/urwid/urwid/pull/832monitored_list module to the widgets package by @penguinolog in https://github.com/urwid/urwid/pull/833listbox & treetools modules to the widgets by @penguinolog in https://github.com/urwid/urwid/pull/834Columns/Pile empty - use fallback sizing by @penguinolog in https://github.com/urwid/urwid/pull/843Full Changelog: https://github.com/urwid/urwid/compare/2.6.4...2.6.5
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
ListBox used for tree implementation. by @penguinolog in https://github.com/urwid/urwid/pull/829Full Changelog: https://github.com/urwid/urwid/compare/2.6.3...2.6.4
2024-02-21
Fix regression from 2.6.1: ListBox used for tree implementation. by @penguinolog in https://github.com/urwid/urwid/pull/829
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
float by @penguinolog in https://github.com/urwid/urwid/pull/827Full Changelog: https://github.com/urwid/urwid/compare/2.6.2...2.6.3
2024-02-21
Fix regression from 2.6.2: weight can be float by @penguinolog in https://github.com/urwid/urwid/pull/827
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Widget instance as Frame focus part in constructor by @penguinolog in https://github.com/urwid/urwid/pull/820EventLoop.run_in_executor should accept **kwargs by @penguinolog in https://github.com/urwid/urwid/pull/822Columns and Pile by @penguinolog in https://github.com/urwid/urwid/pull/825layout without pack by @penguinolog in https://github.com/urwid/urwid/pull/819ListBox render crash if empty elements in tail by @penguinolog in https://github.com/urwid/urwid/pull/824Full Changelog: https://github.com/urwid/urwid/compare/2.6.1...2.6.2
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Full Changelog: https://github.com/urwid/urwid/compare/2.6.0...2.6.1
2024-02-16
Fix a scenario with ellipsis wrap not fit in screen columns by @penguinolog in https://github.com/urwid/urwid/pull/813
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Fix CI to upload wheel package.
Full Changelog: https://github.com/urwid/urwid/compare/2.6.0...2.6.0.post0
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
It became a blocker for the future correct Unicode support and caused pain for some of end users building package separately.
LineBox._w: should be a property by @penguinolog in https://github.com/urwid/urwid/pull/804MAX_LEFT/MAX_RIGHT report for keypress as unhandled by @penguinolog in https://github.com/urwid/urwid/pull/810Full Changelog: https://github.com/urwid/urwid/compare/2.5.3...2.6.0
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Full Changelog: https://github.com/urwid/urwid/compare/2.5.2...2.5.3
2024-02-12
Fix render regression: khal Padding width > size by @penguinolog in https://github.com/urwid/urwid/pull/798
Update unicode table to the version 15.1.0 by @penguinolog in https://github.com/urwid/urwid/pull/744
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Text/Edit by @penguinolog in https://github.com/urwid/urwid/pull/793TextCanvas typing by @penguinolog in https://github.com/urwid/urwid/pull/794Full Changelog: https://github.com/urwid/urwid/compare/2.5.1...2.5.2
<!-- Release notes generated using configuration in .github/release.yml at master -->
<!-- Release notes generated using configuration in .github/release.yml at master -->
Columns & Pile by @penguinolog in https://github.com/urwid/urwid/pull/778Widget inheritance in the LineBox by @penguinolog in https://github.com/urwid/urwid/pull/780Canvas.content by @penguinolog in https://github.com/urwid/urwid/pull/784WidgetWrap and WidgetDecoration Generic by @penguinolog in https://github.com/urwid/urwid/pull/777Full Changelog: https://github.com/urwid/urwid/compare/2.5.0...2.5.1
Update examples: reduce amount of deprecated parameters by @penguinolog in https://github.com/urwid/urwid/pull/769
<!-- Release notes generated using configuration in .github/release.yml at master -->
Scrollable and ScrollBar made by @rndusr with fixes from @markqvist was added to the urwid.ScrollBar to the ListBox widget.
While scrolling is done by the ListBox itself (as before), the ScrollBar can display progress.BOX_SYMBOLS, BAR_SYMBOLS, SHADE_SYMBOLS)
and exposed in several widgets via Symbols enum on the class level: Divider, LineBox and ScrollBar.Full Changelog: https://github.com/urwid/urwid/compare/2.4.6...2.5.0
One column per quarter.