Skip to content

Add GPU support#20

Merged
syncom merged 5 commits into
mainfrom
syncom/add-gpu-support
Jun 6, 2026
Merged

Add GPU support#20
syncom merged 5 commits into
mainfrom
syncom/add-gpu-support

Conversation

@syncom

@syncom syncom commented Jun 5, 2026

Copy link
Copy Markdown
Owner

Summary

This PR updates the Docker-based Insta360 CLI workflow to support both CPU-only and NVIDIA GPU processing, while keeping the older MediaSDK as the default for machines without a GPU.

  • MediaSDK flexibility — Adds support for MediaSDK 3.1.1.0 (GPU-required) via a MEDIASDK_UBUNTU_DEB build argument, while defaulting to the older 2.0-6 package for CPU-only use. Updates .gitignore for the new .deb filename and datadir/.
  • Docker image — Moves the base image to Ubuntu 24.04 and simplifies SDK installation (apt install of the .deb). Trims unnecessary build dependencies from the intermediate 3.1.x upgrade in favor of a leaner image that works with either SDK version.
  • GPU workflow — Documents how to run the container with NVIDIA GPU support (--runtime=nvidia --gpus all), including one-time setup of the NVIDIA Container Toolkit.
  • CPU workflow — Documents running without a GPU using MediaSDK versions below 3.0.0, and keeps that as the default build path.
  • join-insv — Removes an existing output file before calling exiftool, avoiding failures on re-runs.
  • Documentation — Expands README with separate GPU and non-GPU instructions, correct docker run/docker build examples, and join-insv usage (including --is_57k for 5.7K). Container startup is documented in the README rather than via a helper script.

Test plan

  • Build the image with the default (2.0-6) SDK and confirm CPU-based conversion works
  • Build the image with MEDIASDK_UBUNTU_DEB=libMediaSDK-dev-3.1.1.0-20250922_191110-amd64.deb on a machine with an NVIDIA GPU
  • Run the container with --runtime=nvidia --gpus all and confirm GPU-accelerated processing
  • Run join-insv on 4K and 5.7K inputs; verify re-running with the same output path succeeds
  • Confirm the merged output plays as 360° video in VLC and retains spherical metadata

padcom and others added 5 commits June 5, 2026 10:47
Update the Dockerfile and documentation to support running the Insta360
media SDK tools with and without an NVIDIA GPU.

- Simplify installation of the media SDK in Dockerfile
- Update README.md to support both cases (with and without GPU)
- Remove start.sh

  It's trivial to write a host-side script for building and running the
  Docker container. We provide the recipe in README.md, and will not
  provide the starting script.
This is so that one can use git clean -df to clean up datadir/
Update `README.md` to add a tip for cleaning up `datadir/`.

Tweak `.gitignore` to remove `datadir/**` from the list.
@syncom syncom merged commit 52dde95 into main Jun 6, 2026
2 checks passed
@syncom syncom deleted the syncom/add-gpu-support branch June 6, 2026 00:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants