docs(readme): center the hero and frame the demo in window chrome

Rewrite the README around a centered title/tagline hero in place of
the feature bullet list, folding the SSH/UDP pitch into the remote
attach section. Frame the demo in a fake terminal window via VHS
(Colorful window bar, rounded corners, contrasting margin) and drop
gifsicle to --lossy=30: 80 smeared the chrome's near-identical darks
into visible banding around the window bar.

commit: 2ec25e256865e71a28072b41c8653fd9ee7b4925
author: brice · 3mo ago · 2026-07-24 15:19 UTC
parent: 253fc6a
signature: GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email

4 files · +28 -25

M Makefile +3 -1


@@ -28,6 +28,8 @@ mocks:
28	28		demo:
29	29		docker build -f scripts/demo/Dockerfile -t vev-demo .
30	30		./scripts/demo/run.sh demo.tape
31		-	docker run --rm --entrypoint gifsicle -v "$(CURDIR)/scripts/demo/out:/out" vev-demo -O3 --lossy=80 -o /out/demo.gif /out/demo.gif
	31	+	# --lossy above 30 smears the near-identical darks of the window chrome
	32	+	# (margin fill, window bar, terminal background) into visible banding.
	33	+	docker run --rm --entrypoint gifsicle -v "$(CURDIR)/scripts/demo/out:/out" vev-demo -O3 --lossy=30 -o /out/demo.gif /out/demo.gif
32	34		mkdir -p docs/assets
33	35		cp scripts/demo/out/demo.gif docs/assets/demo.gif

 demo:
 	docker build -f scripts/demo/Dockerfile -t vev-demo .
 	./scripts/demo/run.sh demo.tape
-	docker run --rm --entrypoint gifsicle -v "$(CURDIR)/scripts/demo/out:/out" vev-demo -O3 --lossy=80 -o /out/demo.gif /out/demo.gif
+	# --lossy above 30 smears the near-identical darks of the window chrome
+	# (margin fill, window bar, terminal background) into visible banding.
+	docker run --rm --entrypoint gifsicle -v "$(CURDIR)/scripts/demo/out:/out" vev-demo -O3 --lossy=30 -o /out/demo.gif /out/demo.gif
 	mkdir -p docs/assets
 	cp scripts/demo/out/demo.gif docs/assets/demo.gif

M README.md +19 -23

@@ -1,17 +1,13 @@
1		-	# vev
	1	+	<h1 align="center">vev</h1>
2	2
3		-	Norwegian: to weave
	3	+	<p align="center"><em>Norwegian: to weave</em></p>
4	4
5		-	<p align="center"><img src="docs/assets/demo.gif" alt="vev demo: named sessions, splits, stacked panes, floating window, agent bell notification, detach and re-attach" width="800"></p>
6		-
7		-	A terminal multiplexer for Linux and macOS (arm64). One Go binary, a per-user daemon, a thin client.
	5	+	<p align="center">A terminal multiplexer for Linux and macOS.<br>
	6	+	One Go binary, zero runtime dependencies, remote attach that survives bad networks.</p>
8	7
9		-	What it is built around:
	8	+	<p align="center"><img src="docs/assets/demo.gif" alt="vev demo: named sessions, splits, stacked panes, floating window, agent bell notification, detach and re-attach" width="800"></p>
10	9
11		-	- Remote attach that survives bad networks. SSH bootstraps the connection, then the session runs over UDP and resumes after sleep or Wi-Fi changes. Inspired by mosh, with its own protocol.
12		-	- Server-side rendering. The daemon keeps a full VT screen per pane and sends minimal diffs to the client, so high-output programs (agents, build logs) stay smooth locally and over SSH.
13		-	- Nothing but the standard library. VT emulation, renderer, wire protocol, and UDP transport are all in this repo. Zero runtime dependencies.
14		-	- Performance treated as a feature. A reproducible harness measures 252 scenarios across workloads and transports, including lossy and high-latency UDP.
	10	+	---
15	11
16	12		## Install
17	13

@@ -42,18 +38,6 @@ vev kill <name> kill a session (--all kills everything)
42	38
43	39		The daemon starts on first use and exits with the last session. Ephemeral sessions are numbered, survive detach, and disappear with the daemon. Named sessions persist across daemon restarts and come back with their layout, scrollback, and allowlisted processes.
44	40
45		-	## Scripting
46		-
47		-	`vev cmd` runs control commands against a running daemon; it never starts one. For example:
48		-
49		-	```sh
50		-	vev cmd split-right
51		-	vev cmd toast -l warn "build failed"
52		-	vev cmd list-panes --json
53		-	```
54		-
55		-	Target a session explicitly with `-s` (`vev cmd -s work new-tab`). Inside a pane, `--self` targets that pane; it cannot be combined with `-s`. Otherwise vev uses `$VEV` inside a pane, then the only live session; ambiguous targets fail. Run `vev cmd --help` for the scriptable command list and `vev cmd <command> --help` for command usage.
56		-
57	41		## Keys
58	42
59	43		No prefix key; everything is Alt.

@@ -74,7 +58,7 @@ The palette does the rest: type a short code (`SPR` split right, `CNT` new tab,
74	58		vev attach user@host[:session]
75	59		```
76	60
77		-	vev must be installed on the remote. If your firewall only allows SSH, open the UDP range first (default `61000:61023`, override with `VEV_UDP_PORT_RANGE`):
	61	+	SSH bootstraps the connection, then the session runs over UDP and resumes after sleep or Wi-Fi changes. vev must be installed on the remote. If your firewall only allows SSH, open the UDP range first (default `61000:61023`, override with `VEV_UDP_PORT_RANGE`):
78	62
79	63		```sh
80	64		sudo ufw allow 61000:61023/udp

@@ -82,6 +66,18 @@ sudo ufw allow 61000:61023/udp
82	66
83	67		Where UDP is not an option, `VEV_REMOTE_TRANSPORT=stdio` keeps everything inside SSH at the cost of slower disconnect detection. Details in [docs/remote-resilience.md](docs/remote-resilience.md).
84	68
	69	+	## Scripting
	70	+
	71	+	`vev cmd` runs control commands against a running daemon; it never starts one. For example:
	72	+
	73	+	```sh
	74	+	vev cmd split-right
	75	+	vev cmd toast -l warn "build failed"
	76	+	vev cmd list-panes --json
	77	+	```
	78	+
	79	+	Target a session explicitly with `-s` (`vev cmd -s work new-tab`). Inside a pane, `--self` targets that pane; it cannot be combined with `-s`. Otherwise vev uses `$VEV` inside a pane, then the only live session; ambiguous targets fail. Run `vev cmd --help` for the scriptable command list and `vev cmd <command> --help` for command usage.
	80	+
85	81		## Configuration
86	82
87	83		Optional file at `~/.config/vev/config`, reloaded live. Themes, key bindings, palette codes, the floating terminal, status bar scripts: see [docs/configuration.md](docs/configuration.md). Terminal color and VT compatibility notes live in [docs/terminal.md](docs/terminal.md).

@@ -1,17 +1,13 @@
1	-	# vev	1	+	<h1 align="center">vev</h1>
2			2
3	-	Norwegian: to weave	3	+	<p align="center"><em>Norwegian: to weave</em></p>
4			4
5	-	<p align="center"><img src="docs/assets/demo.gif" alt="vev demo: named sessions, splits, stacked panes, floating window, agent bell notification, detach and re-attach" width="800"></p>	5	+	<p align="center">A terminal multiplexer for Linux and macOS.<br>
6	-		6	+	One Go binary, zero runtime dependencies, remote attach that survives bad networks.</p>
7	-	A terminal multiplexer for Linux and macOS (arm64). One Go binary, a per-user daemon, a thin client.
8			7
9	-	What it is built around:	8	+	<p align="center"><img src="docs/assets/demo.gif" alt="vev demo: named sessions, splits, stacked panes, floating window, agent bell notification, detach and re-attach" width="800"></p>
10			9
11	-	- Remote attach that survives bad networks. SSH bootstraps the connection, then the session runs over UDP and resumes after sleep or Wi-Fi changes. Inspired by mosh, with its own protocol.	10	+	---
12	-	- Server-side rendering. The daemon keeps a full VT screen per pane and sends minimal diffs to the client, so high-output programs (agents, build logs) stay smooth locally and over SSH.
13	-	- Nothing but the standard library. VT emulation, renderer, wire protocol, and UDP transport are all in this repo. Zero runtime dependencies.
14	-	- Performance treated as a feature. A reproducible harness measures 252 scenarios across workloads and transports, including lossy and high-latency UDP.
15			11
16		## Install	12		## Install
17			13

@@ -42,18 +38,6 @@ vev kill <name> kill a session (--all kills everything)
42			38
43		The daemon starts on first use and exits with the last session. Ephemeral sessions are numbered, survive detach, and disappear with the daemon. Named sessions persist across daemon restarts and come back with their layout, scrollback, and allowlisted processes.	39		The daemon starts on first use and exits with the last session. Ephemeral sessions are numbered, survive detach, and disappear with the daemon. Named sessions persist across daemon restarts and come back with their layout, scrollback, and allowlisted processes.
44			40
45	-	## Scripting
46	-
47	-	`vev cmd` runs control commands against a running daemon; it never starts one. For example:
48	-
49	-	```sh
50	-	vev cmd split-right
51	-	vev cmd toast -l warn "build failed"
52	-	vev cmd list-panes --json
53	-	```
54	-
55	-	Target a session explicitly with `-s` (`vev cmd -s work new-tab`). Inside a pane, `--self` targets that pane; it cannot be combined with `-s`. Otherwise vev uses `$VEV` inside a pane, then the only live session; ambiguous targets fail. Run `vev cmd --help` for the scriptable command list and `vev cmd <command> --help` for command usage.
56	-
57		## Keys	41		## Keys
58			42
59		No prefix key; everything is Alt.	43		No prefix key; everything is Alt.

@@ -74,7 +58,7 @@ The palette does the rest: type a short code (`SPR` split right, `CNT` new tab,
74		vev attach user@host[:session]	58		vev attach user@host[:session]
75		```	59		```
76			60
77	-	vev must be installed on the remote. If your firewall only allows SSH, open the UDP range first (default `61000:61023`, override with `VEV_UDP_PORT_RANGE`):	61	+	SSH bootstraps the connection, then the session runs over UDP and resumes after sleep or Wi-Fi changes. vev must be installed on the remote. If your firewall only allows SSH, open the UDP range first (default `61000:61023`, override with `VEV_UDP_PORT_RANGE`):
78			62
79		```sh	63		```sh
80		sudo ufw allow 61000:61023/udp	64		sudo ufw allow 61000:61023/udp

@@ -82,6 +66,18 @@ sudo ufw allow 61000:61023/udp
82			66
83		Where UDP is not an option, `VEV_REMOTE_TRANSPORT=stdio` keeps everything inside SSH at the cost of slower disconnect detection. Details in [docs/remote-resilience.md](docs/remote-resilience.md).	67		Where UDP is not an option, `VEV_REMOTE_TRANSPORT=stdio` keeps everything inside SSH at the cost of slower disconnect detection. Details in [docs/remote-resilience.md](docs/remote-resilience.md).
84			68
			69	+	## Scripting
			70	+
			71	+	`vev cmd` runs control commands against a running daemon; it never starts one. For example:
			72	+
			73	+	```sh
			74	+	vev cmd split-right
			75	+	vev cmd toast -l warn "build failed"
			76	+	vev cmd list-panes --json
			77	+	```
			78	+
			79	+	Target a session explicitly with `-s` (`vev cmd -s work new-tab`). Inside a pane, `--self` targets that pane; it cannot be combined with `-s`. Otherwise vev uses `$VEV` inside a pane, then the only live session; ambiguous targets fail. Run `vev cmd --help` for the scriptable command list and `vev cmd <command> --help` for command usage.
			80	+
85		## Configuration	81		## Configuration
86			82
87		Optional file at `~/.config/vev/config`, reloaded live. Themes, key bindings, palette codes, the floating terminal, status bar scripts: see [docs/configuration.md](docs/configuration.md). Terminal color and VT compatibility notes live in [docs/terminal.md](docs/terminal.md).	83		Optional file at `~/.config/vev/config`, reloaded live. Themes, key bindings, palette codes, the floating terminal, status bar scripts: see [docs/configuration.md](docs/configuration.md). Terminal color and VT compatibility notes live in [docs/terminal.md](docs/terminal.md).

M docs/assets/demo.gif +0 -0 binary file: no text diff

binary file: no text diff

M scripts/demo/demo.tape +6 -1


@@ -5,7 +5,12 @@ Set FontFamily "JetBrainsMono Nerd Font"
5	5		Set FontSize 20
6	6		Set Width 1200
7	7		Set Height 750
8		-	Set Padding 0
	8	+	Set Padding 12
	9	+	Set Margin 20
	10	+	Set MarginFill "#161B22"
	11	+	Set WindowBar Colorful
	12	+	Set WindowBarSize 36
	13	+	Set BorderRadius 10
9	14		Set Theme "GitHub Dark"
10	15		Set TypingSpeed 100ms
11	16		Set Framerate 30


@@ -5,7 +5,12 @@ Set FontFamily "JetBrainsMono Nerd Font"
5		Set FontSize 20	5		Set FontSize 20
6		Set Width 1200	6		Set Width 1200
7		Set Height 750	7		Set Height 750
8	-	Set Padding 0	8	+	Set Padding 12
			9	+	Set Margin 20
			10	+	Set MarginFill "#161B22"
			11	+	Set WindowBar Colorful
			12	+	Set WindowBarSize 36
			13	+	Set BorderRadius 10
9		Set Theme "GitHub Dark"	14		Set Theme "GitHub Dark"
10		Set TypingSpeed 100ms	15		Set TypingSpeed 100ms
11		Set Framerate 30	16		Set Framerate 30