flamelens

Interactive flamegraph viewer in the terminal

TLDR

View a folded stacks file

$ flamelens [folded-stacks.txt]

Pipe profile data directly

$ [profiler] | flamelens

Search within the flamegraph

$ flamelens [file] -s [pattern]

flamelens is an interactive flamegraph viewer that runs in the terminal. It allows users to explore profiling data in a visual, navigable format without requiring a web browser or GUI.The tool supports folded stack format (generated by tools like perf, dtrace, or brendan gregg's stack collapse scripts) and provides vim-style navigation, search, and zoom capabilities.

PARAMETERS

-s, --search PATTERN

Search for pattern in stacks

--no-unicode

Use ASCII instead of Unicode characters

--no-color

Disable colored output

-h, --help

Display help and exit

-V, --version

Display version and exit

KEYBINDINGS

↑/↓ or k/j

Navigate up/down through frames

←/→ or h/l

Zoom out/in on selected frame

Search mode

n/N

Next/previous search result

Enter

Focus on selected frame

Esc

Exit zoom/return to full view

Quit

INSTALL

sudo pacman -S flamelens

nix profile install nixpkgs#flamelens

CAVEATS

Requires folded stack format input. Very large profiles may impact performance. Terminal must support Unicode for best display. Some profilers require additional scripts to produce compatible output.

HISTORY

flamelens was created as a terminal-based alternative to web-based flamegraph viewers, enabling profile analysis in server environments without browser access.