refactor: finish moving ssh-* scripts to own installers
[webi-installers/.git] / hexyl / README.md
1 ---
2 title: hexyl
3 homepage: https://github.com/sharkdp/hexyl
4 tagline: |
5   hexyl is a simple hex viewer for the terminal.
6 ---
7
8 To update or switch versions, run `webi hexyl@stable` (or `@v0.9`, `@beta`,
9 etc).
10
11 ## Cheat Sheet
12
13 ![](https://camo.githubusercontent.com/1f71ee7031e1962b23f21c8cc89cb837e1201238/68747470733a2f2f692e696d6775722e636f6d2f4d574f3975534c2e706e67)
14
15 > It uses a colored output to distinguish different categories of bytes (NULL
16 > bytes, printable ASCII characters, ASCII whitespace characters, other ASCII
17 > characters and non-ASCII).
18
19 `hexyl` is pretty self-explanatory.
20
21 If you know that you need a _hex viewer_, then you probably already know enough
22 to see why this is particularly useful, and can figure out how to use it.
23
24 ```bash
25 echo "hello" > foo.bin
26 hexyl foo.bin
27 ```
28
29 For options, such as `--length`, `--skip`, and `--offset`, see:
30
31 ```bash
32 hexyl --help
33 ```
34
35 ### Convert hex to binary
36
37 If you have some hex (say from some server logs) that you'd like to encode back
38 to binary to view in hexyl, you can convert it with `xxd`:
39
40 ```bash
41 echo '48656c6c6f210a' > foo.hex
42 xxd -r -p foo.hex foo.bin
43 ```