touchy-pad

Host-side Python library and CLI for the Touchy-Pad USB multitouch device.

Install

pip install touchy-pad

You will also need a working libusb-1.0 runtime on your host:

Platform	Command
Debian	`sudo apt install libusb-1.0-0`
macOS	`brew install libusb`
Windows	bundle `libusb-1.0.dll` next to your interpreter

On Linux you also need a udev rule so non-root users can open the device. A starter rule is shipped at ../bin/99-touchy-pad.rules.

CLI

touchy --help              # list subcommands
touchy board-info          # query device board, firmware, protocol version
touchy screen-wake         # turn the backlight on
touchy events              # live-tail events from the device

Library

The supported entry point is touchy_pad.api:

from touchy_pad.api import touchy_open

with touchy_open() as pad:
    print("firmware:", pad.client.sys_version_get().firmware_version_str)

    pad.on_host_event(0x100, lambda e: print("event", e))
    # ...do work; events arrive on a background thread...

See docs/python-api.md for the full guide and docs/python-api/ for auto-generated reference docs (built with just build-docs).

Uploading images

Touchy.file_save accepts any Pillow-readable image (BMP, PNG, JPEG, GIF, WebP) and transparently converts it to LVGL's native .bin format before uploading, so the firmware (which only ships LVGL's built-in bin decoder) can render it without extra config:

with touchy_open() as pad:
    with open("avatar.png", "rb") as f:
        pad.file_save("images/avatar.png", f.read())  # auto-converted

    # Already-converted `.bin` payload, or any non-image bytes, pass
    # through unchanged.
    pad.file_save("screens/home.pb", screen.to_bytes())

Refer to the asset by its upload path (asset="images/avatar.png") when constructing image(...) / image_button(...) widgets — both support scale= and rotation= for runtime transforms, and image_button also takes pressed_asset / pressed_scale / pressed_rotation for a distinct pressed-state look.

Development

See docs/development.md for full setup instructions (dev container or manual), day-to-day just recipes, and git hook details.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

touchy_pad-0.3.4.tar.gz (241.2 kB view details)

Uploaded Jul 17, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

touchy_pad-0.3.4-py3-none-any.whl (264.9 kB view details)

Uploaded Jul 17, 2026 Python 3

File details

Details for the file touchy_pad-0.3.4.tar.gz.

File metadata

Download URL: touchy_pad-0.3.4.tar.gz
Upload date: Jul 17, 2026
Size: 241.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for touchy_pad-0.3.4.tar.gz
Algorithm	Hash digest
SHA256	`f3cbb5d9c87419e9c17b10ca2438a62dda52b803673b09758f2b09c6b91b3c55`
MD5	`54af247a842107f51ab079bb28b0101a`
BLAKE2b-256	`55d8c2bd6b51713aca022ec7e1b5cdb0d8c352f5f53a97435be9129fdccc7610`

See more details on using hashes here.

Provenance

The following attestation bundles were made for touchy_pad-0.3.4.tar.gz:

Publisher: release.yml on geeksville/touchy-pad

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: touchy_pad-0.3.4.tar.gz
- Subject digest: f3cbb5d9c87419e9c17b10ca2438a62dda52b803673b09758f2b09c6b91b3c55
- Sigstore transparency entry: 2191265346
- Sigstore integration time: Jul 17, 2026
Source repository:
- Permalink: geeksville/touchy-pad@e3760678de76aa37324bbeb51af078106fdb9d86
- Branch / Tag: refs/tags/v0.3.4
- Owner: https://github.com/geeksville
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@e3760678de76aa37324bbeb51af078106fdb9d86
- Trigger Event: release