Welcome to our guide on using the STUdio software, a powerful tool to create and transfer story packs to your Lunii* story teller device. Let’s unravel the magic of storytelling together!

Prerequisites

• Java JDK 11+ must be installed on your device.
• For Windows users, ensure that the libusb driver is installed. The easiest way is to have the official Luniistore* software installed (it doesn’t need to be running).

Installation Steps

1. Download the latest release or build the application yourself.
2. Unzip the downloaded distribution archive.
3. Run the launcher script: Select the appropriate script based on your operating system (studio-linux.sh, studio-macos.sh, or studio-windows.bat). You might need to make them executable first.
4. If the application doesn’t open automatically, open a browser and type the URL: http://localhost:8080 to access the web interface.
5. Avoid running the script as a superuser/administrator, as it might create permissions issues.

Navigating the Application

STUdio provides a user-friendly web interface featuring two main screens:

• Pack Library: Manage your local story packs and transfer them to and from the device.
• Pack Editor: Create or edit story packs.

Using the Pack Library

The pack library screen displays your local library of story packs located in your user-specific .studio folder. The interface supports three file formats:

• Raw: Official format for older devices (firmware v1.x).
• FS: Official format for newer devices (firmware v2.x).
• Archive: Unofficial format used by STUdio.

When a transfer is initiated, the conversion of the story packs occurs automatically. You can simply drag and drop packs to transfer them to or from the device.

Editing a Pack

Within the pack editor, you can edit current story packs. The editor features:

• Stage Nodes: These allow you to display images or play sounds.
• Action Nodes: Transition between stages or manage options.

Now, let’s dive into the types of media you can use for your stories.

Supported Media Formats

Images

Supported formats, which will automatically convert during transfer, include:

• PNG
• JPEG
• BMP (24-bits)

Note: Images must be 320×240 pixels in size for proper display on the Lunii device.

Audio

Audio files should be in one of these formats:

• MP3
• OGG Vorbis
• WAVE (signed 16-bits, mono, 32000 Hz)

MP3 and OGG files are recommended to be sampled at 44100Hz.

Troubleshooting

While the application is designed to be user-friendly, you might encounter some issues. Here are a few troubleshooting steps:

• If the application doesn’t launch, ensure the necessary prerequisites (Java and libusb) are correctly installed.
• If story packs do not appear in the library, check if they are in the correct file format.
• For problems related to dragging and dropping files, ensure that you do not run the application as an administrator, as this may lead to permissions issues.

For more insights, updates, or to collaborate on AI development projects, stay connected with fxis.ai.

Final Thoughts

At fxis.ai, we believe that such advancements are crucial for the future of AI, as they enable more comprehensive and effective solutions. Our team is continually exploring new methodologies to push the envelope in artificial intelligence, ensuring that our clients benefit from the latest technological innovations.

Happy storytelling with STUdio!