Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (
Help us improve Python packaging - Donate today!

A simple console menu system using curses

Project Description
|Build Status|\ |Documentation Status|


A simple Python menu-based GUI system on the terminal using curses.
Perfect for those times when you need a GUI, but don’t want the overhead
or learning curve of a full-fledged GUI framework.


Tested on Python 2.7, 3.3, 3.4, and 3.5, as well as pypy and pypy 3. Probably works on 2.6 as well.

The curses library comes bundled with python on Linux and MacOS. Windows
users can visit and
get a third-party build for your platform and Python version.

Then just run

.. code:: shell
pip install curses-menu


It’s designed to be pretty simple to use. Here’s an example

.. code:: python

# Import the necessary packages
from cursesmenu import *
from cursesmenu.items import *

# Create the menu
menu = CursesMenu("Title", "Subtitle")
# Create some items
# MenuItem is the base class for all items, it doesn't do anything when selected
menu_item = MenuItem("Menu Item")
# A FunctionItem runs a Python function when selected.
# A CommandItem runs a console command
function_item = FunctionItem("Call a Python function", input, ["Enter an input"])
command_item = CommandItem("Run a console command", "touch hello.txt")
# A SelectionMenu constructs a menu from a list of strings
selection_menu = SelectionMenu(["item1", "item2", "item3"])
# A SubmenuItem lets you add a menu as a submenu of another menu
submenu_item = SubmenuItem("Submenu item", submenu, menu)
# Once we're done creating them, we just add the items to the menu
# Finally, we call show to show the menu and allow the user to interact
# We have to call join ensure that the menu doesn't instantly quit when the main thread exits

.. |Build Status| image::
.. |Documentation Status| image::
Release History

Release History

This version
History Node


History Node


Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting