fx

README

The Swiss Army Knife for examining text files. Combining the most useful functionalities from (z)cat, (z)less, head, tail, grep, hexdump, sha256sum, sha1sum, md5sum, wc and jq into one performant standalone tool.

As this is a forensic tool, no write actions will be performed.

Install

make install

Usage

fx [-p] [-h | -t] [-n # | -c #] [-x | -e PATTERN] [-o FILE] [PATH ... | -]

Special options:

• -p Print raw
• -h Limit head
• -t Limit tail
• -n Lines count
• -c Bytes count
• -x Hexdump mode
• -e Pattern value
• -o Evidence file

Default options:

• --help Usage information
• --version Version number

Examples

Reading all files in the current directory:

fx

Reading directly from stdin:

fx -

Reading gzip compressed files:

fx foo.gz bar.gz

Reading all .jsonl files in all subdirectories:

fx ./*/*.jsonl

Writing all lines with John Doe from all files to stdout:

fx -p -e "John Doe"

Writing the first 3 lines of foo to bar:

fx -h -n 3 foo > bar

Writing the last 8 bytes of foo to bar in hex:

fx -t -c 8 -x foo > bar

Keymap

General

Shortcut	Action
Esc	Exit
F1 / Ctrl + l	Less mode
F2 / Ctrl + g	Grep mode
F3 / Ctrl + x	Hex mode
F4 / Ctrl + Space	Goto mode
F9	Show file(s) counts
F10	Show file(s) MD5
F11	Show file(s) SHA1
F12	Show file(s) SHA256
Tab	Load next file
Shift + Tab	Load prev file
Shift + Up	Scroll page up
Shift + Down	Scroll page down
Shift + Left	Scroll page left
Shift + Right	Scroll page right
Ctrl + Shift + Up	Scroll to start
Ctrl + Shift + Down	Scroll to end
Ctrl + r	Reload file
Ctrl + q	Close file
Ctrl + t	Cycle themes
Ctrl + f	Toggle file follow
Ctrl + n	Toggle line numbers
Ctrl + w	Toggle text wrap
Ctrl + c	Copy to clipboard
Ctrl + s	Save as evidence

Less Mode

Shortcut	Action
Space	Scroll page down

Grep Mode

Shortcut	Action
Enter	Append filter
Backspace	Delete filter
Alt + Up	Prev input in history
Alt + Down	Next input in history
Ctrl + v	Paste input
Any Key	Filter content

Config

Located under ~/.fxrc.

Theme = "Default"
Follow = false
Line = false
Wrap = false

Environment

FX_THEME=Default

Themes

• Default
• Monokai
• Catppuccin-Latte
• Catppuccin-Frappe
• Catppuccin-Macchiato
• Catppuccin-Mocha
• Ansi
• Matrix
• Monochrome

---

Made with ❤ in Go