A Python library to create interactive buttons with keyboard navigation.

pip install interactive_buttons

• Buttons displayed as a matrix.
• Navigation using arrow keys (↑ ↓ → ←).
• Selection using the Enter key.
• Customization of colors, spacing, and decorators.

from interactive_buttons import Button, Component
from colorama import Fore, Back

# Create buttons
buttons = [
    Button(label="A1", value="Value A1"),
    Button(label="A2", value="Value A2"),
    Button(label="B1", value="Value B1"),
    Button(label="B2", value="Value B2"),
]

# Create custom component
component = Component(
    buttons=buttons,
    text_color=Fore.BLACK,
    highlight_color=Back.YELLOW,
    spaces_count=6,
    left_decorator="<",
    right_decorator=">"
)

# Launch the interactive interface
value = component.matrix_buttons()

# Display the selected value
print(f"Selected value: {value}")

• Buttons are displayed in a grid.
• The user navigates with the arrow keys.
• When a button is selected (by pressing Enter), its value is returned and displayed.

• Do not use an emulated terminal (such as VS Code integrated terminal or online consoles): they prevent correct keyboard input capture.

• The library depends on:

  • pynput
  • colorama

Interactive Buttons allows you to create interactive text-based menus. It’s a simple solution for:

• command-line interfaces,
• interactive terminal tools,
• user tests or step-by-step assistants.

Check the GitHub repository for updates and contributions:

👉 https://github.com/mbcraft-exe/interactive_buttons