Spatial Stash (Apple Vision Pro Client)

Plugins Other Projects
, , ,
1
:placard: Summary Client for Stash photo organizer with 2D → 3D photo conversion support.
:link: Repository https://github.com/illixion/SpatialStash

This is a small client app I wrote for my Vision Pro to try the 3D image conversion feature, I don’t have a paid developer account so I can’t publish it on the App Store, but you can run this on your own device easily via Xcode with a free account.

Installation

  1. Clone the repository via git, or click here to download as a ZIP:

    git clone https://github.com/illixion/spatialstash.git
cd spatialstash

  2. Open the project in Xcode:

    open SpatialStash/SpatialStash.xcodeproj

  3. Select your development team in Xcode (Project → Signing & Capabilities)

  4. Build and run on visionOS Simulator or device (Cmd+R)

Features

  • 2D to 3D Conversion - Uses Apple’s RealityKit to convert standard images into spatial 3D photos viewable on Vision Pro

  • Stash Server Integration - Connect to your Stash media server via GraphQL API to browse images and videos

  • Advanced Filtering - Filter by galleries, tags, ratings, and O-count with saved filter presets

  • Video Playback - Stream videos directly from your Stash server

Screenshots

home
home1920×1080 116 KB
viewer
viewer1920×1080 115 KB

filters
filters1920×1080 71.6 KB
settings
settings1920×1080 73.1 KB

2

Excellent project. Looking forward to its development.

Do you think it would be possible to add support for VR videos so that they are displayed correctly? (instead of a split 2D view)?

3

Thank you for the nice feedback! I’ve created a new branch called feature/3d-sbs-videos with a feature that downloads your stereoscopic videos and converts them to MV-HEVC on the fly, you just need to tag your video with “stereoscopic”, “3d”, “vr”, or “stereogram”. You can also add sbs, ou, or other tags as shown here to specify what kind of a 3D video it is. Can’t test it on a real device right now, but let me know how it works for you.

4

Just pushed a new commit that adds 3D video support, local Files import, and UI improvements.

List of changes

Added 3D tags, apply them to a scene/video to activate the 3D video player, which works by converting to MV-HEVC locally. Note that converted videos are cached, so if the tags are changed, you must clear video cache for the file to be converted again.

  • Enable 3D:

    • stereoscopic
    • 3d
    • vr
    • stereogram

  • SBS (Side-by-Side):

    • sbs
    • side-by-side
    • sidebyside
    • side by side

  • Over-Under:

    • ou
    • over-under
    • overunder
    • over under

  • Top-and-Bottom:

    • tab
    • top-and-bottom

  • Half-SBS (Half-SBS):

    • hsbs
    • half-sbs
    • half sbs

  • Half-OU (Half-Over-Under):

    • hou
    • half-ou
    • half ou

  • Swap eyes

    • stereo_eyes_reversed
    • stereo-eyes-reversed
    • eyes_reversed
    • eyes-reversed

  • Added Files app integration for local media, can be selected as a source in settings

  • Added video filter support

  • Added video caching

  • Set default and minimum window sizes