v0.51.0 a9d674e

clipboard_text_linux.go RawHistoryFolder

1//go:build linux
2
3package tui
4
5import (
6	"context"
7	"fmt"
8	"os"
9)
10
11// ReadClipboardText reads plain text from a Wayland or X11 clipboard. The
12// small command-line clients are used to preserve zut's CGO-free build.
13func ReadClipboardText() (string, bool, error) {
14	var commands []clipboardTextCommand
15	if os.Getenv("WAYLAND_DISPLAY") != "" {
16		commands = append(commands, clipboardTextCommand{name: "wl-paste", args: []string{"--no-newline", "--type", "text"}})
17	}
18	if os.Getenv("DISPLAY") != "" {
19		commands = append(commands,
20			clipboardTextCommand{name: "xclip", args: []string{"-selection", "clipboard", "-out"}},
21			clipboardTextCommand{name: "xsel", args: []string{"--clipboard", "--output"}},
22		)
23	}
24	// Environment forwarding through multiplexers is not always reliable.
25	// Try every backend if no display variable made a preferred list.
26	if len(commands) == 0 {
27		commands = []clipboardTextCommand{
28			{name: "wl-paste", args: []string{"--no-newline", "--type", "text"}},
29			{name: "xclip", args: []string{"-selection", "clipboard", "-out"}},
30			{name: "xsel", args: []string{"--clipboard", "--output"}},
31		}
32	}
33	text, ok, err := readClipboardTextCommands(commands...)
34	if err == errClipboardCommandUnavailable {
35		return "", false, fmt.Errorf("text clipboard unavailable: install wl-clipboard, xclip, or xsel, or use the terminal paste shortcut")
36	}
37	if err != nil {
38		return "", false, fmt.Errorf("read text clipboard: %w", err)
39	}
40	return text, ok, nil
41}
42
43// WriteClipboardText writes plain text to a Wayland or X11 clipboard. Small
44// command-line clients keep zut's build CGO-free.
45func WriteClipboardText(ctx context.Context, text string) error {
46	var commands []clipboardTextCommand
47	if os.Getenv("WAYLAND_DISPLAY") != "" {
48		commands = append(commands, clipboardTextCommand{name: "wl-copy", args: []string{"--type", "text/plain"}})
49	}
50	if os.Getenv("DISPLAY") != "" {
51		commands = append(commands,
52			clipboardTextCommand{name: "xclip", args: []string{"-selection", "clipboard", "-in"}},
53			clipboardTextCommand{name: "xsel", args: []string{"--clipboard", "--input"}},
54		)
55	}
56	if len(commands) == 0 {
57		commands = []clipboardTextCommand{
58			{name: "wl-copy", args: []string{"--type", "text/plain"}},
59			{name: "xclip", args: []string{"-selection", "clipboard", "-in"}},
60			{name: "xsel", args: []string{"--clipboard", "--input"}},
61		}
62	}
63	if err := writeClipboardTextCommands(ctx, text, commands...); err != nil {
64		if err == errClipboardCommandUnavailable {
65			return fmt.Errorf("text clipboard unavailable: install wl-clipboard, xclip, or xsel")
66		}
67		return fmt.Errorf("write text clipboard: %w", err)
68	}
69	return nil
70}

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 1

Tags 476

↑↓ moveenter openesc close