https://github.com/yinguobing/xcap
Single binary to extract ROS messages from MCAP files.
https://github.com/yinguobing/xcap
mcap ros ros2 rust
Last synced: 20 days ago
JSON representation
Single binary to extract ROS messages from MCAP files.
- Host: GitHub
- URL: https://github.com/yinguobing/xcap
- Owner: yinguobing
- License: gpl-3.0
- Created: 2024-07-14T07:54:39.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-07-03T04:06:56.000Z (11 months ago)
- Last Synced: 2025-07-03T05:21:09.454Z (11 months ago)
- Topics: mcap, ros, ros2, rust
- Language: Rust
- Homepage:
- Size: 172 KB
- Stars: 0
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# xcap
Single binary to extract ROS messages from MCAP files.
## Features
- Supported messages: `Image`, `CompressedImage`, `PointCloud2`
- Support sliced MCAP files
- Visualization with Rerun
- Support MinIO as input source
## Installation
Download the latest release from the [releases page](https://github.com/yinguobing/xcap/releases).
Install using `dpkg`:
```bash
sudo dpkg -i xcap__amd64.deb
```
**Optional** Install Rerun viewer if you need realtime visualization:
```bash
# install with
cargo install rerun-cli
# or..
pip install rerun-sdk
```
## Usage
Xcap supports MCAP file extracting, trimming and visualization.
### Extract
Extract from a single MCAP file
```bash
xcap extract -i /path/to/your.mcap -o /path/to/output --topics /lidar /image
```
Extract from a local directory containing multiple MCAP files
```bash
xcap extract -i /path/to/mcap/dir -o /path/to/output --topics /lidar /image
```
Extract from a MinIO bucket:
```bash
export S3_ACCESS_KEY="YOUR_KEY"
export S3_SECRET_KEY="YOUR_SECRET"
export S3_REGION="YOUR_REGION"
xcap extract -i "http://your_minio:port/bucket_name/path/to/one_of_the_mcap_file.mcap" -o /path/to/output --topics /lidar /image
```
### Trim
Trim the mcap file.
```bash
xcap trim -i /path/to/mcap/dir --time-off "2024-12-05 09:50:20" --time-stop "2024-12-05 09:50:25"
```
### Visualize
Visualize the data, do not dump any to disk.
```bash
xcap show -i /path/to/mcap/dir --topics /lidar
```
## Build
Build the binary
```bash
cargo build --release
```
Build the deb package if you want to share it with others
```bash
cargo deb --package xcap --install
```