Firmware Hero
0

terramod

It lets you build a modded firmware (.smf) from your own copy of the official firmware, and install it with the USB stick-based update procedure.

  • Custom firmware
  • Alpha
  • Medium brick risk
  • Reversible

Source code

This project hasn't been claimed by its maintainer yet, so its details come from the community. Is it yours? Claim it

Before you start

How hard is it?
HardUses the command line or developer tools.
What you need
  • Comfort with the command line
  • A computer
  • An SD card or USB stick
Can it break my device?
Small chance of trouble, with a way to recover.
Can I undo it?
Yes. You can go back to the official software.
Get itOpens github.com

Did it work for you?

Did terramod work on your Soma Terra?

No reports yet.

One-tap reports from owners. Bricked reports are checked before they count.

Compatibility

Devices: Soma Terra.

No compatibility information yet.

Getting started

From the project's README ("2. Build and install an existing mod"):

  1. Back up your Terra. Insert a USB stick, power on, hold S, press G (H blinks), then press H while holding S+G. This writes TERRA.smp with all 96 presets and pitch-shifter settings. Copy it off the stick. (It should be the same format as the factory TERRA0.smp, so terra-fw info can read it; untested.)
  2. Build: uv run terra-fw patch firmware/TERRAV1.7.smf dist mods/hold-midi/mod.toml --auto-name

    -> dist/TERRAV1.7holdmidi/TERRAV1.7holdmidi.smf

    Several mods can be combined: list more mod.toml files (overlapping hooks are rejected).
  3. Prepare the stick as the manual says (p. 23): FAT32, 1-32 GB (USB 2.0 sticks are the safest), and exactly one firmware file in the root. Copy the contents of the output folder onto it. File names must look like TERRAV.smf: the updater recognises that pattern (a different prefix is ignored).
  4. Update: insert the stick, power on, hold L+E (the hold LED must blink; if not, the name was not recognised), then press H while holding L. The triangle LEDs lighting in a circle = success. If the LEDs blink endlessly, power-cycle and retry or try another stick.
  5. Go back to stock any time by installing the official TERRAV1.7.smf the same way.

Read the full instructions

Risk and recovery

Brick risk
Medium
Reversible
Yes
Requires opening the device
No

From the project's README ("2. Build and install an existing mod"):

  1. Back up your Terra. Insert a USB stick, power on, hold S, press G (H blinks), then press H while holding S+G. This writes TERRA.smp with all 96 presets and pitch-shifter settings. Copy it off the stick. (It should be the same format as the factory TERRA0.smp, so terra-fw info can read it; untested.)
  2. Build: uv run terra-fw patch firmware/TERRAV1.7.smf dist mods/hold-midi/mod.toml --auto-name

    -> dist/TERRAV1.7holdmidi/TERRAV1.7holdmidi.smf

    Several mods can be combined: list more mod.toml files (overlapping hooks are rejected).
  3. Prepare the stick as the manual says (p. 23): FAT32, 1-32 GB (USB 2.0 sticks are the safest), and exactly one firmware file in the root. Copy the contents of the output folder onto it. File names must look like TERRAV.smf: the updater recognises that pattern (a different prefix is ignored).
  4. Update: insert the stick, power on, hold L+E (the hold LED must blink; if not, the name was not recognised), then press H while holding L. The triangle LEDs lighting in a circle = success. If the LEDs blink endlessly, power-cycle and retry or try another stick.
  5. Go back to stock any time by installing the official TERRAV1.7.smf the same way.

Read the full instructions

Credits, license and support

License
GPL-2.0