A micropython library, which supports vertical and horizontal scrolling through menu items on both 2x16 and 4x20 LCDs
| images | ||
| __init__.py | ||
| example_quittable.py | ||
| example_simple.py | ||
| example_submenu.py | ||
| LICENSE | ||
| README.md | ||
| tests.py | ||
lcdMenu
A micropython library, which supports vertical and horizontal scrolling through menu items on both 2x16 and 4x20 liquid crystal displays
This project is the completely rewritten successor of my old (and now archived) ProgramChooser library.
It is now production-ready (tested on 2x16 displays only at the moment.) ToDo: Make the README.md also seem production ready!
Roadmap
- forward, backward and select button
- support for horizontal and vertical scrolling
- support for both 2x16 and 4x20 LCDs
- a reliable order of the menu items
- good documentation for all of this (maybe through examples)
- show an exit screen when a specific exit code is returned by a callback function
- make the menu itself exitable (to enable stuff like submenus, etc.)
- make the project a valid python package
Gallery
Here are some of examples of how a lcdMenu will look, showcasing the amount of options you have with lcdMenu. Currently, as the library is only tested with 2x16 displays, these are the only ones showing up below - but on 4x20, it should look the same except it's bigger!
| Scroll direction | Cycling | Title shown | Initial selection | Result |
|---|---|---|---|---|
| horizontal | yes | yes | first |  |
| vertical | yes | no | first |  |
| vertical | no | no | first |  |
| vertical | no | no | middle |  |
| vertical | no | no | last |  |
| vertical | no | yes | no options (first and last) |  |
| vertical | no | yes | first |  |
| vertical | no | yes | middle |  |
| vertical | no | yes | last |  |
License
This project is licensed under the GPL-v3-or-later. A copy can be found here.