PULSEVIEW(1)

💖 PULSEVIEW 💖 (section 1 of the General Commands Manual, bestie)

okay so. picture this: you got test & measurement gear — logic analyzers, oscilloscopes, MSOs, and like, more — and you want a GUI. not a crusty terminal thing. a whole pretty window. that's PulseView, and she's a cross-platform Qt-based GUI for the sigrok software suite. she does not care what OS you're on, she's showing up. 🦋

---

✨ SYNOPSIS ✨

pulseview [OPTIONS] [FILE]

that's it. that's the whole vibe check. 💅

---

🌸 DESCRIPTION 🌸

PulseView is a cross-platform Qt-based GUI for the sigrok software suite, which is the whole ecosystem for test and measurement equipment — think logic analyzers, oscilloscopes, MSOs, and more. it's giving "plug the thing in, look at the pretty waveforms". main character energy fr fr. 👑

---

🎀 OPTIONS 🎀

okay so lowkey PulseView barely has any command line options, because most of the configuration lives inside the GUI itself. iconic behaviour honestly. but here's the whole list, no cap, all of it:

• -l, --loglevel — sets the libsigrok and libsigrokdecode loglevel. rn PulseView can't set the two loglevels independently, that's just how it is. the higher the number, the more debug output gets printed. the valid loglevels are:
  • 0 — None
  • 1 — Error
  • 2 — Warnings
  • 3 — Informational
  • 4 — Debug
  • 5 — Spew
• -h, -?, --help — shows a help text and then dips. 🫶
• -V, --version — shows version info and exits. slay.
• -d, --driver <drivername> — tell her which capture device to connect to. if you don't pass --driver, PulseView tries to re-connect to the most recently used device, or auto-detects whatever devices are available. she's flexible like that. 💅
• -D, --dont-scan — normally PulseView automatically scans all the drivers at startup to find suitable devices. this option turns that auto-scan off. so then you either pass --driver to pick a device at startup, or you scan for devices interactively after PulseView has finished starting up. your call, bestie. ✨
• -i, --input-file <filename> — load input from a file. if --input-format isn't supplied, PulseView tries to load the file as a sigrok session file.
• -I, --input-format <format> — specifies the format of the input file to be loaded. 🍓
• -s, --settings <filename> — loads a PulseView session setup to use with the input file. the setup file has to be in the "PulseView session setup" format (.pvs). no other format, that's the rule.
• -c, --clean — stops previously used sessions from being restored out of settings storage. this is the move when you want only a single session with the file you passed on the command line, instead of that file plus all your previously used sessions getting restored alongside it. lowkey a lifesaver. 😭

and yeah, if the optional FILE argument is supplied, PulseView tries to open that file. it has to be in the "libsigrok session" format (.sr) — unless you used -I to specify the input file format. don't forget that part.

---

⌨️ KEYBOARD SHORTCUTS ⌨️

the hotkeys. the little secrets. learn them and you're unstoppable. 🔥

• f — zoom-to-fit.
• s — enable / disable sticky scrolling. when it's on, the right edge of the screen always shows the most recently captured data.
• . — show / hide sampling points.
• g — show / hide the analog minor grid (this is in addition to the vdiv grid, not instead of it).
• c — show / hide cursors.
• d — show / hide the protocol decoder selector.
• b — toggle between coloured trace backgrounds and alternating light/dark gray trace backgrounds.
• SPACE — start / stop an acquisition.
• Left/right arrow keys — scroll left/right.
• +/- — zoom in/out.
• Up/down arrow keys — zoom in/out.
• Home/End — jump to the start/end of the sample data.
• 1/2 — attach the left/right side of the cursors to the mouse.
• CTRL+o — open file.
• CTRL+s — Save as...
• CTRL+r — Save selected range as...
• CTRL+g — group all currently selected traces into a trace group.
• CTRL+u — ungroup the traces in the currently selected trace group.
• CTRL+up/down arrow keys — scroll down/up.
• CTRL+q — quit, i.e. shutdown PulseView (which closes all session tabs).
• CTRL+w — close the current session tab.

---

🚪 EXIT STATUS 🚪

PulseView exits with 0 on success, and 1 on most failures. that's the whole story. ✨

---

👀 SEE ALSO 👀

• sigrok-cli(1)

---

💀 BUGS 💀

please report any bugs via Bugzilla (http://sigrok.org/bugzilla) or on the sigrok-devel mailing list (sigrok-devel@lists.souceforge.net). she wants to hear from you, genuinely. 🫶

---

📜 LICENSE 📜

PulseView is covered by the GNU General Public License (GPL), version 3 or later.

---

👑 AUTHORS 👑

please see the individual source code files.

this manual page was written by Uwe Hermann <uwe@hermann-uwe.de>. it is licensed under the terms of the GNU GPL (version 2 or later).

---

okay bestie that's the whole page 💖 this one's from the General Commands Manual, dated March 31, 2020 — go capture something iconic with her. periodt. 🌈⭐