Intercept and transform events from Linux systems 🎾
PythonGPL-3.0
What is this?
These is a system service to enhance the compatibility of the Logitech Trackball Marble, Logitech MX Anywhere 2S, and other devices I may have with the Linux OS. It contains scripts that start during system boot and map the device inputs into special commands, like Back, Forward, Scrolling, Alt+Tab, macros, and so on. If a device is not present/detected it simply ignores the enhancements. It is also aware of the current focused window. For instance, "Switch Tabs" will map to different shortcuts deppending on your app.
Usage
Logitech Trackball Marble
Normal Mode
Shortcut
Action
A
Left Click
B
Go to Declaration / Open in new Tab
C
Right Click
D
Middle Click
E
Move Cursor
Holding B
Shortcut
Action
B + A
Show All Windows
B + C
Back
B + D
Forward
B + E
Vertical and Horizontal Scrolling
Holding C
Shortcut
Action
C + A
Search Selection
C + B
Reopen Tab
C + D
New Tab or Document
C + E
Change Volume (Vertical) or Undo / Redo (Horizontal)
Holding D
Shortcut
Action
D + A
Close Tab or Terminal
D + B
Close Window
D + C
Advanced Search: Tabs, Files, Content, Symbols, so on
D + E
Switch Tabs (Vertical) or Switch Windows (Horizontal)
Logitech MX Anywhere 2S
Normal Mode
Shortcut
Action
A
Left Click
B
Middle Click
C
Right Click
D
Horizontal Scroll
E
Vertical Scroll
F
Horizontal Scroll
H
Back
G
Forward
G + H
Show All Windows
Browser Mode
Shortcut
Action
H + A
Go to Declaration
H + B
Close Tab
H + C
Reopen Tab
H + D
Zoom In
H + E
Switch Tabs
H + F
Zoom Out
System mode
Shortcut
Action
G + A
Undo
G + B
Close Window
G + C
Redo
G + E
Switch Window
Multimedia Mode
Shortcut
Action
G + H + A
Play / Pause
G + H + B
Stop
G + H + C
Mute / Unmute
G + H + D
Next Track
G + H + E
Volume Up / Down
G + H + F
Previous Track
Macro Keyboard
Shortcut
Action
REC + MACRO_N
Start recording / reset recording keyboard input sequence in buffer N (activates blue led)
MACRO_N (blue led on)
Finish recording the macro (deactivates led)
MACRO_N (blue led off)
Play the recorded sequence of keys
TOGGLE_N
Toggle macro MACRO_N between two sets, MACRO_1 to MACRO_6 (left) or MACRO_7 to MACRO_12 (right)
Yellow led
Indicates a key is being pressed
XPPEN Deco Pro
Key
Mode
Can draw?
Show drawing
Background
A
Transparent
Yes
Yes
None
B
Opaque
Yes
Yes
Opaque
C
Passthrough
No
Yes
None
D
Disabled
No
No
None
Transparent/Opaque/Passthrough modes
Key
Action
E
Previous page
F
Next page
G
Undo
H
Redo
I
Change brush size
J
Move paper
K
Touch the tablet to draw
L
Eraser mode
M
Open Menu (Planned)
Disabled mode
Key
Action
E
Planning
F
Planning
G
Planning
H
Planning
I
Planning
J
Planning
K
Left mouse click
L
Middle mouse click
M
Right mouse click
Dependencies
This daemon requires python3, pip, evdev, inotifywait, xclip and edid-decode. It has only been tested in Ubuntu 22.04 LTS, you can install its dependencies with the following commands.
# Make sure your qmake is installed and accessible via PATH. For instance, qt creator would install it around your home directory:
sudo bash -c "PATH='/home/$USER/Qt/6.4.0/gcc_64/bin/':\$PATH ./install.sh"# Start the service in the system
sudo service devstream start
# Activate autostart during system boot
sudo systemctl enable devstream
Uninstall
# Stop services, uninstall them, and remove all files
sudo ./uninstall.sh
