NAME
hexcurse - an ncurses-based hex editor
SYNOPSIS
hexcurse [ -? | -help ] [ -a ] [ -r rnum ] [ -o outputfile ] [ [ -i ]
inputfile ]
DESCRIPTION
hexcurse is an ncurses-based hexeditor utility that is able to open,
modify, and save a file to disk while providing useful editing and
searching options.
OPTIONS
-? | -help Prints out the command usage info
-a Specifies the addresses to be output in decimal format
initially.
-r rnum Specifies the number of characters per line that the
hexeditor should output. If rnum is either less than 1
or greater than the columns of the current terminal,
hexcurse will fill the terminal width, just as if the -r
was not specified.
-o outputfile Specifies the output file to be written to by default.
[-i] inputfile Specifies the input file to be read in. -i is not
needed if inputfile is the last argument on the line.
INTERACTIVE OPTIONS
F1 | ctrl+? Shows key command help.
F2 | ctrl+s Save the current file.
F3 | ctrl+o Opens a file.
F4 | ctrl+g Goto a certain location in the current file. Depending
on which way the addresses are being viewed at the
moment, the search will behave differently. If the
addresses are currently in hex format, the search will
search as if the input was given in hexadecimal format.
If the addresses are in decimal format, the function
will search for the address in decimal.
F5 | ctrl+f Search for a certain string in the current file.
Depending on which window the user is currently editing
in, this search will behave differently. If editing in
the hex window, the input should only be in hexadecimal,
and it will search for the hexadecimal "string." If the
current editing window is the ASCII window, the input
should be ASCII characters, and the search will find
that ASCII string in the file.
F6 | ctrl+a Switch between hexadecimal address values and decimal
address values.
F7 | TAB Switch between the hexadecimal and ASCII editing
windows.
F8 | ctrl+q | ctrl+x
Exit out of the program.
Page Up | ctrl+u
Scroll one ’page’ up.
Page Down | ctrl+d
Scroll one ’page’ down.
Home | ctrl+t Returns to the top of the file.
End | ctrl+b Jumps to the bottom of the file.
ctrl+z Undo the last modification. Can be used multiple times.
Esc Escapes out of the save, open, goto, and find prompts.
SEE ALSO
hexdump(1) , ncurses(3)
AUTHORS
The authors of hexcurse are:
jewfish <jewfish@jewfish.net>
armoth <uknowho@jewfish.net>
The current version of this software is always availabe at
http://www.jewfish.net/software.php
BUGS
On some terminals the function keys will not work.
Support for resizable terminals is still a bit rudimentary. At this
time, when the terminal is resized, the cursor is positioned at the
beginning of the file. This will be corrected in the next release.
There is also an issue where the labels on the bottom of the screen do
not resize correctly. A fix for the latter is in the works.
To report a bug or problem, please e-mail:
devel@jewfish.net
TODO
When we get the time, we would like to implement the ability to insert
and delete data from the file. Please e-mail us with any additional
suggestions.
22 December 2003