.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH HEXYL "1" "June 2026" "hexyl 0.17.0" "User Commands"
.SH NAME
hexyl \- manual page for hexyl 0.17.0
.SH SYNOPSIS
.B hexyl
[\fI\,OPTIONS\/\fR] [\fI\,FILE\/\fR]
.SH DESCRIPTION
A command\-line hex viewer
.SS "Arguments:"
.IP
[FILE]
.IP
The file to display. If no FILE argument is given, read from STDIN
.SH OPTIONS
.HP
\fB\-n\fR, \fB\-\-length\fR <N>
.IP
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. The short option '\-l' can
be used as an alias.
Examples: \fB\-\-length\fR=\fI\,64\/\fR, \fB\-\-length\fR=\fI\,4KiB\/\fR, \fB\-\-length\fR=\fI\,0xff\/\fR
.IP
[aliases: bytes]
[short aliases: c]
.HP
\fB\-s\fR, \fB\-\-skip\fR <N>
.IP
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.
.HP
\fB\-\-block\-size\fR <SIZE>
.IP
Sets the size of the `block` unit to SIZE.
Examples: \fB\-\-block\-size\fR=\fI\,1024\/\fR, \fB\-\-block\-size\fR=\fI\,4kB\/\fR
.IP
[default: 512]
.HP
\fB\-v\fR, \fB\-\-no\-squeezing\fR
.IP
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
.HP
\fB\-\-color\fR <WHEN>
.IP
When to use colors
.IP
[default: always]
.IP
Possible values:
\- always: Always use colorized output
\- auto:   Only displays colors if the output goes to an interactive
.IP
terminal
.TP
\- never:
Do not use colorized output
.TP
\- force:
Override the NO_COLOR environment variable
.HP
\fB\-\-border\fR <STYLE>
.IP
Whether to draw a border
.IP
[default: unicode]
.IP
Possible values:
\- unicode: Draw a border with Unicode characters
\- ascii:   Draw a border with ASCII characters
\- none:    Do not draw a border at all
.HP
\fB\-p\fR, \fB\-\-plain\fR
.IP
Display output with \fB\-\-no\-characters\fR, \fB\-\-no\-position\fR, \fB\-\-border\fR=\fI\,none\/\fR, and
\fB\-\-color\fR=\fI\,never\/\fR
.HP
\fB\-\-no\-characters\fR
.IP
Do not show the character panel on the right
.HP
\fB\-C\fR, \fB\-\-characters\fR
.IP
Show the character panel on the right. This is the default, unless
\fB\-\-no\-characters\fR has been specified
.HP
\fB\-\-character\-table\fR <FORMAT>
.IP
Defines how bytes are mapped to characters
.IP
[default: default]
.IP
Possible values:
\- default:       Show printable ASCII characters as\-is, 'â‹\&' for NULL
.IP
bytes, ' ' for space, '_' for other ASCII whitespace, 'â\&.¢' for other
ASCII characters, and '×' for non\-ASCII bytes
.TP
\- ascii:
Show printable ASCII as\-is, ' ' for space, '.' for
.IP
everything else
.IP
\- codepage\-1047: Show printable EBCDIC as\-is, ' ' for space, '.' for
.IP
everything else
.TP
\- codepage\-437:
Uses code page 437 (for non\-ASCII bytes)
.TP
\- braille:
Uses braille characters for non\-printable bytes
.HP
\fB\-\-color\-scheme\fR <FORMAT>
.IP
Defines the color scheme for the characters
.IP
[default: default]
.IP
Possible values:
\- default:  Show the default colors: bright black for NULL bytes,
.IP
green for ASCII space characters and non\-printable ASCII, cyan for
printable ASCII characters, and yellow for non\-ASCII bytes
.IP
\- gradient: Show bright black for NULL bytes, cyan for printable ASCII
.IP
characters, a gradient from pink to violet for non\-printable ASCII
characters and a heatmap\-like gradient from red to yellow to white
for non\-ASCII bytes
.HP
\fB\-P\fR, \fB\-\-no\-position\fR
.IP
Whether to display the position panel on the left
.HP
\fB\-o\fR, \fB\-\-display\-offset\fR <N>
.IP
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.
.IP
[default: 0]
.HP
\fB\-\-panels\fR <N>
.IP
Sets the number of hex data panels to be displayed. `\-\-panels=auto`
will display the maximum number of hex data panels based on the
current terminal width. By default, hexyl will show two panels, unless
the terminal is not wide enough for that
.HP
\fB\-g\fR, \fB\-\-group\-size\fR <N>
.IP
Number of bytes/octets that should be grouped together. You can use
the '\-\-endianness' option to control the ordering of the bytes within
a group. '\-\-groupsize' can be used as an alias (xxd\-compatibility)
.IP
[default: 1]
.IP
Possible values:
\- 1: Grouped together every byte/octet
\- 2: Grouped together every 2 bytes/octets
\- 4: Grouped together every 4 bytes/octets
\- 8: Grouped together every 8 bytes/octets
.HP
\fB\-\-endianness\fR <FORMAT>
.IP
Whether to print out groups in little\-endian or big\-endian format.
This option only has an effect if the '\-\-group\-size' is larger than 1.
\&'\-e' can be used as an alias for '\-\-endianness=little'
.IP
[default: big]
.IP
Possible values:
\- little: Print out groups in little\-endian format
\- big:    Print out groups in big\-endian format
.HP
\fB\-b\fR, \fB\-\-base\fR <B>
.IP
Sets the base used for the bytes. The possible options are binary,
octal, decimal, and hexadecimal
.IP
[default: hexadecimal]
.HP
\fB\-\-terminal\-width\fR <N>
.IP
Sets the number of terminal columns to be displayed.
Since the terminal width may not be an evenly divisible by the width
per hex data column, this will use the greatest number of hex data
panels that can fit in the requested width but still leave some space
to the right.
Cannot be used with other width\-setting options.
.HP
\fB\-\-print\-color\-table\fR
.IP
Print a table showing how different types of bytes are colored
.HP
\fB\-i\fR, \fB\-\-include\fR
.IP
Output in C include file style
.HP
\fB\-\-completion\fR <SHELL>
.IP
Show shell completion for a certain shell
.IP
[possible values: bash, elvish, fish, powershell, zsh]
.HP
\fB\-h\fR, \fB\-\-help\fR
.IP
Print help (see a summary with '\-h')
.HP
\fB\-V\fR, \fB\-\-version\fR
.IP
Print version