https://github.com/foriequal0/tpmiddle-rs

Rust port of https://github.com/tene0/tpmiddle
https://github.com/foriequal0/tpmiddle-rs

Last synced: about 1 month ago
JSON representation

Rust port of https://github.com/tene0/tpmiddle

• Host: GitHub
• URL: https://github.com/foriequal0/tpmiddle-rs
• Owner: foriequal0
• Created: 2020-10-07T03:08:53.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2021-12-20T07:45:13.000Z (over 3 years ago)
• Last Synced: 2023-08-04T07:25:35.590Z (almost 2 years ago)
• Language: Rust
• Size: 135 KB
• Stars: 10
• Watchers: 4
• Forks: 2
• Open Issues: 3
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
[![CI](https://github.com/foriequal0/tpmiddle-rs/workflows/CI/badge.svg?branch=master&event=push)](https://github.com/foriequal0/tpmiddle-rs/actions?query=workflow%3ACI+event%3Apush+branch%3Amaster)

tpmiddle-rs

===========

`tpmiddle-rs` is a Rust port of [tene0/tpmiddle](https://github.com/tene0/tpmiddle) with some improvements.

## Features

### Lightweight

It doesn't need ThinkPad TrackPoint Keyboard software since it directly communicates with the keyboard.

You only need a `tpmiddle-rs.exe`.

### Configure the keyboard with CLI

It sends commands to the keyboard on its startup to set following configurations:

  * `--fn-lock` enables fn lock (`--no-fn-lock` to disable it).

  * `--sensitivity 1-9` sets TrackPoint sensitivity.

### Smooth scrolling (Experimental)

It disables native middle button on its startup to intercept all middle button events.

You can set scrolling controller by passing `--scroll ` options to the program.

 * `classic`: It just bypasses middle button events. It would feel same with ThinkPad preferred scrolling.

 * `smooth`: It tries to smoothen discrete middle button events.

## How to install

Download `tpmiddle-rs.exe` here https://github.com/foriequal0/tpmiddle-rs/releases and make a shortcut to Startup folder.

1. Remove ThinkPad TrackPoint Keyboard software and reboot.

1. Press **Win + R** key, type **shell:startup**, then select **OK**. Startup folder will show up.

1. Drag and drop downloaded `tpmiddle-rs.exe` to the folder while pressing **Alt** key.

1. Right click the created shortcut, click **Properties**.

1. Append some configuration flags such as `--fn-lock`, `--scroll smooth` to **Target**.

   Flags should be separated by a whitespace.

1. Press **Ok** button to save the shortcut.

1. You can activate it now by double clicking the shortcut without reboot.

## How to remove

1. Terminate `tpmiddle-rs.exe`

   1. Press **Alt + Ctrl + Delete**, click **Task Manager**

   1. Press **More Details**, click **Details** tab.

   1. Find `tpmiddle-rs.exe`, click **End Task**.

1. Remove `tpmiddle-rs.exe`

   1. Remove the shortcut from Startup folder.

   1. Remove `tpmiddle-rs.exe`.

1. Pull the USB dongle, and put it again.

1. Reinstall ThinkPad TrackPoint Keyboard software if you want.