Installation Guide

Get Immersity AI Subscription

Before using ImmersityLens, you need an active subscription to Immersity AI.

• Visit Immersity AI Pricing
• Choose a subscription plan that suits your needs
• Complete the registration and payment process
• Save your API credentials for the next step

Configure API Credentials

Enter your Immersity AI subscription credentials in the extension.

• After installing the extension (see Manual Installation tab)
• Click the ImmersityLens icon in your browser toolbar
• Enter your Immersity AI API key in the popup
• Click "Save" to store your credentials securely

Verify Subscription Status

Ensure your subscription is active and working properly.

• The extension popup will show your subscription status
• Green indicator means your subscription is active
• Red indicator means there's an issue with your credentials or subscription
• Contact Immersity AI support if you encounter issues

Download & Extract

Download the extension zip file and extract it to a folder on your computer.

• Click the download button above
• Extract the zip file to a permanent location (don't delete this folder)
• Remember the folder location - you'll need it in the next step

Open Chrome Extensions

Navigate to Chrome's extension management page.

• Open Google Chrome
• Type chrome://extensions/ in the address bar
• Or go to Menu → More Tools → Extensions

Enable Developer Mode

Turn on Developer Mode to install unpacked extensions.

• Look for the "Developer mode" toggle in the top-right corner
• Click to enable it
• New buttons will appear: "Load unpacked", "Pack extension", etc.

Load the Extension

Install ImmersityLens by loading the unpacked extension.

• Click the "Load unpacked" button
• Navigate to the folder where you extracted the extension
• Select the folder and click "Select Folder"
• ImmersityLens should now appear in your extensions list

Pin the Extension

Pin ImmersityLens to your toolbar for easy access.

• Click the puzzle piece icon in Chrome's toolbar
• Find "ImmersityLens" in the list
• Click the pin icon next to it
• The extension icon will now appear in your toolbar

Development Setup

For developers who want to modify or contribute to ImmersityLens.

• Clone or download the repository
• The extension uses Manifest V3
• Main files: content.js, popup.js, background.js, manifest.json
• Dependencies are included in the libs/ folder

File Structure

Understanding the extension architecture:

• content.js - Main extension logic and image detection
• popup.js/html - Extension popup interface with animation selection
• background.js - Background script for context menu handling
• libs/ - LIF processing libraries and 3D viewer components
• shaders/ - WebGL shaders for 3D rendering and effects
• icons/ - Extension icons in different sizes

Testing Guidelines

Key sites and scenarios to test when developing:

• CNN.com - Tests picture element compatibility
• Instagram-style layouts - Tests padding-based aspect ratios
• Google Images - Tests various responsive patterns
• CORS handling - Test on both protected and open domains

Finding Convertible Images

ImmersityLens adds context menu options to all images on web pages.

• Visit any website with images
• Right-click on any image to see conversion options
• Images larger than 100x100 pixels are recommended for best results
• The extension works universally on most websites with images

Converting Images

Transform 2D images into immersive 3D experiences using AI.

• Right-click on any image and select "Generate LIF"
• The AI conversion process will start automatically
• Processing includes: Outpainting → Depth Estimation → LDI Generation
• Wait for the conversion to complete (usually 30-60 seconds)
• Monitor progress through the extension popup

Viewing 3D Results

Experience interactive 3D images with mouse controls and animation selection.

• Once converted, hover your mouse over the image
• Move your mouse to see the 3D parallax effect
• The image will respond with realistic depth and movement
• Use the extension popup to select different animation styles (Zoom In, Ken Burns, etc.)
• Changes take effect immediately for the active image

Downloading & Exporting

Save your 3D images in multiple formats for sharing and viewing.

• Right-click on converted images for download options
• Download LIF: Save the original Leia Image Format file
• Download MP4: Export as video with your selected animation
• LIF files work with compatible 3D viewers and displays
• MP4 files can be shared anywhere as standard videos
• Both formats preserve the 3D effect for different use cases

VR & WebXR Experience

Experience your 3D images in virtual reality for ultimate immersion.

• Use a VR-compatible browser (Chrome, Firefox, or Edge)
• Right-click on converted images and select "Open in VR"
• Put on your VR headset for a fully immersive 3D experience
• Compatible with Oculus, HTC Vive, and other WebXR devices
• Move your head around to explore the 3D scene naturally
• VR mode provides the most impressive depth experience

Complete Workflow Example

Here's the full magical journey from start to finish: