Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
Sign up
Appearance settings

diegofps/devstream

Repository files navigation

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

Buttons

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

Buttons

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

Buttons

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

Buttons

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.

sudo apt update
sudo apt install -yq libpython3-dev inotify-tools xclip edid-decode
sudo pip3 install evdev

Install

Install the python service and compiled programs

# 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

Releases

No releases published

Packages

Contributors

AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /