SPC - STUdio Pack Checker

Verify, repair and compress your story packs for Lunii¹ story teller device.

DISCLAIMER

This software relies on reverse engineering research, which is limited to gathering the information necessary to ensure interoperability with the Lunii¹ story teller device, and does not distribute any protected content.

USE AT YOUR OWN RISK. Be advised that despite the best efforts to keep this software safe, it comes with NO WARRANTY and may brick your device.

USAGE

Prerequisite

• Java JRE 11+
• FFmpeg

Installation

• Download the latest release ( or build the application).
• Unzip the distribution archive
• Run the launcher script: either studio-pack-checker.sh or studio-pack-checker.bat according to your platform. You may need to make them executable first.

Configuration

Studio is portable by default: everything (except JRE and FFmpeg) is relative to current directory.

Using the application

The application will check all the story packs in a folder (or just the specificied story pack)

Check

The application will verify that :

• The story.json is present and well-formed
• Image dimensions are 320x240
• Audio files are readable for STUdio

Repair

The application will repair only if needed :

• Convert audio files if not in MP3/OGG/WAVE formats. FFmpeg will be used.

Compresss

The application will compress only if needed :

• Compress image files to 4-bits depth / RLE encoding BMP
• Compress audio files to MP3 (mono, 44100Hz, 32kbits/s)

FOR DEVELOPERS

Prerequisite

• Maven 4+
• Java JDK 11+

Local build

• Clone this repository
• Run the application: mvn exec:java -Dexec.mainClass="org.studio.checker.Main"
• Package the application: mvn package This will produce the distribution archive in target/studio-pack-checker-bin.zip.

THIRD-PARTY APPLICATIONS

If you liked STUdio, you will also like:

• STUdio create and transfer your own story packs to and from the Lunii¹ story teller device.
• Studio-Pack-Generator convert a folder or a RSS URL to Studio pack zip for Lunii device, see file structure below.
• InullKit is a launcher for STUdio.
• Générateur de Noms de Pack Lunii is a Lunii pack name generator.

LICENSE

This project is licensed under the terms of the Mozilla Public License 2.0. The terms of the license are in the LICENSE.md file.

The jvorbislibrary, as well as the VorbisEncoder class are licensed by the Xiph.org Foundation. The terms of the license can be found in the LICENSE-jvorbis.md file.

The com.jhlabs.imagepackage is licensed by Jerry Huxtable under the terms of the Apache License 2.0. The terms of the license can be found in the LICENSE-jhlabs.md file.

Footnotes

1. Lunii and Luniistore are registered trademarks of Lunii SAS. This work is in no way affiliated with Lunii SAS. ↩ ↩² ↩³