Software Installation

This guide is for installing the latest pi-Stomp software based on 64-bit Raspberry pi OS Lite and MOD software.

Unlike previous “releases” which you built yourself, we now offer pre-built images!

Send any feedback to support@treefallsound.com

If you have a previous pi-Stomp install and would like to transfer your user data (pedalboards, hardware configuration, etc.) to your new install, you should first create a backup

• A completed pi-Stomp unit. v2 or v3 (pi-Stomp v1 not yet supported by the latest software)
• A micro SD card. 16GB or larger. Class 10 recommended. A good option
• A computer with wifi and SD card slot (or USB/SD card adapter)
• The pi-Stomp Software image (just the .xz zipped file under “Assets”) Download
• Raspberry Pi Imager installed on your computer (v1.9.6 as linked here, NOT v2.x)
  • Windows
  • Mac
  • Linux Intel
  • Linux Arm

Run the Raspberry Pi Imager

If it asks you to upgrade at any time, choose “No” (v1.8.x or v1.9.x is required for this process)

Click CHOOSE DEVICE

Select your Raspberry Pi device (Raspberry Pi 5 for most pi-stomp v3 users)

Click CHOOSE OS

Select Use custom then find the image file that you downloaded earlier.

Click CHOOSE STORAGE

Select your SD card

Click NEXT

Click EDIT SETTINGS

If you do not see an option to “Edit Settings”, it's likely you're using Imager 2.0 or later. That won't work. Please download v1.9.6 with the link at the top of this page and don't let it upgrade to a newer version.

GENERAL tab

• Enable “Set hostname”
  • hostname must be pistomp
• Enable “Set username and password”
  • Username must be pistomp
  • Remember the password you provide, you'll need it later!
• Enable “Configure wireless LAN”
  • “SSID” is the name of your router WiFi (case matters)
  • “Password” is the password used for accessing your router WiFi
• Enable “Set locale settings”
  • Set the Time Zone appropriate for your location

SERVICES tab

• Enable “Enable SSH”
• Select “Use password authentication”

Click Save

Click Write

If the write is successful, physically eject your SD card, then insert into the raspberry pi SD slot and power up!

NOTE: the first boot reconfigures the kernel and thus can take 5 minutes or more. Be patient. The LCD screen should illuminate during this process. If everything goes well, after a few minutes, you'll see the “pi-Stomp!” screen and eventually the Home screen. If so, Congrats!

If this doesn't happen after 6 minutes or more, there may be a problem. Feel free to email support@treefallsound.com

Remember, you should never insert or pull the SD card from the Raspberry Pi while it is powered up. Bad things will likely happen. Bob learned the hard way. Don't be like Bob.

Your pi-Stomp is fully usable without computer connection, but for pedalboard construction and advanced editing, a connection is required.

Connecting over Wi-Fi can be either via a nearby router (“Wi-Fi” mode) or directly (“Hotspot” mode). If you specified your Wi-Fi router SSID and password correctly when burning the SD card, then it should connect upon boot up.

The color of the Wi-Fi toolbar icon at the top of the LCD, shows the current mode and status of Wi-Fi

Wi-Fi Mode, Not connected

Wi-Fi Mode, Connected

Hotspot Mode

Once pi-Stomp is connected to your router or directly to your computer via hotspot mode, just point a browser on your computer to pistomp.local/

Should you need to configure Wi-Fi or switch modes click on the Wi-Fi toolbar icon to get to the Wi-Fi Menu

For further instruction on pi-Stomp usage, check out the User Guide