Technical Documentation
The exact technical details and workflows for advanced copy/paste routing, stageplot interactions, and setting up festival overrides.
Project Setup
Open the 'Project Setup' modal from the settings gear icon in the Sound toolbar.
The setup modal centralizes your FOH/MON console definitions, tech names, and project-wide sample rate.
Turn on 'Trunk Auto Assign' to let Gigbuddy automatically name and color-code your subsnake trunks based on stagebox routing.
These details populate the header of any generated PDFs and exports.
Adding Stageboxes
In the Project Setup modal, navigate to the Stageboxes tab to define your hardware.
Add a stagebox, select its model from your inventory, and give it a name (e.g., 'SR', 'Drums').
Assign the physical Preamps and Outputs to the stagebox. This defines the limits you can patch to later.
If a new assignment conflicts with an existing patch, Gigbuddy will warn you before overwriting.
Fast Patching & Editing
Click once to select a cell. Shift + click to select a range of cells.
Double-click a cell or press Enter to jump into edit mode.
Start typing on any selected cell to immediately overwrite it.
When a range of cells is selected, typing and hitting Enter applies that value to the entire selected block (perfect for assigning 8 drum mics at once).
Hit Escape to cancel an edit and revert to the previously saved value.
Ripple Routing
Row Menu Ripple: Click the 3 dots on a row, select Ripple, and enter a count. Gigbuddy will increment any trailing numbers downward (e.g., 'Vox 1' -> 'Vox 2' -> 'Vox 3').
Stagebox Dropdown Ripple: In the patch dropdown, define how many consecutive channels you want to patch, then select the starting preamp.
Stagebox ripple automatically overflows to the next logical stagebox if you patch across hardware boundaries.
Output patch ripple actively detects collisions and prompts you before clearing conflicting output assignments.
Excel Import
Click the 'Copy/Paste' icon in the Sound toolbar to open the import modal.
Paste tab-separated or comma-separated data directly from Excel, Numbers, or Google Sheets.
Gigbuddy attempts to auto-map headers (like 'Input', 'Mic', 'Stand'). If it guesses wrong, manually remap each column in the dropdown.
Set irrelevant columns to 'Ignore' so they don't overwrite your data.
Specify a 'Start Row' before importing. If you want to paste the drum kit starting at CH 1, make sure Start Row is 1.
Recently imported rows are briefly highlighted in green to help you verify everything landed correctly.
Output Lists
Switch to the Outputs tab to define wedges, IEMs, sidefills, and PA routing.
Like inputs, outputs can be grouped and assigned to physical stagebox outputs.
Use the 'Type' field to distinguish between Wedge, Stereo IEM, Mono IEM, etc.
Toggling a channel to 'Stereo' will automatically link it to the next consecutive output channel.
Stageplot Builder
Click the Stageplot tab to open the interactive 3D builder.
Drag and drop items from the Object Library, then move with click-drag and rotate by holding R while dragging.
Use the Layers panel to hide/show logical groups without removing objects from physics and collision.
Use Top View for precision layout, then switch back to 3D for depth and visual checks.
Stageplot objects still feed connected Sound workflows (setup, routing, and picking list context).
Festival Mode
Festival Mode is designed for multi-band days with tight changeovers.
Turn on Festival Mode in the Project Setup modal.
Create individual bands and assign them time slots and changeover durations.
Build a master 'Festival Patch' in the main list. Then, switch to a specific band to create 'Overrides' (e.g., swapping a vocal mic just for their set).
Gigbuddy aggregates all overrides to ensure you prep enough gear for the entire day.
Picking Lists
The Picking List automatically builds itself based on your project data.
It counts every mic, stand, and cable assigned in the Input and Output lists.
It includes all physical items dropped onto the Stageplot.
You can manually add extra items (like 'Gaff tape' or 'Batteries') using the 'Add Manual Item' button.
Permissions & Sharing
When a project is shared via a View-Only link, all data-mutating controls (Setup, Paste, Editing, Templates) are completely disabled.
Crew members can safely navigate the patch list on their phones, use filters, and view the stageplot without fear of breaking the patch.
Disabled tools will show a lock icon or a tooltip explaining that the user lacks edit permissions.
Troubleshooting
My Excel paste mapped to the wrong columns
Double-check the column mapping dropdowns before hitting import. If your Excel headers are weirdly named, Gigbuddy won't guess them correctly. Manually set them and try again.
Values pasted into the wrong channels
Always verify the 'Start Row' before clicking import. If you want to paste the drum kit starting at CH 1, make sure Start Row is 1.
Ripple changed more rows than I wanted
Actions-menu ripple starts exactly from the selected row and moves downward. Always double-check your current row selection and the ripple count you enter.
I'm getting a Patch Collision Warning
This means the preamp or output you selected is already assigned to another channel. Confirming will clear the old assignment to make room for the new one.
I can't edit any fields
You are likely viewing a project via a Read-Only link, or you lack edit permissions. Ask the project owner to upgrade your permissions if you need to make changes.
My changes aren't syncing to others
Check the top right corner of the app for the connection status indicator. If it's red or offline, you may have lost internet connection. Reconnect to resume live syncing.