Kraftor SAM User Manual
Browser control surface for the Kraftor SAM firmware.
Requirements
- A browser with Web Serial and Web MIDI support, usually Chrome or Edge.
- The Kraftor SAM firmware running on the board.
- USB connected to the computer.
Serial Speech
- Open
GUI/index.html. - Click
Select port. - Choose the Kraftor USB serial device.
- Type text in the text box.
- Click
Speak.
After a serial port is selected, the GUI shows Kraftor as the active connection. The browser's serial chooser remains responsible for selecting the actual USB port.
The GUI sends the text line over USB Serial at 115200. The firmware speaks the line when it receives Enter.
MIDI Voice Control
- Click
Connect MIDI. - Allow browser MIDI access if prompted.
- Select the desired MIDI output.
- Move the knobs.
| GUI Control | MIDI Message | Firmware Effect |
|---|---|---|
| Speed | CC 1 | Higher knob value means faster speech. |
| Pitch | Pitch Bend | Higher knob value means higher perceived pitch. |
| Mouth | CC 2 | SAM mouth parameter. |
| Throat | CC 3 | SAM throat parameter. |
RAM And FRAM Sentences
When the serial port connects, the GUI asks the firmware for its sentence-bank layout. The reply tells the GUI how many RAM slots exist, whether FRAM is present, the first MIDI note for each bank, and the maximum sentence length.
- RAM is always available. RAM sentences are temporary and are lost when the board is reset or powered off.
- FRAM appears only when the board detects the external FRAM memory. FRAM sentences are stored persistently and remain after power-off.
If FRAM is not detected, the FRAM tab stays disabled. If FRAM is detected, the GUI enables the FRAM tab and loads the stored sentences from the board.
Use Reload from board to read the current bank, Save all changed to write edited slots, and Play on a slot to speak it immediately. Fill RAM slots and Fill FRAM slots copy one non-empty pasted line into each slot.
RAM slots are MIDI-triggered from the RAM note range shown in the tab header. FRAM MIDI notes start after the RAM note range, so the two banks do not overlap. If there are more FRAM slots than available MIDI notes, the remaining FRAM slots can still be edited and played from the GUI.
Presets
The preset dropdown applies common SAM voice settings and sends MIDI when MIDI is connected.
- SAM
- Elf
- Little Robot
- Stuffy Guy
- Little Old Lady
- Extra-Terrestrial
Random creates a new voice. Reset to default returns to the SAM default.
Skins
The skin menu changes the look of the GUI. The selected skin is remembered by the browser.
- Amiga
- HAL 9000
- WOPR
- Moon 1999
- Alien