gotta-scroll-fast/DEV_SETUP.md

Development setup

Enter shell

nix develop

This shell includes:

• Rust: cargo, rustc, rustfmt, clippy, rust-analyzer
• Build tools: pkg-config, gcc, clang, make, git
• Input debug: evtest, libinput, wev
• CLI tools: jq, rg, fd, jj

Recommended NixOS runtime config (uinput)

For gotta-scroll-fast (gsfd), you typically need /dev/uinput.

{
  boot.kernelModules = [ "uinput" ];

  # Optional: ensure module is available in initrd/system profile
  boot.extraModulePackages = [ ];

  services.udev.extraRules = ''
    KERNEL=="uinput", MODE="0660", GROUP="input"
  '';

  users.users.<your-user>.extraGroups = [ "input" ];
}

Then rebuild and re-login.

Useful checks

ls -l /dev/uinput
id
sudo evtest
libinput debug-events
wev

First run (project)

cargo run -p gsf-daemon -- --list-devices
cargo run -p gsf-cli -- tui