omabeam 0.2.0

Beam clipboard content or one file to a phone with a QR code
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

# OmaBeam

**No app. No account. No cloud. Scan and go.**

![OmaBeam sharing text through a terminal QR code](assets/omabeam-preview.png)

OmaBeam is a lightweight CLI for Omarchy that beams clipboard text, images, or
copied files from your computer to a phone on the same local network using a QR
code.

## Install

Install and configure OmaBeam on Omarchy:

```sh
curl -fsSL https://raw.githubusercontent.com/Choi-Jungwoo/omabeam/master/install.sh | bash
```

Or run the two steps manually with Omarchy's `mise`:

```sh
mise use --global --minimum-release-age 0s cargo:omabeam
omabeam setup
```

OmaBeam uses `wl-paste` from `wl-clipboard` for the Wayland clipboard and `ip`
from `iproute2` to find the local network address. Both are included with
Omarchy.

`omabeam setup` adds OmaBeam to the Omarchy Share menu, binds `Super+B`, and
allows TCP port `61234` through UFW only for the active LAN. Run it again after
updating OmaBeam to refresh the managed menu and shortcut entries.

## Usage

Share the current clipboard text, image, or copied file:

```sh
omabeam
```

Share piped text or a URL:

```sh
echo "hello" | omabeam
```

Share one file:

```sh
omabeam photo.jpg
```

Text and URLs that fit are encoded directly in the terminal QR code. Longer
clipboard text, clipboard images, copied files, and explicit file arguments use
a temporary local server that runs until you press any key in an interactive
terminal. Formats that the phone browser supports are shown inline; other files
are downloaded.

## Privacy

OmaBeam uploads nothing. The temporary server binds only to the current LAN
address, exposes only the selected regular file or clipboard image, and
protects its URL with a new random route token each time it runs.

## License

[MIT](LICENSE)