Skip to content

Repository files navigation

Open360

Open360 is a Linux-native workflow for importing, verifying, stitching and viewing photographs from Samsung Gear 360 cameras. The SM-R210 workflow is verified, while SM-C200 still-photo stitching is currently experimental. Open360 is developed and maintained by Rockhop.

Release status

1.0.0 is the first stable Linux release. The complete camera-to- browser workflow has passed controlled tests, clean-install testing and real-world use with an installed release. Broader-user feedback will guide subsequent releases.

What Open360 does

  • detects and mounts a connected SM-R210 over MTP through GIO/GVFS;
  • imports from the camera, an SD card or an ordinary copied folder;
  • verifies new imports with SHA-256 before finalising them;
  • preserves camera originals unchanged;
  • stitches dual-fisheye JPEG photographs into equirectangular panoramas;
  • selects the calibrated SM-R210 or SM-C200 Hugin template from EXIF camera metadata;
  • isolates temporary stitching work and atomically finalises successful output;
  • generates thumbnails and a responsive, searchable Pannellum gallery;
  • serves only the generated gallery runtime, not originals or logs;
  • reports configuration, dependency, provider and archive status.

Current scope

Open360 currently targets Linux and the Samsung Gear 360 SM-R210. Experimental still-photo stitching support is also included for the SM-C200, but output quality has not yet been validated using genuine C200 photographs.

Still photographs are the supported processing workflow. MP4 files are imported, verified and preserved in the originals archive, but 360-video stitching and playback are not yet implemented.

Direct USB camera access currently uses the Linux GIO/GVFS provider. Importing from an SD card or filesystem folder is available when desktop MTP integration is unavailable or undesirable.

Install

Open360 does not bundle Hugin, Enblend, ExifTool or ImageMagick. Review the requirements in Installing Open360 on Linux, then run:

./install.sh

The default installation uses:

Application: ~/.local/share/open360/app
Commands:    ~/.local/bin
Config:      ~/.config/open360/config.toml
Data:        ~/Pictures/Open360

Ensure ~/.local/bin is in PATH, then inspect the installation:

open360 --version
open360-status

A fresh installation may report the gallery as NOT GENERATED YET. That is normal until open360, open360-gallery or open360-view runs for the first time.

Quick start

Connected camera:

open360

SD card or copied camera folder:

open360 --source /path/to/source

Open the panorama gallery:

open360-view

Run a complete content-hash audit instead of the normal fast repeat scan:

open360 --full-scan

Commands

Command Purpose
open360 Run the complete import, stitch and gallery pipeline
open360-mount Detect and mount the Gear 360 through GIO/GVFS
open360-sync Import and verify media from an explicit source directory
open360-stitch Stitch one imported photograph
open360-gallery Regenerate gallery metadata and thumbnails
open360-view Start and open the browser gallery
open360-config Show resolved configuration values
open360-status Display diagnostics and dependency readiness
open360-uninstall Remove the installed application while preserving user data

Commands can also be run from a source checkout as ./bin/COMMAND.

Safety model

  • Imported originals are never modified by stitching or gallery generation.
  • New imports are copied through .part files and verified before finalisation.
  • Panoramas are created in isolated workspaces and moved into place atomically.
  • Installer upgrades preserve the configured archive and existing configuration.
  • The uninstaller removes application files and recognised launchers only.
  • The gallery listens on localhost by default and has no built-in authentication or HTTPS. Do not expose it to an untrusted network.

Documentation

Licence

Open360's original code is available under the MIT License. See LICENSE. Third-party attribution is collected in THIRD_PARTY_NOTICES.md.

About

Linux-native import, stitching and gallery workflow for the Samsung Gear 360 SM-R210

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages