HEXYL(1) General Commands Manual HEXYL(1)
hexyl - a command-line hex viewer
hexyl [OPTIONS] [FILE]
hexyl is a simple hex viewer for the terminal. It uses a colored
output to distinguish different categories of bytes (NULL bytes,
printable ASCII characters, ASCII whitespace characters, other ASCII
characters and non-ASCII).
FILE The file to display. If no FILE argument is given, read from
STDIN.
-n, --length N
Only read N bytes from the input. The N argument can also
include a unit with a decimal prefix (kB, MB, ..) or binary
prefix (kiB, MiB, ..), or can be specified using a hex number.
Examples:
Read the first 64 bytes:
$ hexyl --length=64
Read the first 4 kibibytes:
$ hexyl --length=4KiB
Read the first 255 bytes (specified using a hex number):
$ hexyl --length=0xff
-c, --bytes N
An alias for -n/--length.
-l N Yet another alias for -n/--length.
-s, --skip N
Skip the first N bytes of the input. The N argument can also
include a unit (see --length for details). A negative value
is valid and will seek from the end of the file.
--block-size SIZE
Sets the size of the block unit to SIZE (default is 512).
Examples:
Sets the block size to 1024 bytes:
$ hexyl --block-size=1024 --length=5block
Sets the block size to 4 kilobytes:
$ hexyl --block-size=4kB --length=2block
-v, --no-squeezing
Displays all input data. Otherwise any number of groups of
output lines which would be identical to the preceding group
of lines, are replaced with a line comprised of a single
asterisk.
--color WHEN
When to use colors. The auto-mode only displays colors if the
output goes to an interactive terminal.
Possible values:
+o always (default)
+o auto
+o never
--border STYLE
Whether to draw a border with Unicode characters, ASCII
characters, or none at all.
Possible values:
+o unicode (default)
+o ascii
+o none
-o, --display-offset N
Add N bytes to the displayed file position. The N argument
can also include a unit (see --length for details). A
negative value is valid and calculates an offset relative to
the end of the file.
-h, --help
Prints help information.
-V, --version
Prints version information.
Source repository:
<https://github.com/sharkdp/hexyl>
Print a given file:
$ hexyl small.png
Print and view a given file in the terminal pager:
$ hexyl big.png | less -r
Print the first 256 bytes of a given special file:
$ hexyl -n 256 /dev/urandom
hexyl was written by David Peter <mail@david-peter.de>.
Bugs can be reported on GitHub at:
<https://github.com/sharkdp/hexyl/issues>
hexyl is dual-licensed under:
+o Apache License 2.0 (<https://www.apache.org/licenses/LICENSE-2.0>)
+o MIT License (<https://opensource.org/licenses/MIT>)
hexdump(1), xxd(1)
hexyl 0.12.0 2022-12-05 HEXYL(1)
NAME
hexyl - a command-line hex viewer
SYNOPSIS
hexyl [OPTIONS] [FILE]
DESCRIPTION
hexyl is a simple hex viewer for the terminal. It uses a colored
output to distinguish different categories of bytes (NULL bytes,
printable ASCII characters, ASCII whitespace characters, other ASCII
characters and non-ASCII).
POSITIONAL ARGUMENTS
FILE The file to display. If no FILE argument is given, read from
STDIN.
OPTIONS
-n, --length N
Only read N bytes from the input. The N argument can also
include a unit with a decimal prefix (kB, MB, ..) or binary
prefix (kiB, MiB, ..), or can be specified using a hex number.
Examples:
Read the first 64 bytes:
$ hexyl --length=64
Read the first 4 kibibytes:
$ hexyl --length=4KiB
Read the first 255 bytes (specified using a hex number):
$ hexyl --length=0xff
-c, --bytes N
An alias for -n/--length.
-l N Yet another alias for -n/--length.
-s, --skip N
Skip the first N bytes of the input. The N argument can also
include a unit (see --length for details). A negative value
is valid and will seek from the end of the file.
--block-size SIZE
Sets the size of the block unit to SIZE (default is 512).
Examples:
Sets the block size to 1024 bytes:
$ hexyl --block-size=1024 --length=5block
Sets the block size to 4 kilobytes:
$ hexyl --block-size=4kB --length=2block
-v, --no-squeezing
Displays all input data. Otherwise any number of groups of
output lines which would be identical to the preceding group
of lines, are replaced with a line comprised of a single
asterisk.
--color WHEN
When to use colors. The auto-mode only displays colors if the
output goes to an interactive terminal.
Possible values:
+o always (default)
+o auto
+o never
--border STYLE
Whether to draw a border with Unicode characters, ASCII
characters, or none at all.
Possible values:
+o unicode (default)
+o ascii
+o none
-o, --display-offset N
Add N bytes to the displayed file position. The N argument
can also include a unit (see --length for details). A
negative value is valid and calculates an offset relative to
the end of the file.
-h, --help
Prints help information.
-V, --version
Prints version information.
NOTES
Source repository:
<https://github.com/sharkdp/hexyl>
EXAMPLES
Print a given file:
$ hexyl small.png
Print and view a given file in the terminal pager:
$ hexyl big.png | less -r
Print the first 256 bytes of a given special file:
$ hexyl -n 256 /dev/urandom
AUTHORS
hexyl was written by David Peter <mail@david-peter.de>.
REPORTING BUGS
Bugs can be reported on GitHub at:
<https://github.com/sharkdp/hexyl/issues>
COPYRIGHT
hexyl is dual-licensed under:
+o Apache License 2.0 (<https://www.apache.org/licenses/LICENSE-2.0>)
+o MIT License (<https://opensource.org/licenses/MIT>)
SEE ALSO
hexdump(1), xxd(1)
hexyl 0.12.0 2022-12-05 HEXYL(1)