Metadata-Version: 2.3
Name: digitalis
Version: 0.6.2
Summary: Terminal-based visualization tool for robotics development
Keywords: mcap,robotics,ros,ros2,visualization,tui,terminal
Author: Marko Bausch
License: GPL-3.0
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Typing :: Typed
Requires-Dist: lark>=1.2.2
Requires-Dist: mcap-ros2-support-fast
Requires-Dist: pointcloud2>=0.2.3
Requires-Dist: ros-parser
Requires-Dist: small-mcap[compression]
Requires-Dist: textual>=5.1.1
Requires-Dist: textual-image>=0.8.3
Requires-Dist: textual-slider>=0.2.0
Requires-Dist: textual-speedups>=0.2.0 ; platform_machine == 'arm64' and sys_platform == 'darwin'
Requires-Dist: typing-extensions>=4.14.1
Requires-Dist: websocket-bridge
Requires-Dist: websockets>=15.0.1
Requires-Python: >=3.10
Project-URL: Homepage, https://github.com/mrkbac/robotic-tools
Project-URL: Issues, https://github.com/mrkbac/robotic-tools/issues
Project-URL: Repository, https://github.com/mrkbac/robotic-tools
Description-Content-Type: text/markdown

# Digitalis

Terminal-based visualization tool for robotics development.

![Digitalis](./screenshot.svg)

## Installation

```sh
# Run directly without installing
uvx digitalis recording.mcap

# Or add to your project
uv add digitalis
```

## Features

- Browse and visualize MCAP files and live WebSocket streams
- Specialized panels for common ROS message types:
  - Images (CompressedImage, Image)
  - Point clouds (PointCloud2)
  - TF transforms
  - NavSatFix (GPS)
  - Occupancy grids
  - Diagnostics
  - Raw message data (JSON)
- Time-based playback controls
- Topic filtering and search
- SSH-optimized mode (auto-detected)

## Data Sources

- Local MCAP files
- HTTP/HTTPS URLs to MCAP files
- WebSocket streams (Foxglove WebSocket protocol)

## Usage

```sh
uvx digitalis <path or websocket URL>
```

Examples:
```sh
# Open a local MCAP file
uvx digitalis recording.mcap

# Open from URL
uvx digitalis https://example.com/data.mcap

# Connect to a WebSocket stream
uvx digitalis ws://localhost:8765
```

## Controls

- `q` - Quit
- Arrow keys / mouse - Navigate topics and panels
- Space - Play/pause playback
- `/` - Search topics

## Debug

```sh
uv run textual run --dev digitalis.app:main
```
