stutter-daemon 0.3.2

Focus-aware process priority daemon
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

# stutter

[![Crates.io](https://img.shields.io/crates/v/stutter-daemon.svg)](https://crates.io/crates/stutter-daemon)
[![CI](https://github.com/Kleshzz/stutter/actions/workflows/ci.yml/badge.svg)](https://github.com/Kleshzz/stutter/actions/workflows/ci.yml)
[![Rust](https://img.shields.io/badge/rust-1.85%2B-orange.svg)](https://www.rust-lang.org)

A focus-aware process priority daemon.

When you switch windows, stutter automatically raises the CPU priority of the
focused process and restores the previous one. This reduces input latency and
makes the active window feel more responsive under load.

## How it works

stutter connects to your compositor's IPC socket and listens for focus change
events. On each focus change it calls setpriority(2) to set the focused
process to nice -5 and resets the previously focused process back to 0.
On exit, the last focused process is restored to the default priority.

## Supported backends

- Hyprland
- Niri

## Configuration

The configuration file is located at `~/.config/stutter/config.toml`. It is
automatically created with default values on the first run.

```toml
# CPU priority of the focused window (lower = higher priority, min -20)
focused_nice = -5

# CPU priority of all other windows (restored when window loses focus)
default_nice = 0

# Per-app overrides (optional)
# The key is the window class or app_id
[apps]
"kitty" = { focused_nice = -10 }
"firefox" = { focused_nice = -2 }
```

You can reload the configuration without restarting the daemon by sending a
`SIGHUP` signal:
```bash
pkill -HUP stutter
# or via systemd
systemctl --user reload stutter
```

## Requirements

- Permission to lower nice values - either run as root, or grant the binary
  `CAP_SYS_NICE`:

```
sudo setcap cap_sys_nice+ep /usr/bin/stutter
```

## Installation

### AUR (recommended)
```bash
yay -S stutter-daemon
# or
paru -S stutter-daemon
```

### Pre-built binary
```bash
curl -L https://github.com/Kleshzz/stutter/releases/latest/download/stutter \
  -o /tmp/stutter
sudo install -Dm755 /tmp/stutter /usr/bin/stutter
```

### From source
```bash
cargo install stutter-daemon
# or build manually:
cargo build --release
sudo install -Dm755 target/release/stutter /usr/bin/stutter
```

## Setup

### Grant permissions (pick one)
```bash
# Option A - capability (recommended)
sudo setcap cap_sys_nice+ep /usr/bin/stutter

# Option B - run as root (not recommended)
```

### Autostart

**systemd (recommended):**
```bash
# AUR install — service is already in place:
systemctl --user enable --now stutter

# Manual install — copy service file first:
cp stutter.service ~/.config/systemd/user/
systemctl --user daemon-reload
systemctl --user enable --now stutter
```

**hyprland.conf:**
```
exec-once = stutter
```

**niri (config.kdl):**
```kdl
spawn-at-startup "stutter"
```

## License

MIT