tpkbdctl

What is this?

It’s a tool that can be used to control features of the “Lenovo ThinkPad USB Keyboard with TrackPoint”. The official User Guide can be found here: UserGuide (PDF).

Requirements and Limitations

This tool uses the hidraw driver and needs at least Linux 2.6.39 in order to work. Using hidraw it can only write settings, not read them, so you have to set everything at the same time. It also supports the hid-lenovo-tpkbd driver which was merged in Linux 3.6. This driver allows changing the settings via sysfs files, so they can also be read.

On most systems /dev/hidraw* and /sys files are writeable only by root, so you will probably have to run this as root.

Usage

Usage: tpkbdctl [options]

Options:
  -h, --help            show this help message and exit
  -l, --list            List all available devices
  -d DEVICE, --device=DEVICE
                        Specify device. Format as printed with --list
  -s SENSITIVITY, --sensitivity=SENSITIVITY
                        Set trackpoint sensitivity. Range 1-255
  -S SPEED, --press-speed=SPEED
                        Set press-speed. Range 1-255
  -p ?, --press-to-select=?
                        Enable press-to-select? (y/n)
  -R ?, --press-right=?
                        Enable press-right? (y/n)
  -D ?, --dragging=?    Enable dragging? (y/n)
  -r ?, --release-to-select=?
                        Enable release-to-select? (y/n)

Sensitivity

The higher the sensitivity, the less force you need to move the mouse cursor.

Press to select

If this is enabled, pressing down the trackpoint generates a click.

Press-speed

This setting determines how fast you have to press to generate a click if Press to select is enabled.

Dragging

By enabling this, you can not only click by pressing down the trackpoint, but also drag. This depends on Press to select being enabled.

Press right

This changes the Press to select feature to generate right-button clicks instead of left-button ones.

Release to select

This inaptly named option (the name was adopted from the Windows driver) enables double-clicking when using Press to select.

Building and Installing

Make sure you have pip installed. The package is usually called python-pip. Then run:

sudo pip install tpkbdctl

Permanent Setup

TODO

License

This tool is licensed under the GNU GPL v2.

Metadata

Release files for tpkbdctl 0.2.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tpkbdctl 0.2.3
File	Size	Uploaded	Provenance
tpkbdctl-0.2.3.tar.gz	11.7 kB	Jan 13, 2013	Without provenance	Details

Release files / tpkbdctl-0.2.3.tar.gz

Download URL	tpkbdctl-0.2.3.tar.gz
Size	11.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`e5eede34bc96922e7302d558f2d4d12bd8e583b6c02265f95d1f068b37200760`
BLAKE2b-256 checksum How to use checksums	`f9392b09a6c4f00f1a97e000600c03457b1ffc226245cf8fbddf6ad1b638aac4`
Upload date	Jan 13, 2013
Uploaded using Trusted Publishing? What is trusted publishing?	No

Security for tpkbdctl 0.2.3

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.