# Cepton Viewer

The Cepton Viewer tool allows viewing raw Cepton sensor data. It is primarily used for sensor debugging.

- View live or replay sensor data.
- View sensor information.
- Update extrinsic sensor transforms.

### Downloads

- [Windows](https://github.com/ceptontech/cepton_sdk_redist/raw/master/setup/cepton_sdk-win64.exe)
- [OSX](https://github.com/ceptontech/cepton_sdk_redist/raw/master/setup/cepton_sdk-osx.dmg)
- [Linux](https://github.com/ceptontech/cepton_sdk_redist/raw/master/setup/cepton_sdk-linux-x86_64.deb)

On Linux, you will need to set a static IP for the Ethernet interface: `192.168.0.1/16` ([tutorial](https://www.cepton.com/downloads/videos/cepton_viewer_ubuntu_network.mp4)).

### Tutorials

- [Overview](https://www.cepton.com/downloads/videos/cepton_viewer_overview.mp4)
- [Network Capture](https://www.cepton.com/downloads/videos/cepton_viewer_capture.mp4)
- [Sensor Settings](https://www.cepton.com/downloads/videos/cepton_viewer_settings.mp4)

### Main Menu

- Hover over menu items to view tooltips.
- When editing value fields, press `ESC` to undo new value and `ENTER` to accept new value.

### Camera Controls

| Command        | Mouse     |
| -------------- | --------- |
| Rotate View    | `LButton` |
| Translate View | `RButton` |
| Zoom View      | `MButton` |

### Workflows

#### Open Capture

- Drag and drop capture file/folder onto the main window.

`OR`

- Switch to `General` tab.
- Select `Capture` -> `Load Capture`.

#### Save Capture

- Switch to `General` tab.
- Select `Capture` -> `Start Capture`.
- Wait for desired duration.
- Select `Capture` -> `Stop Capture`.

The capture is saved at `~/Documents/CeptonViewer/<date>/capture_<time>`.

#### Take Screenshot

- Switch to `General` tab.
- Select `Tools` -> `Screenshot`.

The screenshot is saved at `~/Documents/CeptonViewer/<date>/screenshot_<time>.png`.

#### Update Sensor Transforms/Clips

- Switch to `Settings` tab.
- For each sensor, update the transforms/clips.
- Select `File` -> `Save`/`Save As...`.

### Keyboard Shortcuts

#### GUI

| Command  | Key   |
| -------- | ----- |
| Hide GUI | `F11` |

#### Replay

| Command      | Key     |
| ------------ | ------- |
| Pause/Resume | `SPACE` |

#### View

| Command                  | Key |
| ------------------------ | --- |
| Reset Camera Translation | `O` |
| Camera Front View        | `1` |
| Camera Top View          | `2` |
| Camera Side View         | `3` |