# flamelens
`flamelens` is an interactive flamegraph viewer in the terminal.
## What is it?
Flamegraph tools such as [FlameGraph](https://github.com/brendangregg/FlameGraph) and
[inferno](https://github.com/jonhoo/inferno) process output from various profiling tools and
generate intermediate data in the "folded" format ready for flamegraph plotting. Instead of plotting
the flamegraph as an SVG file, `flamelens` takes the folded stacks data and generate an interactive
flamegraph in the terminal.
No more hauling SVG files and opening a browser just to have a quick look at the profiling result!
## Usage
Run `flamelens` with the filename of the profiling data in the form of "folded stacks":
```
flamelens <folded-stacks-filename>
```
You can also pipe data directly to `flamelens` without providing a filename.
### cargo-flamegraph
If you used `cargo flamegraph` to profile your program on Linux, you would have a `perf.data` file
generated by `perf`. You can visualize it in `flamelens` this way with the help of
[inferno](https://crates.io/crates/inferno):
```
### Python
Display a live flamegraph of a running Python program using
[`py-spy`](https://github.com/benfred/py-spy) as the profiler:
```
flamelens --pid <pid-of-python-program>
```
This requires enabling the `python` feature when installing.
<details>
<summary>Example of a live flamegraph</summary>
</details>
## Key bindings
`hjkl` (or `← ↓ ↑→ `) | Navigate cursor for frame selection
`f` | Scroll down
`b` | Scroll up
`G` | Scroll to bottom
`g` | Scroll to top
`Enter` | Zoom in on the selected frame
`Esc` | Reset zoom
`/<regex>` | Find and highlight frames matching the regex
`#` | Find and highlight frames matching the selected frame
`n` | Jump to next match
`N` | Jump to previous match
`r` | Reset to default view
`z` (in Live mode) | Freeze the flamegraph
`q` (or `Ctrl + c`) | Exit
## Installation
If you have [Rust](https://www.rust-lang.org/tools/install) installed, `flamelens` is available on
[crates.io](https://crates.io/crates/flamelens) and you can install it using:
```
cargo install flamelens --locked
```
If you want the live flamegraph functionality, install with the `--all-features` option:
```
cargo install flamelens --locked --all-features
```
Alternatively, build and install from source after cloning this repo:
```
cargo install --path $(pwd) --locked
```