medialinker-cli 0.4.0

Share files and text through MediaLinker with 5-character codes
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

# MediaLinker-cli

`ml` shares files and text through a [MediaLinker](https://github.com/marxnoe/MediaLinker)
server. Every share gets a 5-character code that works until it expires.

## Install

macOS and Linux:

```sh
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/marxnoe/MediaLinker-cli/releases/latest/download/medialinker-cli-installer.sh | sh
```

Windows (PowerShell):

```powershell
powershell -ExecutionPolicy Bypass -c "irm https://github.com/marxnoe/MediaLinker-cli/releases/latest/download/medialinker-cli-installer.ps1 | iex"
```

With Cargo:

```sh
cargo binstall medialinker-cli   # prebuilt binary, needs cargo-binstall
cargo install medialinker-cli    # build from source
```

Prebuilt archives for Linux (x86_64, ARM64), macOS (Intel, Apple Silicon) and Windows are on the
[releases page](https://github.com/marxnoe/MediaLinker-cli/releases).

## Server

`ml` talks to https://medialinker.noecore.com by default. To use another MediaLinker server, save it once:

```sh
ml server https://media.example.com
```

`--server <URL>` or the `ML_SERVER` environment variable override the saved server.

## Usage

```sh
ml send photo.jpg            # share a file, prints the code
ml send "meet at 6"          # share text
ml send notes.txt --text     # share the words "notes.txt", not the file
cat log.txt | ml send        # share stdin as text
tar cz dir | ml send -n dir.tgz   # share stdin as a file
ml send video.mp4 --ttl 7d   # expiry: 1h, 24h (default) or 7d

ml get K7QX2                 # prints text, or saves a file in the current directory
ml get K7QX2 -o out.jpg      # save under another name (-o - writes to stdout)
```

`ml get` never overwrites an existing file unless you pass `--force`.

In a terminal, `ml send` also prints a QR code and a link to the receive page, so a phone can open the
share straight away. `--no-qr` leaves the QR code out; nothing extra is printed when stderr is not a
terminal, so `CODE=$(ml send file)` stays clean.

## Shell completions

`ml completions <shell>` prints a completion script for `bash`, `zsh`, `fish`, `powershell` or `elvish`:

```sh
ml completions bash > ~/.local/share/bash-completion/completions/ml
ml completions zsh > ~/.zfunc/_ml        # with fpath+=~/.zfunc in .zshrc
ml completions fish > ~/.config/fish/completions/ml.fish
ml completions powershell >> $PROFILE
```

## Releasing

Releases are built by [cargo-dist](https://opensource.axo.dev/cargo-dist/). Bump `version` in
`Cargo.toml`, merge it, then push a matching tag:

```sh
git tag v0.2.0 && git push origin v0.2.0
```

The release workflow builds every target, publishes the archives and installers to a GitHub release,
then publishes the crate to crates.io (needs the `CARGO_REGISTRY_TOKEN` repo secret).

## License

MIT, see [LICENSE](LICENSE).