Skip to content

Bash library to generate text-based user interfaces such as forms and menus

License

Notifications You must be signed in to change notification settings

angeltoast/lister

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Lister

A BASH script containing a library of functions to generate user interfaces - especially menus and picklists, but also forms, buttons, etc, and all without using Dialog, Yad, Whiptail, Zenity, etc.

Now including a simple enum function and a function to print up to four columns of interactive radio buttons.

This project was originally called Listgen. If you have Listgen as part of any existing projects, they should still continue to work as before, but do not replace Listgen with Lister - the scripts have been completely rewritten, and it uses different references, so it will not be compatible with your code. Consequently, if you are using Listgen, and do not want to change the code you are using to reference it, then you should stay with Listgen. However, Lister is more efficient, and has more features, so any new projects will benefit from making the change.

The interfaces provided by Lister are intentionally more basic than Dialog and the others. The Lister interfaces use no colours, and do not draw pretty boxes; they are intended for tasks where a more graphical interface is simply not possible. This means that they can be used on older or lower powered hardware - wherever Linux is installed. They are written entirely in BASH, and are GNU licensed, so you can edit them to suit your purposes.

The Lister module is self-contained and application-independent. It initialises all its own variables, and contains all the functions it needs; any of the functions may be called independently from any scripts. You only have to put a copy of the lister.sh module in the same location as your scripts, and source it, to be able to add all the features of Lister to your scripts.

As of 2021/08/25 Lister has been assigned version 2.00 following changes to the global variables used to communicate with other applications, making it incompatible with applications written to use any previous versions. These changes are: The variable 'GlobalChar' used to pass string values is now called 'Gstring'; The variable 'GlobalInt' used to pass numeric values is now called 'Gnumber'; The variable 'GlobalCursorRow' used to pass the cursor vertical position is now called 'Grow'; A new variable 'Gcol' has been added, to work with 'Grow' by passing horizontal cursor position.

Last updated 2021/08/25 by Elizabeth Mills

About

Bash library to generate text-based user interfaces such as forms and menus

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages