Waveform viewer

Install GTKWave to inspect VCD, FST, and related traces.

GTKWave is the viewer you open after simulation when you want to see signals over time. The official site still hosts source releases and a Flatpak, while newer macOS users need to follow the project’s own note about the community Homebrew tap.

Best for: waveform debug Works after: Verilator or Icarus simulation Last verified: April 4, 2026
Linux quick path

Use a package or the official Flatpak

The GTKWave homepage lists Flathub as an official distribution path, and most Linux distributions package `gtkwave` directly.

flatpak install flathub io.github.gtkwave.GTKWave
sudo apt-get install gtkwave
macOS quick path

Use the community Homebrew tap

The official GTKWave site explicitly says the older LTS macOS build is not compatible with current macOS releases and points users to the community Homebrew tap instead.

brew tap randomplum/gtkwave brew install randomplum/gtkwave/gtkwave

Keep the linked GitHub issue handy if you hit macOS-specific launch problems.

Windows quick path

Use the official project downloads

The official project still publishes source and LTS distribution material from the GTKWave website and SourceForge. Use the current Windows build from the official project download path rather than a random mirror.

1. Download from the official GTKWave project page 2. Extract or install 3. Launch gtkwave.exe
Verify
gtkwave --version

Success looks like the viewer printing its version or opening without a library error.

First useful command
gtkwave waves.vcd

If your simulator emits FST instead, open that file the same way.

Common pitfalls
  • The older LTS macOS zip on the official site is not compatible with current macOS versions.
  • GTKWave is a viewer only; it does not run simulation by itself.
  • If a trace file looks empty, check that your simulator actually enabled dumping.
Good pairing

The fastest beginner loop is often: compile and run with Verilator or Icarus, emit a VCD or FST file, then open that file in GTKWave.

Copyright and license

This guide summarizes the GTKWave project’s own published install paths and links back to the official site, docs, and repo. It does not mirror the full upstream manual or reuse project images.