Skip to content
ank426Public

About

Use your phone as a wireless scroll wheel on Linux, written in Rust

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

19 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

scroll

Use your phone as a wireless scroll wheel on Linux.

Install

cargo install --git https://github.com/ank426/scroll

Or clone and install:

git clone https://github.com/ank426/scroll
cd scroll
cargo install --path .

Setup

Scroll needs write access to /dev/uinput to create a virtual mouse-wheel input device. To grant your user permanent access:

sudo groupadd -r uinput
sudo usermod -aG uinput $USER
echo 'KERNEL=="uinput", MODE="0660", GROUP="uinput", OPTIONS+="static_node=uinput"' \
| sudo tee /etc/udev/rules.d/60-scroll.rules

Then, either reboot, or run:

sudo udevadm control --reload
sudo udevadm trigger

Log out and back in for the new group membership to take effect. Users in the uinput group can synthesize input events system-wide, so do not add untrusted users to it.

Usage

Start the server and show a QR code:

scroll --qr

Scan the code, or open the displayed URL on a phone connected to the same network. Swipe vertically to scroll on the host.

Options

> scroll --help
Use your phone to scroll

Usage: scroll [OPTIONS]

Options:
  -p, --port <PORT>                Port to listen on [default: 12687]
  -s, --sensitivity <SENSITIVITY>  Scroll sensitivity multiplier [default: 6]
  -q, --qr [<QR>]                  Show QR code in terminal [default: false] [possible values: true, false]
  -i, --iface <IFACE>              Network interface to use for the displayed URL
  -h, --help                       Print help

Without --iface, scroll listens on all interfaces and displays the detected local IP. With --iface, it listens only on that interface.

About

Use your phone as a wireless scroll wheel on Linux, written in Rust

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages