Skip to content

Commit 44d6842

Browse files
committed
Document toolbar env toggles
1 parent 9ae4b4e commit 44d6842

File tree

2 files changed

+24
-0
lines changed

2 files changed

+24
-0
lines changed

README.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -493,6 +493,17 @@ ls -la ~/.config/wayscriber/config.toml
493493
RUST_LOG=info wayscriber --active # watch for TOML errors
494494
```
495495

496+
### Environment variables
497+
498+
Common toggles:
499+
- `WAYSCRIBER_TOOLBAR_DRAG_PREVIEW=0` disables inline toolbar drag preview (default: on)
500+
- `WAYSCRIBER_TOOLBAR_POINTER_LOCK=1` enables pointer-lock drag path (default: off)
501+
- `WAYSCRIBER_DEBUG_TOOLBAR_DRAG=1` enables toolbar drag logging (default: off)
502+
- `WAYSCRIBER_FORCE_INLINE_TOOLBARS=1` forces inline toolbars on Wayland (default: off)
503+
- `WAYSCRIBER_NO_TRAY=1` disables the tray icon (default: tray enabled)
504+
505+
See `docs/CONFIG.md` for the full list.
506+
496507
### Performance tuning
497508

498509
```toml

docs/CONFIG.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -737,6 +737,19 @@ pkill wayscriber
737737
wayscriber --daemon &
738738
```
739739

740+
## Environment Variables
741+
742+
These override behavior at runtime. Bool-ish values treat anything except `0`, `false`, or `off` as true.
743+
744+
- `WAYSCRIBER_NO_TRAY=1` disables the tray icon (default: tray enabled)
745+
- `WAYSCRIBER_RESUME_SESSION=1/0` forces session persistence on/off for the current run (default: unset; follows config)
746+
- `WAYSCRIBER_FORCE_INLINE_TOOLBARS=1` forces inline toolbars on Wayland (default: off)
747+
- `WAYSCRIBER_TOOLBAR_DRAG_PREVIEW=0` disables inline toolbar drag preview (default: on)
748+
- `WAYSCRIBER_TOOLBAR_POINTER_LOCK=1` enables pointer-lock drag path (experimental; default: off)
749+
- `WAYSCRIBER_DEBUG_TOOLBAR_DRAG=1` enables toolbar drag logging (default: off)
750+
- `WAYSCRIBER_DEBUG_DAMAGE=1` enables damage region logging (default: off)
751+
- `RUST_LOG=info` enables Rust logging (default: unset; use `wayscriber=debug` for app-level logs)
752+
740753
## Troubleshooting
741754

742755
### Config File Not Loading

0 commit comments

Comments
 (0)