GuitarTools setup guide
Connect a guitar and set safe audio levels
A browser pedalboard needs an audio input to process a live guitar. Usually that means connecting the instrument to an audio interface, then connecting the interface to your computer. This guide covers the browser permissions and controls; it cannot replace the setup instructions for your specific interface.
Before opening the browser tool
- Connect your guitar to an instrument input on a compatible audio interface.
- Connect the interface to your computer and install its required driver or system software if the manufacturer specifies one.
- Connect headphones or speakers to the intended output and begin with a low listening level.
- Use the site over HTTPS. Browsers generally require a secure context for microphone and audio-device access.
The browser’s input is the interface, not the guitar cable by itself. Avoid connecting an instrument-level signal directly to a computer microphone jack unless the computer and the required adapter are designed for that use.
Select the input and connect
- Open the Multi-Effector and open Settings from its header.
- Choose Detect/Refresh Devices. When asked, allow microphone access so the browser can enumerate audio devices.
- Select the interface under Input Device. Select the desired Output Device if the browser lists one.
- Click Connect Input. If prompted, allow microphone access for the site.
- Play a note and check the Input Volume meter. Raise the interface’s hardware input gain only enough to get a usable signal without an overloaded sound.
Device names can be hidden until permission is granted. If the list stays empty, check the operating system’s microphone privacy settings, reconnect the interface, and use Detect/Refresh Devices again. Changing selected devices while connected may cause the app to reconnect the audio stream.
Set levels conservatively
Start with your interface gain and the app’s Input Gain low, then play the loudest part you expect to perform. Increase input gain gradually while watching the input meter. If the sound distorts or the meter appears overloaded, reduce the interface gain or app input gain. Distortion can come from a stage before the browser, so lowering the app’s output alone may not correct it.
Next, raise the app’s Master Volume and your headphone or speaker level gradually. The app connects at a safe output setting, but still verify your own listening level before playing. A sudden loud sound can be uncomfortable or harmful; disconnect or mute if you hear feedback, unexpected peaks, or a harsh squeal. Avoid monitoring through speakers positioned in front of the instrument pickup, as that can create an acoustic feedback loop.
Keep one level change at a time. If a new pedal makes the output much louder, lower the output before continuing to compare. The meters help you observe signal activity; they are not a substitute for careful listening or for clipping indicators on your hardware.
If there is no sound
- Confirm that the guitar is plugged into the interface’s instrument input and that the interface is selected as Input Device.
- Check browser and operating-system microphone permissions, then disconnect and connect again.
- Verify that the guitar volume, interface input gain, app Input Gain, Master Volume, and hardware output are not turned down or muted.
- Try the built-in simulator. If simulator audio plays but live input does not, focus troubleshooting on permissions, input selection, and the interface signal path.
- If the selected output cannot be changed in your browser, use the system’s default output device.
Disconnect before changing cables or troubleshooting hardware. The app’s status message may indicate permission or reconnection problems; use it along with your interface’s own signal indicators.
New to effect order?
Once the input is working, start with a simple chain and add one effect at a time. Comparing a dry signal with the processed version makes it easier to hear what each stage contributes.
Read the practical pedal-order guide →