panasyn 0.1.0

A lightweight GPU-accelerated terminal emulator for macOS and Linux.
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
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145

# Panasyn

<img src="./assets/brand/background.png" alt="Panasyn terminal preview" width="720">

Panasyn is a lightweight GPU terminal for macOS and Linux. 

Core terminal rendering, tabs, selection, scrollback, OSC 8 links, static
background image functionality, and replay/fuzz developer tools are in place.

<img src="./assets/screenshot.png">

## Install

### Install with Cargo


```sh
cargo install panasyn
panasyn
```

`cargo add panasyn` is for adding Panasyn as a dependency inside another Rust
project. For installing and running the terminal app, use `cargo install`.

### Install from GitHub

Use this when you want the current repo version:

```sh
git clone <repo-url>
cd panasyn
cargo install --path .
panasyn
```

Or run it without installing:

```sh
cargo run --release
```

## Configure

Panasyn reads its config from:

```text
~/.config/panasyn/config.toml
```

Create the file if it does not exist:

```sh
mkdir -p ~/.config/panasyn
nano ~/.config/panasyn/config.toml
```

Example:

```toml
[font]
family = "OCR A Extended"
size = 14.0
line_height = 1.4

[appearance]
background = "#02050A"
foreground = "#E6E6E6"
selection_background = "#0066CC"
selection_foreground = "#BFBFBF"
cursor_background = "#00A2FF"
cursor_foreground = "#02050A"
cursor_thin = "#00A2FF"
inverse_background = "#0066CC"
hyperlink_background = "#0066CC"

[appearance.background_image]
path = ""
opacity = 0.18
mode = "cover"        # cover, contain, or stretch
max_dimension = 1920  # large images are downscaled before upload
```

After editing the config, restart Panasyn. 

## What It Supports

- GPU text rendering through `wgpu` and `glyphon`.
- Native PTY shell sessions.
- Tabs with independent shells.
- Scrollback, selection, paste, cursor styles, SGR colors, and mouse reporting.
- Static background images.
- OSC 8 hyperlinks with an allowlist for safe link opening.
- Headless replay, benchmarks, and ANSI fuzzing for development.

## Release Notes

This is the first version release of Panasyn. For now, distribution is through
the GitHub repo and Cargo. A packaged macOS app/DMG is planned.



## Developer Setup

Install Rust, then run:

```sh
cargo run
```

Useful checks before a pull request:

```sh
cargo fmt --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test
cargo test --all-features
RUSTDOCFLAGS="-D warnings" cargo doc --no-deps --all-features
cargo audit
cargo package --locked
cargo build --release --all-features
```

Developer-only replay tools:

```sh
panasyn replay /path/to/session.jsonl --headless --machine
panasyn bench --frames 3 --pty-bytes 65536 --machine
panasyn fuzz 1000 --categories
```

Repo map:

```text
src/app/       window lifecycle, tabs, config, input
src/ansi/      ANSI/VT parser integration
src/terminal/ terminal grid, cells, scrollback, selection
src/renderer/  GPU renderer and background image layer
src/pty/       platform PTY session management
src/replay/    replay, benchmark, fuzz, and regression tooling
assets/brand/  README and brand artwork
assets/macos/  macOS app icon assets
docs/          architecture and subsystem notes
scripts/       local development helpers
tests/         integration tests
```