Install

Margin is one small program (about 0.6 MB) that needs nothing else installed. The installers below download the latest release, check its SHA-256, install it for your user only and start it. To get the files yourself, see Download.

#Windows 10 and 11

Open PowerShell and run:

powershell

irm https://raw.githubusercontent.com/arxhr007/margin/main/scripts/install.ps1 | iex

It installs to %LOCALAPPDATA%\Programs\Margin, adds a Start Menu shortcut and needs no administrator rights. Margin then sits in the system tray: left-click the icon for settings.

Options, set before the command:

powershell

$env:MARGIN_AUTOSTART = 1          # also start Margin when you sign in
$env:MARGIN_VERSION = "v0.4.0"     # a specific release instead of the latest
$env:MARGIN_UNINSTALL = 1          # remove Margin (your settings are kept)

You need a precision touchpad: Settings → Bluetooth & devices → Touchpad says "Your PC has a precision touchpad". Touchpads with an older driver don't report finger positions to Windows.

#Linux

64-bit Intel/AMD, any distribution with systemd:

curl -fsSL https://raw.githubusercontent.com/arxhr007/margin/main/scripts/install.sh | sh

It installs ~/.local/bin/margin, does one sudo step for the permissions described in Linux, and sets up a systemd user service that starts with your desktop session. Log out and back in once afterwards.

Options, after sh -s --:

curl -fsSL https://raw.githubusercontent.com/arxhr007/margin/main/scripts/install.sh | sh -s -- --version v0.4.0
#   --no-service       don't set up the systemd user service
#   --no-permissions   don't touch udev rules or groups
#   --uninstall        remove Margin (your settings are kept)

#Build from source

Needs the Rust toolchain; on Windows also the "Desktop development with C++" build tools.

git clone https://github.com/arxhr007/margin.git
cd margin
cargo build --release     # target/release/margin  (margin.exe on Windows)

#Uninstall

Run the installer again with MARGIN_UNINSTALL (Windows) or --uninstall (Linux), as above. Your settings are kept; delete %APPDATA%\Margin or ~/.config/margin to remove them too.