NAME

heme - console hex editor

SYNOPSIS

heme [ -d, --disable-colors ] [ -c, --config-file CONFIGFILE ] [ -n, --no-backup-files ] [ -h, --help ] [ -v, --version ] file

DESCRIPTION

heme is intended to be fast and portable console hex editor for unix systems. It has undo support (number of undo operations is only limited by available memory), ability to fill a range of addresses with the specified byte, ability to search for a single byte or character string. Offsets can be given in hexadecimal, octal or decimal. There are two editing modes: hex and ascii. In hex mode you type hexadecimal digits and in ascii mode you type characters. In the ascii mode cursor is automatically moved to the next byte after typing a character (this behaviour is configurable for hex mode). heme uses curses library for screen and input handling. Colors are supported and they may be configured in the configuration file (see below). If the configuration file isn't present, heme will use defaults. You may also specify which configuration file to use with the -c command line option.

OPTIONS

-n, --no-backup-files

Don't make backup files.

-c, --config-file CONFIGFILE

Read configuration from CONFIGFILE. If not given, heme will try to read ~/.hemerc. If that fails, defaults will be used.

-d, --disable-colors

Don't use colors.

-h, --help

Show all available command line options.

-v, --version

Show heme version.

USAGE

Keys (all are case-insensitive, except in the ascii mode):

left (right)

Move to previous (next) byte

up (down)

Move to previous (next) line

<

Move to beginning of line

>

Move to end of line

page up

Move 1 page up

page down

Move 1 page down

home

Move to beginning of file

end

Move to end of file

h

Display help screen

j

Jump to offset

n (w)

Search for byte (string)

r

Repeat last search

l

Fill range with byte

tab

Toggle between hex and ascii editing modes

u

Undo

s

Save file

q

Quit

CONFIGURATION

Configuration file is expected to reside in ~/.hemerc. The syntax is very simple:

# this is a comment
option_1 = value
option_2 = "value 2"

Everything beyond the '#' is considered a comment and is ignored to the end of that line. Supported options are:

use_colors

Set this to 1 if you want colors, 0 otherwise (default: 1)

advance_after_edit

Set this to 1 if you want to advance to the next byte after editing byte at the current offset (default: 1)

make_backup_files

Set this to 1 if you want heme to make backup files, 0 otherwise (default: 1)

bg_color

Background color (default: "blue")

fg_color

Foreground color (default: "white")

bg_color_selected

Background color of selected byte (default: "black")

fg_color_selected

Foreground color of selected byte (default: "green")

bg_color_status

Background color of status lines (default: "cyan")

fg_color_status

Foreground color of status lines (default: "black")

Color names are "black", "red", "green", "yellow", "blue", "magenta", "cyan" and "white".

EXAMPLE

# This is sample configuration file.
advance_after_edit = 0
make_backup_files = 1
use_colors = 1
bg_color = black
fg_color = white
bg_color_selected = green
fg_color_selected = yellow
bg_color_status = blue
fg_color_status = white

FILES

~/.hemerc

User's configuration file.

LICENSE

heme is distributed under the GNU General Public License. For details see the file COPYING included in the source distribution.

BUGS

Some portability problems, probably. Send bug reports to <pokemon@fly.srk.fer.hr>.

AUTHORS

Ivan Stankovic <pokemon@fly.srk.fer.hr>