whatisgithub

What is guitarpedal?

torvalds/guitarpedal — explained in plain English

Analysis updated 2026-05-18

1,944CAudience · developerComplexity · 5/5Setup · hard

In one sentence

Linus Torvalds's hardware and firmware project for a DIY digital guitar effects pedal with a screen, rotary knobs, and multiple effects.

Mindmap

mindmap
  root((GuitarPedal))
    What it does
      Digital guitar pedal
      Multiple audio effects
      USB audio interface
    Tech stack
      C
      RP2354 microcontroller
      KiCad
    Use cases
      Build your own pedal
      Study embedded audio DSP
      Modify pedal firmware
    Audience
      Hardware hobbyists
      Embedded developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Build a physical digital guitar effects pedal from the provided circuit board designs and firmware.

USE CASE 2

Study a real-world example of digital signal processing effects like compressors, echo, and pitch shifting.

USE CASE 3

Modify or add new guitar effects to the existing firmware.

USE CASE 4

Use the pedal as a USB audio interface to send guitar audio to a computer.

What is it built with?

CKiCadRP2354TAC5112pico-sdk

How does it compare?

torvalds/guitarpedaltorvalds/uemacsvercel-labs/zero
Stars1,9442,0321,465
LanguageCCC
Setup difficultyhardmoderatemoderate
Complexity5/52/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires an ARM cross-compiler, custom PCB hardware, and KiCad to build and use the pedal.

So what is it?

GuitarPedal is a personal hardware and firmware project by Linus Torvalds, the creator of Linux, that produces a working digital guitar effects pedal. The repository contains the circuit board design files, the firmware source code that runs on the pedal, and some documentation. The hardware is built around two chips: an RP2354 microcontroller (the brain of the pedal) and a TI TAC5112 audio codec (which converts the guitar's analog signal to digital and back). The board design is modular, meaning the microcontroller and codec each live on their own small circuit board that plug together, plus separate boards for the audio jacks and the main controls. The enclosure has a small OLED screen, two rotary knobs that also click as buttons, and two foot stomp switches. The design files are in KiCad format. The firmware implements several audio effects that the player can switch between using the knobs and screen. Available effects include a noise gate to cut background hum, a compressor, a boost with an unusual folding-style distortion, a phaser, a flanger, an echo based on a classic tape delay unit, a pitch shifter, and a 10-band equalizer. There is also a USB audio interface mode that lets the pedal send audio to a computer. Each effect has adjustable parameters controlled through the pedal's screen and rotary encoder. Building the firmware requires a Linux, Mac, or Windows machine with standard C build tools and an ARM cross-compiler. The repository includes git submodules for the required libraries, so they are fetched automatically. The compiled firmware is a UF2 file that gets copied onto the pedal over USB when it is in programming mode. The author describes the project as a learning exercise in hardware design and digital signal processing, and notes some rough edges remain in the UI and USB audio reliability.

Copy-paste prompts

Prompt 1
Walk me through setting up the build environment and compiling the firmware for this guitar pedal project.
Prompt 2
Explain how the boost effect with folding distortion works in this pedal's firmware.
Prompt 3
Help me understand the modular circuit board design in the Hardware directory.
Prompt 4
How does the pitch shifter effect in this project work without using FFT?

Frequently asked questions

What is guitarpedal?

Linus Torvalds's hardware and firmware project for a DIY digital guitar effects pedal with a screen, rotary knobs, and multiple effects.

What language is guitarpedal written in?

Mainly C. The stack also includes C, KiCad, RP2354.

How hard is guitarpedal to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is guitarpedal for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.