smoothscroll.toml

# Devices merged into the single virtual pointer.
# Case-insensitive substring match on the evdev name; see `smoothscroll --list`.
# Every listed device is grabbed exclusively, so list only pointer devices —
# never a plain keyboard node.
devices = [
  "Ploopy Corporation Ploopy Adept Trackball Mouse",
  "Ploopy Corporation Trackball Nano",
  "Aurora Sweep rev1 Mouse",
]

# evdev code of the button that activates scrolling.
#   277 = BTN_FORWARD  <- QMK MS_BTN6. Unclaimed by browsers.
#   275 = BTN_SIDE     <- QMK MS_BTN4. Browsers bind this to "back".
#   276 = BTN_EXTRA    <- QMK MS_BTN5. Browsers bind this to "forward".
scroll_button = 277

# Reported name of the virtual device. Must match the Hyprland device{} block.
virtual_name = "SmoothScroll Virtual Pointer"

# --- coasting -----------------------------------------------------------
momentum = true

# Fraction of velocity left after one second of coasting.
# 0.003 ≈ a 1.2s glide. Raise for a longer, slipperier coast.
friction = 0.003

# Coast ends below this speed, in px/s. Raise it if slow tails feel draggy.
min_velocity = 40.0

# Ceiling on fling speed, in px/s.
max_velocity = 4000.0

# Coast frame interval, ms. 8 ≈ 125Hz, comfortably above any display refresh.
tick_ms = 8

# Trailing window used to measure release velocity, ms.
velocity_window_ms = 80