For the complete documentation index, see llms.txt. This page is also available as Markdown.

🍣musubi app

Use the musubi app to turn photos and short videos into 3D memories, organize them into albums, and transfer them to a connected 7-inch musubi frame.

The musubi app is currently in closed beta. Want to get access? Sign up here!

The musubi app is for creating 3D memories for a Looking Glass musubi. You can import photos and videos, let the app process them into musubi-ready media, organize the results into albums, and transfer them to a connected musubi device over USB.

This guide walks through the basic workflow:

  • Import source photos and videos

  • Let the musubi app convert them locally into holographic media

  • Edit the resulting memories

  • Organize memories into albums

  • Transfer albums or individual memories to a connected musubi display

  • Review and manage media already on the connected display

The main UI for the musubi app

What you'll need

  • The musubi desktop app

  • Photos or videos to import

  • A 7-inch musubi frame

  • The included USB-C cable for data transfer

Supported source media:

Media type
Supported formats

Images

JPG/JPEG, PNG, WEBP, HEIC, HEIF

Videos

MP4, WEBM, MOV

The musubi frame uses USB-C for power and data. It does not have HDMI input and can't be used as a secondary monitor.

Using the musubi app

The musubi app is built to import, convert, and edit your media so you can transfer it to a connected musubi device. To do so:

  1. Launch the musubi app

  2. Select the "Import" button

  3. Select one or more photos or videos and import them

The app will use local AI models to convert your media into a hologram. This may take a moment, depending on your computer's processing power.

If you import a video longer than 30 seconds, the app asks you to trim it before import. Choose the part you want to keep, then continue.

Keep the app open while files are processing. Completed items appear in All Media and can be opened, edited, added to albums, or transferred.

Once the media has been processed, there will be options to edit the content. There are two different processes to do this - one for photos and one for videos.

Editing photos

Editing photos will adjust how the content appears in your musubi display once transferred.

The edit window includes two preview modes:

  • Simulated HLD shows the photo with a visual reference for how it will look in the musubi display

  • Canvas shows the processed media on a blank canvas

You can edit the content to adjust its appearance. The edit controls include:

  • Background: choose On, Off, or Partial to show the photo background to varying degrees

  • Duration: how long the photo will appear in the musubi playlist

  • Scale: change the size of the photo

  • X Position and Y Position: adjust the position of the photo

  • Rotate 90 degrees: rotate the content

Once you're adjusted the photo, select Save to save the changes.

Editing videos

Videos work very differently from photos. We add spatial data to the video and then allow you to select a moment during the video to become a Magic Moment. This Magic Moment becomes a freeze-frame of the video with a holographic effect that can be edited like a photo.

The edit screen for videos has:

  • Simulated HLD shows the video with a visual reference for how it will look in the musubi display

  • Canvas shows the processed media on a blank canvas

There are also edit controls. These control both the video itself and the Magic Moment, depending on the option:

  • Magic Moment Background: choose On, Off, or Partial to show the background to varying degrees during the Magic Moment

  • Magic Moment Duration: determines how long the Magic Moment will display for

  • Scale: change the size of the video

  • X Position and Y Position: adjust the position of the video

  • Rotate 90 degrees: rotate the video

You can also manage the video playback timeline and, at a moment you feel is ideal, set the Magic Moment. This can be removed and regenerated if you want to change it.

Organize albums

Use albums to group media before transfer.

  1. In My Albums, choose Create Album

  2. Give the album a name and, optionally, a description

  3. Open the album

  4. Use Add Photos to choose media from All Media or import new media directly into the album flow

Removing an item from an album does not delete it from your local library. Deleting an item permanently removes it from storage and from any albums that include it, so use delete only when you no longer need the memory.

Transfer to a connected musubi

Connect the musubi frame to your computer with a USB-C cable and make sure it is powered on.

If the musubi app does not detect a device, it shows a no-device message and asks you to connect and power on the frame. Once the frame is detected, the app shows it as a connected a musubi display.

To transfer from the main page view:

  1. Choose the transfer control

  2. Select Transfer Album or Transfer Photos

  3. Pick one album or select individual media items

  4. Choose Transfer

  5. Wait for the transfer progress to finish

  6. When completed, disconnect your musubi device and your new content will play

To transfer from inside an album, choose the transfer control from that album. In All Media, selected items transfer if selection mode is active; otherwise the current media set transfers.

Manage media on your musubi display

When a musubi frame is connected, a musubi shows a Musubi Display card in the Albums view. Open it to review the media currently on the connected frame.

In the Musubi Display view, you can:

  • See the media stored on the connected display

  • Delete items from the display without changing your local albums

  • Open editable items when musubi can match the display item to local metadata

  • Re-encode editable items so the display copy matches your latest local edit

Some items may be device-only. Device-only items can be viewed or deleted from the connected display, but they may not be editable from local settings because the app cannot match them to the editable local project data on your computer. This is common for the demo content.

Troubleshooting

The app does not detect the frame

Confirm that the 7-inch musubi frame is powered on and connected with the included USB-C cable. If it still does not appear, unplug the frame, reconnect it, and wait for your operating system to mount the device before trying the transfer again.

The frame does not act like a monitor

That is expected. The musubi frame has USB-C power/data only and no HDMI. It is not used as a secondary display. Transfer media from the app, then review it on the frame.

Transfer is disabled

Make sure at least one completed item or album is available to transfer. If media is still processing, wait for it to finish. If no device is connected, the app waits for the USB connection before enabling transfer.

A display item is stale

If a display item was edited locally after it was transferred, re-encode it from the Musubi Display view in the app. Re-encoding creates a fresh display copy using the current local edit settings and copies it to the connected frame.

An item is not editable from Musubi Display

The display may contain media that does not match the local editable metadata on your computer. You can still view or delete device-only items from the connected display, but to edit them, re-import the original source media into the app.

Support

If you have any feature requests or issues and need support, please contact us at support@lookingglassfactory.com or join our Discord.

Last updated