stabiron 0.1.0

Beautiful terminal QR code generator — optimized for scanning crypto wallet addresses from iPhone
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

# stabiron

Beautiful terminal QR code generator — optimized for scanning crypto wallet addresses from iPhone.

Renders high-contrast unicode block characters (`█ ▀ ▄`) directly in your terminal, giving phone cameras a crisp, reliable signal even in dark environments.

## Install

```bash
cargo install stabiron
```

Or build from source:

```bash
git clone https://github.com/simplysabir/stabiron
cd stabiron
cargo build --release
```

## Usage

```bash
# Positional argument
stabiron "7xKXtg2CW87d97TXJSDpbD5jBkheTqA36YZPn7kkQm1p"

# Flag form
stabiron -m "7xKXtg2CW87d97TXJSDpbD5jBkheTqA36YZPn7kkQm1p"

# Read from clipboard (copy address first, then run)
stabiron --clip
```

## Options

| Flag | Values | Default | Description |
|------|--------|---------|-------------|
| `--color` | `white` `red` `green` `blue` `gold` | `white` | Block color |
| `--size` | `small` `medium` `large` | `medium` | QR size |
| `--label` | any string | — | Custom label shown above QR |
| `--no-label` | — | — | Hide the label / address preview |
| `--save` | — | — | Export PNG to current directory |
| `--clip` | — | — | Read input from clipboard |
| `-m` / `--message` | string | — | Input text (flag form) |

## Examples

```bash
# Solana address with gold blocks, large size
stabiron --color gold --size large "7xKXtg2CW87d97TXJSDpbD5jBkheTqA36YZPn7kkQm1p"

# Add a label
stabiron --label "My Hot Wallet" "7xKXtg2CW87d97TXJSDpbD5jBkheTqA36YZPn7kkQm1p"

# Save a PNG and display
stabiron --save --color blue "0xAbCd..."

# Grab from clipboard and show compact
stabiron --clip --size small --no-label
```

## Why unicode blocks?

Dot/ASCII QR renders use low-contrast characters that phone cameras — especially in dark terminals — struggle to lock onto. `stabiron` uses half-block characters so each QR module is a solid rectangular region of colour, doubling vertical resolution and maximising contrast. The result is near-instant scans even on a first-gen iPhone SE.

## Error correction

All QR codes are generated at **HIGH (H)** error correction level (30% damage recovery). This compensates for terminal font imperfections and anti-aliasing artefacts when a phone camera captures the screen.

## License

MIT — see [LICENSE](LICENSE).