HEXYL(1)                    General Commands Manual                   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)