Getting started
This page is a short way in. The complete reference for the Lofi language, the console's API and every Studio tool lives in the manuals linked at the bottom, and inside Studio itself under Help.
To learn more about the Micro-8, follow its development or buy one, go to the website of its designer, Franck Sauer: www.micro-8.com.
Install
Download the latest release from GitHub. There are two files: a 64-bit Windows installer that needs no admin rights, and a portable ZIP you can unzip and run from anywhere, a disk or a USB key included. Both contain the full program: no Python or other dependency to install first.
The folder keeps its own settings next to the executable, nothing is written to the registry, so a portable copy moves cleanly to another PC.
Your first program
Launch Micro8Studio.exe. The Files panel on the left shows Examples/OS, the default SD
card of the test runner. Open any .SRC file, for instance one of the demos under
Examples/OS/BSMCODE/SRC, and press F5 to run it: the Micro-8 screen appears, following
what the real console's OS 0.9 would show.
To write your own, start from the main snippet (type main and Tab), or copy an
existing example as a starting point. Lofi, created by Franck Sauer, is a small C-like language: types, functions, arrays, and the console's
own API for video, sound, sprites and input. The tutorial goes from a first line of code to a complete game.
Editor and debugger
The editor completes your functions, variables and the whole API as you type, with the matching manual signature shown for the parameter you are on. Ctrl+F finds text in the current file, Ctrl+Shift+F across the project.
Click in the left margin to set a breakpoint, then F5: execution stops there, with the call stack, local variables and any watch expression visible. Step into, over, or run to the end from the same toolbar.
Tracker
Open the Tracker tool to write music with the console's own FM instruments, 8 tracks per pattern, with song mode to chain patterns in order. Studio-only effects, arpeggio, retrigger, cut, probability, vibrato, tremolo and glide, help audition an idea at the keyboard; they are a preview convenience and are not needed for the pattern to play correctly on the real hardware. The export button writes a song as WAV, WAV stems (one file a track), MIDI, note events (JSON or CSV) or a VGM of its FM tracks.
The full manual
Two reference documents come with Studio; the second is also on GitHub:
- The Micro-8 User Manual, by Franck Sauer (press F1 in Studio, or see www.micro-8.com): the Lofi language, the full API, and the console's hardware, registers included.
- Micro-8 Studio manual (French version): a getting-started chapter, a complete tutorial that builds a small dungeon game with every editor, then the reference for the editor, the debugger, the test runner and the asset tools, illustrated.
Inside Studio, Help > Open Micro-8 Studio Manual opens the same document in its own viewer, in whichever language the interface is set to.