LeiaPlayer
The Swiss army knife of the Leia ecosystem that lets you playback, edit, and export 3D Lightfield media.
Last updated
The Swiss army knife of the Leia ecosystem that lets you playback, edit, and export 3D Lightfield media.
Last updated
Copyright © 2023 Leia Inc. All Rights Reserved
LeiaPlayer is a simple yet powerful app that lets you view, organize, and edit your 3D Lightfield media.
When you launch LeiaPlayer, you’ll find yourself in the Media gallery. The app launches directly to Media so you can easily find the images or videos you've engaged with most recently.
Media shows you all the images and videos found in your Pictures, Movies, and Downloads folders as well as any file you navigate to and open in LeiaPlayer's File Browser. You can easily remove any file from your Media tab by selecting it inside the Media tab and choosing "Remove Selection From Media". You can also easily add any file on your device to the Media tab by finding it in LeiaPlayer's File Browser and selecting "Add Selection to Media".
If you're opening LeiaPlayer for the first time, you’ll notice some preloaded media to give you inspiration on what 3D Lightfield content can look like. Note: Media will automatically add photos and videos found in the top level of your Pictures, Movies, and Downloads folders, but will not automatically add files in nested folders found inside those listed folders.
Tap the Menu Button (a.k.a. Hamburger Menu) in the top left to access the Navigation Menu Drawer. From here, you can jump between different file galleries in LeiaPlayer.
Moving down the drawer menu below Media, you'll see Camera Roll, File Browser, Lume Link, and Settings.
This is the default browsing experience in LeiaPlayer. The Media tab aggregates media on your device in one easy to use place. By default, all the image and video files in your Pictures, Movies, and Downloads folders will appear here. However, other files that you've opened in the LeiaPlayer File Browser will appear in Media automatically too, as well as media you've added using "Add Selection to Media".
The Camera Roll is a folder of all the pictures and videos you've taken using camera apps on the device, including those taken with LeiaCam.
This section shows you the entire file system of your device. The LeiaPlayer File Browser follows the standard file browsing paradigm from Android. The File Browser shows the folders on your device, and these folders contain subfolders within them. When you tap the “Pictures” folder you will see the “Screenshots” subfolder contained within it, alongside any media that's already in the Pictures folder.
We want to preserve this folder structure so that when you move files on or off of Lume Pad from a computer or another app, you can easily understand where they're located.
Lume Link is a feature of the LeiaLink app that allows you to send images from your mobile device to your Lume Pad and have it waiting for you in LeiaPlayer already converted into Lightfield 3D.
To use Lume Link, you must log in using your LeiaLogin account, and link to the LeiaLink app installed on your mobile device.
The Settings tab in LeiaPlayer gives you the ability to turn features on and off and customize your LeiaPlayer experience.
General: This section provides several options for how you'd like to view media in LeiaPlayer. It also gives you options on how you'd like LeiaPlayer to handle certain features that may make modifications to your files.
Video Playback: Options for default video playback behavior.
About: Licenses and legal info.
LeiaPlayer Beta: Sign up for future Beta versions of LeiaPlayer.
There are a variety of ways to add media to your Lume Pad, including downloading files from the internet, or getting a 3D Lightfield photo or video from another Lume Pad user. To add media from a computer to Lume Pad to experience in LeiaPlayer, you can use Android File Transfer on MacOS or simply plug your Lume Pad into a PC to move files from your computer onto Lume Pad. Then, you can find them in LeiaPlayer and view them.
All 2D or 3D content can be viewed in 3D in LeiaPlayer! For 3D content it's self-explanatory, but for 2D images and videos it's a little different. Still, it's as easy as tapping the Leia Lightfield button.
2D Images: Open a 2D image so it's full screen in LeiaPlayer. Tap the Leia logo in the bottom left hand corner on the View Switcher, and a new LIF format version of your image that's in 3D. You will have two files now: the original 2D image and the new 3D LIF image.
2D Videos: Open a 2D video so it's full screen in LeiaPlayer. Tap the Leia logo in the bottom left hand corner on the View Switcher, and after a few seconds of buffering, you will see your video playing back in 3D! Just follow these steps again whenever you want to view your 2D video file in 3D.
The Ellipsis Button is the three vertical dots you usually see in the top right corner of the app. The Ellipsis Menu changes depending on the context of where you are in the app.
The Ellipsis Button opens up View Options if you're in a standard Gallery View. These View Options may be available in other modes too, like in Bulk Selection Mode. These are the options available within the View Options menu:
Lightfield/2D Sorting: Show only Lightfield media files, only 2D media files, or Both.
Media Type Sorting: Show only Images, only Video, or Both.
Sort By Options: Sort by Date Created, Date Modified, Filename, File Size, or Resolution
The Ellipsis Button opens up More Options if you're in the File Browser View. These are the options available within More Options when in the standard File Browser View:
New Folder: Creates a new Folder within the Folder that you're currently in.
Select: This option will switch you into Bulk Selection Mode so you can easily select mutliple files to move or delete.
The Ellipsis Button opens into More Options in Bulk Selection Mode. Here are the options available within More Options when in Bulk Selection Mode:
Add Selection to Media: Adds the selected file to the Media tab.
Rename: You can use this option to change a file's filename (Only when 1 file is selected)
Move: This feature will move the file(s) from one folder to another (more info below)
Select None: Deselects all selected items and exits Bulk Selection Mode
Invert Selection: Deselects all currently selected items and selects all currently unselected items within the folder that you're in.
Select All: This option will select every item in the folder that you're in
Moving files from one location to another is easy. Just follow these instructions:
Long press an image thumbnail to enter Bulk Selection Mode.
Select the files that you would like to move.
Tap the Ellipsis Button (3 vertical dots) in top right corner.
Tap the Move Button in the More Options Menu.
In the Move Menu, navigate to the destination folder you want to move the file(s) to.
Tap the Move Here Button in bottom right corner to confirm the move.
The files will now be located in the destination folder you selected.
The files you selected are not being copyed, they are being moved. They will no longer be found in their original location.
The files you just moved may be hard to find if you moved them to a folder with a lot of items in them. To find the files you just moved, you may have to scroll down to the bottom of the destination folder, as the folder you moved the files to may be sorted based on the files names or the original date the files were created. The files you just moved may also not be grouped together in the destination folder.
Viewing 3D images
If you have 3D files from other sources like SBS or Quad Lightfield images or video, LeiaPlayer will try to detect them automatically. However, sometimes, LeiaPlayer may not automatically detect them as 3D. To manually communicate to LeiaPlayer that the files are 3D, you will need to use the 3D Tagging feature.
Here's how to do this in LeiaPlayer:
Open up the 3D image that's being displayed in 2D
Tap Ellipsis Button (3 vertical dots) icon in top right corner
Tap Add 3D Tag
Follow the instructions and answer questions about the file
The file will now be viewable correctly in 3D
You can do this process to fix a file that's incorrectly identified as 3D or in the wrong format of 3D too by doing the same steps except tapping the "Edit/Remove 3D Tag" button that appears in place of the "Add 3D Tag" button.
When you open an image or video in LeiaPlayer, it will open in Theater Mode. This is the best place to view 3D Lightfield media.
When viewing media, you will notice an option in the bottom left corner to change the view mode.
Lightfield: This icon looks like the Leia logo. View the compatible image or video as a 3D Lightfield with 4 unique views. Lightfield View Mode has the following benefits: a wide viewing angle, comfortable for multiple viewers, objects feel more real and have a "look-around" (parralax) effect.
ST: This icon is named for Stereoscopic 3D View Mode. The icon is only shown when viewing compatible files. View the compatible image or video in traditional stereo 3D with 2 unique views. Stereo 3D has some benefits, including: support for more depth for a single viewer, and no synthesized views. The downsides for Stereo 3D View Mode include a smaller viewing angle, much less comfortable for multiple viewers, no look-around / parallax effect, and increased chance of cross-talk/ghosting. This is the preffered viewing method for content captured on legacy 3D systems.
2D: View the image or video in standard 2D with a single view. 2D is highest resolution with maximum brightness, but of course has no depth or look-around effect/parralax.
Some Apple devices allow you to capture depth maps when shooting images in Portrait Mode and with some other apps. The quality of the depth map depends on the device, the sensors available, and the environment and distance from the subject when the image was taken.
Shoot Portrait Mode Images on your iOS device where the Portrait Mode Indicator (e.g. Natural Light icon) is yellow
Move images with Apple Depth Maps and move them to your Lume Pad (using LeiaLink, email, or other method)
Open it in LeiaPlayer
Tap the Leia Lightfield View Button to convert Apple Depth Map images to a 3D Lightfield LIF
Currently supported iPhone Models
iPhone 13 Series
iPhone 12 Series
iPhone SE (2020 and 2022)
iPhone 11 Series
iPhone XS Max
iPhone XR
iPhone 8 Plus
iPhone 7 Plus
In order to share Leia Image Format (LIF) files to another Lume Pad device and retain the 4V depth metadata, you must be cognizant of the transfer method you use. Many messaging apps and social networks will strip the 3D Lightfield metadata and send only a 2D image to the other user.
If you'd like to send the LIF file directly to another device here are some methods that work:
Supported Messaging Platforms
Discord
ZIP: If you compress or ZIP images before sending them, metadata will be retained in transit
If you want to share your Lightfield images to 2D devices, tap the share button in the gallery screen.
This will allow you to export images as Lightfield Animation in MP4 and GIF format, which are Lightfield-synthesized animations that show the depth of your images by interpolating smoothly between the image's views.
This is the best way to share your Lightfield images on traditional social media platforms.
Loop Video
To loop your video continuously, tap the ellipsis button in the top right corner
Then tap “Loop Video On”
Depth Slider
You will see the Depth Slider on the right-hand side of the screen whenever viewing video content in Lightfield view mode
Move the Depth Slider up and down to increase or decrease the disparity value, which will increase or decrease the sensation of depth
What are the benefits of editing Lightfield Images in LeiaPlayer?
Improve the visual quality of your images
Increase the depth effect of your images
Add artistic flair to your images
To edit images in LeiaPlayer, open an image and tap the pencil and pad icon in the bottom center of the screen. Only some 3D Lightfield images can be edited, including LIF and 3D SBS images.
The LeiaPlayer editor relies on the depth map to estimate the depth at each pixel in the photo, which can be used to identify portions of the image that are far away and belong to the background. Quad Lightfield images don't contain the Lightfield metadata needed to edit them.
Images are saved in the Leia Image Format, and will retain the same number of views as it originally contained.
To learn more about specific tools available when editing Lightfield images, go to the Editing Images page.
