Troubleshooting

Extended Functionality 🧰

Framerate Cap and Bitrate Cap

the framerate cap and bitrate cap options under the tools menu can help improve syncing performance and syncing time on lower end systems.

Enabling Auto Updates

Auto Updates can be enabled via the file -> preferences menu. As of update 1.0.1 automatic updates are disabled by default.

Known Bugs πŸ›

Forcing HoloPlay Studio to use the Dedicated Graphics Card

While HoloPlay Studio should automatically choose the dedicated graphics card on your system there are cases where it is unable to do so. To force HoloPlay Studio to use your dedicated graphics card, open windows settings -> graphics settings and choose HoloPlay Studio from the drop down menu. You can find the HoloPlay Studio.exe file at the following path. C:\Users\[username]\AppData\Local\HoloPlayStudio

Crashes on launch

There are a few known cases where HoloPlay Studio will be unable to launch. If this happens to you try adjusting the GPU via the above tip. If HoloPlay Studio still crashes after changing that please contact us at [email protected] and submit a bug report.

Glitches in synced content

If you encounter glitches in synced content please ensure that your system is using the dedicated graphics card or try adjusting the bitrate and frame rate options. If you're still encountering glitches after that please contact us at [email protected] and submit a bug report.

Crashes on startup in Japanese

This is now fixed as of HoloPlay Studio version 1.1.2. Please ensure you're running the latest version of HoloPlay Studio.
In prior versions of HoloPlay Studio there was an issue that led to a crash on startup on Windows 10 systems that use Japanese characters with Unicode in the file-path. We resolved this issue in HoloPlay Studio 1.1.2. You can download the latest version from our website.

Work arounds πŸ‘·β€β™€οΈ

Syncing without the portrait connected to USB

If you are unable to power the portrait via the usb-c cable plugged in to your computer you can still sync to your portrait but it will take a few steps. 1) Plug the portrait into your computer but don't power it on. 2) Open the LKG drive that shows up in finder or in file explorer. 3) Copy the LKG_Calibration folder to the root of a separate usb drive or disk. 4) unplug the portrait from your computer, and plug the USB-C cable into the provided power brick. 5) ensure the HDMI cable is still connected to the computer and boot the portrait into desktop mode. 6) Open HoloPlay Studio and import your content. 7) Once you've got your content in HoloPlay Studio you can press "sync playlist." This will take some time and will write the files to the location where you copied the LKG_Calibration folder to. 8) Once the files have finished syncing. Power down the Looking Glass Portrait and plug the usb-c cable back into your computer. Copy the synced files, playlist.json and playlist.m3u to your device. 9) When you reboot the device into stand alone mode you should see your holograms there!

Syncing without HDMI connected

You can not currently sync to the Looking Glass Portrait without the HDMI connected. Doing this will result in a small version of your hologram encoded in the bottom left corner.

Backing up your playlists

While HoloPlay Studio doesn't have support for multiple playlists currently, you can back up playlists by copying the folder in documents/HoloPlay Studio and renaming it. HoloPlay Studio will only read playlist items from the New_Playlist folder.

Multiple playlists on Looking Glass Portrait's stand alone mode

Official support for multiple playlists are currently on our roadmap. The following work around will explain how to switch between playlists without syncing. The playlists on Looking Glass Portrait are controlled by the playlist.json and Playlist.m3u files which are written when you sync your playlist in HoloPlay Studio. If you want to switch between playlists there are a few ways to do this currently. If you delete the playlist.json and playlist.m3u the Looking Glass Portrait will playback the files in alphabetical order. If you want to switch between specific playlists you can copy the playlist.json and playlist.m3u file from your Looking Glass and save them on your computer. If you sync new content in HoloPlay Studio it will then make a new playlist.json and playlist.m3u file, which you can then replace with the old one manually via finder on mac or in file explorer on windows.

Hacks πŸ‘¨β€πŸ’»

This section is reserved for those looking to make custom modifications to their playlist files, this approach can be prone to user error, typos etc. Please use with caution.

Manually Editing your playlist files

Part of the syncing process includes writing a playlist.m3u and aplaylist.json file to your Looking Glass. These files control which order your Looking Glass will load content in, and which content will be able to be played back in stand alone mode.
Removing the playlist.m3u file will cause all content on your Looking Glass to play in alphabetical order.
The video player on your Looking Glass only uses playlist.m3u to determine the order of playback. You do not need to edit the playlist.json file as this is solely used to determine if holograms have already been synced.

Playlist.m3u

The playlist.m3u file is what your Looking Glass Portrait reads as the official playlist. It is organized in the following manner:
1
hologram1.mp4
2
hologram4.mp4
3
hologram2.mp4
4
hologram5.mp4
Copied!
The playlist.m3u file is a single item per line file which refers directly to the synced/encoded holograms on your Looking Glass Portrait. To add a hologram that's already on your Looking Glass Portrait, but not present in the playlist file you must use the full file name and extension of the file. You should only point to .mp4 files encoded by HoloPlay Studio for proper playback support.

playlist.json

The playlist.json file allows HoloPlay Studio to read which files have been synced to your Looking Glass and determine if the files have changed or need to be synced again. It is organized as an array in the following format:
1
[
2
{
3
"filename": "hologram1.png",
4
"last_updated": "Wed Sep 15 12:06:40 2021",
5
"needs_sync": false
6
},
7
{
8
"filename": "hologram2.png",
9
"last_updated": "Wed Sep 15 12:06:40 2021",
10
"needs_sync": false
11
}
12
]
Copied!

We'd love to hear your suggestions ❀️

You can provide us with feedback or feature requests at our feedback forum or reach out to the team on discord!
If you're having issues with HoloPlay Studio that you weren't able to resolve on this page you can reach us at [email protected], check out our support articles here or fill out our bug reporting form.
Last modified 13d ago