Using our emulator to add languages to the Mini BLE - mooltipass/minible GitHub Wiki

Thanks for Helping Us Create a Multi-Language Mooltipass !

The Mooltipass Mini BLE is the first Mooltipass device to include multiple languages, together with Unicode support.
For an easier translation process, you'll be able to test your translations on a device emulator on your computer.

Windows

Prerequisites

To start your work, you'll need to:

• Install Moolticute
• Install Python
• Download the zip file sent to you by email

Launching the Emulator

• Open a file explorer and navigate to C:\Users\your user name\AppData\Local\Programs\Moolticute
• Double click on minible_emu.exe

Changing the Device Strings

The device emulator uses the "miniblebundle.img" file located inside Moolticute's installation folder to fetch the strings displayed to the user. To change these strings, you'll therefore need to generate a new miniblebundle.img file:

• Unzip the folder sent to you by email
• Change the contents of "0_EN_US_english_strings.txt" inside the "strings" folder
• Double click on "bundle.py"
• Overwrite the miniblebundle.img file located inside Moolticute's install folder with the one that was just generated.
• Start the emulator

Before overwriting miniblebundle.img, do not forget to close both windows opened by the device emulator.

Ubuntu

Prerequisites

• Install Moolticute
• Install the Mooltipass Mini BLE Emulator
• Install Python3 by typing "sudo apt install python3" in a terminal

Launching the Emulator

• Open a terminal and type "minible"
• If not already launched, you may also type "moolticute" to lauch Moolticute

Changing the Device Strings

The device emulator uses the "miniblebundle.img" file located inside /share/misc to fetch the strings displayed to the user.
To change these strings, you'll therefore need to generate a new miniblebundle.img file:

• Unzip the folder sent to you by email
• Change the contents of "0_EN_US_english_strings.txt" inside the "strings" folder
• In a terminal, type "python3 bundle.py"
• Overwrite the miniblebundle.img file located in /share/misc with the one that was just generated
• Start the emulator

Before overwriting miniblebundle.img, do not forget to close both windows opened by the device emulator.

Notes

As you'll have noticed by now, the device contains around 125 strings. All of them (except maybe 10) can be displayed on the emulator screen following the indications shown in "0_EN_US_english_strings.txt".
To facilitate the review process, we would appreciate if you could save screen captures of your translations by using a simple software such as clipclip on Windows to automatically save window captures taken with the Alt-PrtScrn shortcut.
The Mooltipass team thanks you for your time and contribution!

Common Issues

If getting a "TypeError: 'iv' is an invalid keyword argument for this function" when running bundle.py, it likely means you have pycrypto installed. Simply type "pip uninstall pycrypto" followed by "pip install pycryptodome"