Gooey converts command-line applications into graphical programs by generating an interface from their argument definitions. It works with applications that use argparse, examining the declared arguments and mapping them to graphical controls. Developers can attach Gooey to an existing program using a decorator, allowing its command-line functionality to remain accessible while also providing a graphical way to configure and execute it.
The library is particularly useful for scripts intended for users who are unfamiliar with terminal commands. Rather than requiring users to remember option names and argument syntax, Gooey presents input fields, selection controls and other interface elements corresponding to the program’s parameters. Once the user has supplied the necessary information, Gooey constructs the command and executes the underlying application. This approach allows a single application to serve both command-line workflows and users who prefer graphical interaction, without maintaining two independent implementations of its core functionality.
This is free and open source software.
Key Features
- Automatically generates graphical interfaces from argparse argument definitions.
- Integrates with existing applications through the @Gooey decorator.
- Maps command-line arguments to text fields, checkboxes, dropdowns and radio buttons.
- Provides GooeyParser for explicitly selecting graphical widgets for individual arguments.
- Offers file, directory, date, time and colour selection controls.
- Supports password fields, sliders, list boxes and numeric input controls.
- Provides configurable form layouts, including columns, tabs and grouped controls.
- Supports input validation with configurable widget behaviour.
- Allows custom application names, descriptions, icons and window dimensions.
- Supports multiple commands and subcommand navigation.
- Can automatically start execution without displaying a configuration screen.
- Displays application output, execution status and error information.
- Provides graphical progress indicators based on application output.
- Supports configurable success and error screens.
- Allows application interface translations through external language files.
- Can save and load generated application configuration data.
- Cross-platform support – runs on Linux, macOS, and Windows.
Website: github.com/chriskiehl/Gooey
Support:
Developer: Chris Kiehl
License: MIT License
Gooey is written in Python. Learn Python with our recommended free books and free tutorials.
Related Software
| Command-Line Python Application Development Tools | |
|---|---|
| Python Fire | Library for automatically generating command line interfaces |
| argparse | Parser for command-line options, arguments and sub-commands |
| Click | Create beautiful command line interfaces in a composable way |
| Typer | Library for building CLI applications |
| Rich | Python library for rich text and beautiful formatting |
| alive-progress | Progress bar, with real-time throughput |
| Gooey | Convert console programs into end-user-friendly GUI software |
| Python Prompt Toolkit | Build powerful interactive command line and terminal applications |
| tqdm | Fast, extensible progress bar for Python and CLI |
| Asciimatics | Create full-screen text UIs from interactive forms to ASCII animations |
| Cement | CLI application framework for Python |
| docopt | Command-line interface description language |
| cliff | Framework for building command line programs |
| Cyclopts | Framework for building command-line interfaces |
Read our verdict in the software roundup.
LinuxLinks helps you discover the best free and open source software for Linux. Explore our extensive collection of recommended applications, including alternatives to popular proprietary software.We also publish software reviews, Linux tutorials, hardware reviews, free programming books and articles covering the wider open source community. Browse our Linux resources to discover more. Know a useful free and open source Linux application we haven't covered? Suggest a program for inclusion. Has your software been featured on LinuxLinks? Display one of our Featured on LinuxLinks badges on your website or GitHub README. |


Please read our Comment Policy before commenting.