tkeys

Have a touch-screen but you think other system keyboards are overkill?
You just need numeric keyboard?
You want something as simple as possible?

Then just go with tkeys

Features

- tkinter keyboard with only one line of code

- browsing trough all entry widgets of the given parent

- work with grid, pack and place layout manager

- compatible with tkinter button styles (background, foreground colors, fonts etc)

- placement of the keyboard can be changed

Installation

Clone the repo git clone https://github.com/ivandjuricic/tkeys
Browse to directory: ~$: cd tkeys
Install: ~$: python setup.py install

or with pip: ~$: pip install git+https://github.com/ivandjuricic/tkeys

Requirements:

For Python2:

future

For Python3:

you're all set

Usage

Make a tkinter gui. Eg:

from tkinter import *


class Main:
    def __init__(self, master):
        self.master = master
        self.entry_widget1 = Entry(self.master)
        self.entry_widget1.pack()
        self.entry_widget2 = Entry(self.master)
        self.entry_widget2.pack()
        
root = Tk()
app = Main(root)
root.mainloop()

import tkeys keyboard: from tkeys.numeric import NumKeyPad
add NumKeyPad(parent=self.master) to the end of the _init_ of the tkinter GUI class
Code you will look something like this:

from tkinter import *
from tkeys.keyboards import NumKeyPad
# for alphanumeric keyboard use:
from tkeys.keyboards import AlphaNumericKeyPad


class Main:
    def __init__(self, master):
        self.master = master
        self.entry_widget1 = Entry(self.master)
        self.entry_widget1.pack()
        self.entry_widget2 = Entry(self.master)
        self.entry_widget2.pack()
        
        NumKeyPad(parent=self.master)  # or
        # AlphaNumericKeyPad(parent=self.master)
        
root = Tk()
app = Main(root)
root.mainloop()

Uppon running the script when you focus and Entry widget, Numeric keyboard will show up at in UI
Use "←" button as backspace (deletes last key entered)
Use "↵" button when entered correct number to advance to second Entry widget input

Keyboard usage

Two types of keyboard available: Numeric and AlphaNumeric
Since everything is done to be compact, alphanumeric keyboard was built as a telephone keyboard
Two layouts are available: "line" or "grid"
Keyboards can have two way of placement:
- side(bottom or right) - places keyboard to the respective side
- place (relx, rey, anchor) - places keyboard to relative
  - relx: place on relative horizontal(x) position - values from 0 to 1
  - rely: place on relative vertical(y) position - values from 0 to 1
  - anchor: point that will be place to position taken as side of world
    - values= "center", "n", "ne", "e", "se", "s", "sw", "w", "nw"

Keys Styling: You can add styling to keyboards button in the style of tkinter buttons stylings

class Main:
    def __init__(self, master):
        self.master = master
        self.entry_widget1 = Entry(self.master)
        self.entry_widget1.pack()
        self.entry_widget2 = Entry(self.master)
        self.entry_widget2.pack()
        
        NumKeyPad(self.master,
                  layout="line",
                  side="bottom",
                  bg="dark blue",
                  fg="white",
                  font=("tahoma", 20))

Support

Please open an issue for support.

Contributing

Feel free to contribute, add suggestions and comments