User Guide โ€” Audio Engineering Tool

Patchbae ๐Ÿ’•

VERSION 1.0.1
BROWSER NATIVE ยท NO INSTALL
A2 / A3 / A4 PRINT READY
9 PATCHBAY MODELS

v1.0.1
00 โ€” Overview

What is Patchbae ๐Ÿ’•?

Patchbae ๐Ÿ’• is a browser-based tool for designing, organising, and printing label strips for 19-inch rack patchbays. It runs entirely in your browser โ€” no installation, no account, no internet required after opening the file.

The app generates print-ready label strips at exact 1:1 scale for A2, A3, or A4 paper. Cut along the guide lines and slide the strips into your patchbay. Every label, section colour, and divider is preserved between sessions in your browser's local storage.

It supports nine patchbay models across TRS and XLR formats, with accurate hardware preview diagrams for each unit so you can visualise the finished result before printing.

01 โ€” Getting Started

Quick Start

  1. 1Select your patchbay model from the Model dropdown in the Preview panel. The diagram and geometry update automatically.
  2. 2Type labels into the channel grid โ€” each channel has a Top and Bottom row field. Or click Number channels to auto-fill CH-01 through CH-24.
  3. 3Optionally add coloured sections to group channels visually (e.g. Inputs 1โ€“8 in green, Outputs in blue).
  4. 4Click A2 Print, A3 Print, or A4 Print to open the print layout.
  5. 5In your browser's print dialog, set scaling to 100% or Actual size. Print or save as PDF.
  6. 6Cut along the guide lines and fit the strips into your patchbay.
02 โ€” Interface

Interface Layout

The workspace is divided into five numbered panels:

PanelPurpose
01 โ€” PreviewLive patchbay diagram showing your labels, sections, and dividers in real time. Click any label or section to jump directly to that field in the editor.
02 โ€” LabelsChannel-by-channel label editor. Type Top and Bottom row text for each of the 24 (or 8/12 for XLR) channels.
03 โ€” SectionsAdd coloured fill sections spanning one or more channels, set fonts and borders, add vertical dividers, and manage presets.
04 โ€” GeometryFine-tune millimetre dimensions for the printed label strips. Default values are pre-set accurately for each patchbay model.
05 โ€” InstructionsQuick reference print guide.
03 โ€” Patchbay Models

Supported Patchbay Models

Select your patchbay from the Model dropdown at the top of the Preview panel. The channel count, label strip geometry, and hardware diagram all update automatically.

TRS 24-Channel Models

TRS ยท 24ch ยท 48pt
Behringer PX3000
ULTRAPATCH PRO ยท SILVER PANEL
19-inch 1U, separate top and bottom label strips, standard 24-channel layout.
TRS ยท 24ch ยท 48pt
Neutrik NYS-SPP-L1
NEAR-BLACK PANEL ยท CHROME NUTS
24 channels, PCB-wired jack cards, grey normalising indicator on top jacks.
TRS ยท 24ch ยท 48pt
Samson S-Patch Plus
COBALT BLUE ยท TOGGLE SWITCHES
Fully balanced, 3-way toggle switches per channel (Normal / Half-Normal / Thru).
TRS ยท 24ch ยท 48pt
ART P48
DARK STEEL ยท REAR N/HN BUTTONS
483ร—44mm, half-normal/normal per pair, reversible rack ears.
TRS ยท 24ch ยท 48pt
Black Lion Audio PBR TRS
MATTE BLACK ยท GOLD JACKS
96 gold-plated jacks, rear 3-way mode switches per channel, black anodised faceplate.
TRS ยท 24ch ยท 48pt
dbx PB-48
DARK GREY ยท CARD MODULES
24 swappable card modules, configurable half-normal or de-normal per board.

XLR Models

XLR ยท 8ch ยท 16pt
ART P16
BLACK STEEL ยท PHANTOM POWER
8 channels, XLRF front + XLRM rear, PCB-wired, passes +48V phantom.
XLR ยท 12ch ยท 12pt
Hosa PDR-369
BLACK STEEL ยท GOLD CONTACTS
12 channels, reversible XLRF/XLRM front and rear, gold-plated contacts.
XLR ยท 8ch ยท 16pt
Millenium PB16 XLR
BLACK STEEL ยท HARD-WIRED THRU
8 channels, hard-wired thru (no normalling), 8ร— XLRF + 8ร— XLRM on front.
XLR models have fewer channels (8 or 12) spread across the same 19-inch panel width, resulting in wider individual label slots. The label grid and print geometry update automatically when you switch models.
04 โ€” Labels

Label Editor

Each channel has two text fields โ€” Top and Bottom โ€” corresponding to the two rows of jacks on the patchbay. Labels are limited to 24 characters each.

Toolbar Buttons

ButtonAction
Number channelsFills any empty Top and Bottom fields with CH-01 through CH-24. Existing labels are preserved.
Clear allRemoves all Top and Bottom labels from every channel. Cannot be undone โ€” save a preset first if needed.

Label Font

Choose a font for individual channel labels using the Label font dropdown. Bold and Italic checkboxes apply to all individual channel labels globally. Section labels (for grouped spans) have their own font setting per section.

Interactive Preview

Click any label area in the preview diagram to jump directly to that channel's input field in the editor. Click a coloured section to open it in the section editor for quick changes.

06 โ€” Sections & Colors

Sections & Colors

Sections create a single merged label that spans one or more channels, with a solid fill colour. They're ideal for grouping inputs, outputs, returns, sends, or any logical group.

Adding a Section

  1. 1Enter a Section label โ€” this text appears centred across the span.
  2. 2Set Start channel and End channel. For a single-channel label, set both to the same number. For a stereo pair, use e.g. 15โ€“16.
  3. 3Choose Apply to row: Top only, Bottom only, or Top + Bottom (default).
  4. 4Pick a Fill color using the colour picker or the quick crayon palette swatches.
  5. 5Optionally set a Font, Bold, Italic, or Leading spaces offset.
  6. 6Click Add section.

Editing a Section

Click any coloured section in the Preview to load it into the section form for editing. The button changes to Save section. Click Clear text on a section card to blank its label without deleting it. Click Delete to remove it entirely.

Crayon Palette

The Quick palette row shows 10 pre-set pastel swatches for fast colour selection. Click any swatch to apply it to the current section colour. The Edit palette row lets you click any swatch to customise that colour using your system colour picker โ€” custom palette colours are saved in your browser.

Tip: Use light pastel fills so the label text remains readable. The app automatically chooses black or white text based on the background luminance.
07 โ€” Section Borders

Section Borders

Each section can have an optional bounding box drawn around it, independent of the fill colour. This is useful for highlighting a section or creating an outlined-only style with a white or transparent fill.

FieldDescription
Border styleNone (default), Solid, Dashed, or Dotted. Rendered as an SVG stroke overlaid on the fill rectangle.
Border colorAny colour via the colour picker. Defaults to black.
Border widthThickness in millimetres. Range 0.1โ€“3mm. Default 0.5mm.
Note: Border style, colour, and width are per-section settings. They appear in the section form below the Italic checkbox.
08 โ€” Dividers

Vertical Dividers

Dividers draw a heavier vertical rule between channels โ€” useful for marking boundaries between groups independent of section spans (e.g. a divider between channel 8 and 9 even when both are inside the same section).

FieldDescription
LabelA descriptive name shown in the divider list (not printed on the label strip).
PositionAfter point (right edge of channel N) or Before point (left edge of channel N).
PointChannel number 1โ€“24 where the divider is placed.
RowApply to Top row, Bottom row, or both.
09 โ€” Presets

Presets

Presets save a complete snapshot of the current patchbay state โ€” model, all labels, all sections, all dividers, font settings, and geometry โ€” so you can reload it at any time.

Saving a Preset

  1. 1Type a name in the Preset name field (e.g. "Studio Patchbay โ€” Synths").
  2. 2Click Save preset. It appears immediately in the list below.

Loading a Preset

Click the Load button on any preset card. This replaces the current state entirely โ€” including labels, model, sections, and geometry.

Updating a Preset

Select a preset card (click it to highlight), then click Update preset to overwrite it with the current state. The name in the preset form is used if you want to rename it at the same time.

Export & Import

ButtonAction
โ†“ Export presetsDownloads all saved presets as a patchbay-presets.json file. Use this to back up your work or transfer presets to another computer.
โ†‘ Import presetsLoads a previously exported .json file. Merges with existing presets โ€” new ones are added, existing ones (matched by ID) are updated.
Important: Presets are stored in your browser's local storage. Clearing your browser data will delete them. Use Export presets regularly to keep a backup file.
10 โ€” Multi-Bay Print

Multi-Bay Print

Stack multiple saved patchbay presets onto a single print sheet for maximum paper efficiency. Each bay is packed top-to-bottom with a name label above it; a new sheet is created automatically when the page fills up.

  1. 1Save all the patchbays you want to print together as presets first.
  2. 2In the Multi-Bay Print section, select one or more presets from the list. Hold Cmd (Mac) or Ctrl (Windows) to select multiple.
  3. 3Choose a Page size: A2, A3, or A4 landscape.
  4. 4Click Print multi-bay layout.
  5. 5In the print stage, click Print or Save PDF at 100% scale.
Tip: A4 landscape fits 3โ€“4 patchbay strips per sheet. A3 fits 6โ€“7. A2 fits the entire 24-channel PX3000 on a single sheet at full width.
11 โ€” Print Geometry

Print Geometry

All geometry values are in millimetres. Default values are pre-loaded accurately for each patchbay model. You should only need to change these if your printer has unusual scaling, or if you're trimming paper differently.

SettingDescription
Left / Right marginGap from panel edge to first/last channel. Accounts for rack ears.
Top strip YDistance from panel top to the start of the top label strip.
Bottom strip YDistance from panel top to the start of the bottom label strip.
Strip heightHeight of each label strip in mm.
Channel gapGap between adjacent channel label slots.
Cut extensionHow far vertical cut guide lines extend beyond the strip.
Divider extensionHow far explicit divider lines extend beyond the strip.
Font sizeSize of individual channel labels in mm (SVG units).
Region sizeSize of section/group labels in mm.
Panel widthTotal panel width in mm. Standard 19-inch 1U = 482.6mm.
Panel heightTotal panel height in mm. Standard 1U = 44.45mm.
12 โ€” Printing

Print Guide

Page Formats

FormatBest for
A2 landscapeSingle full-width strip โ€” entire 482.6mm panel fits on one sheet. Requires A2 printer.
A3 landscapeTwo tiles โ€” panel split across 2 sheets. Requires A3 printer or PDF to print shop.
A4 landscapeTwo tiles โ€” panel split across 2 A4 sheets. Standard office printer compatible.
Scale must be 100%. Any scaling will cause the printed labels to not align with the physical jack positions on your patchbay. Always verify with a ruler before cutting.
13 โ€” Cutting

Cutting Guide

The printed sheet includes coloured reference lines to guide your cutting:

Line colourMeaning
Teal / green horizontalCut here horizontally โ€” the top and bottom edges of each label strip.
Red / orange verticalCut here vertically โ€” the left and right edge of the entire panel span. On A4 tiles, these mark the tile join points.
Dark verticalSection divider marks โ€” do not cut here, these show section boundaries on the strip itself.
  1. 1Cut along the horizontal teal lines to separate the top and bottom strips from the rest of the page.
  2. 2For A4 tiled prints, cut along the red vertical lines at the tile edges, then butt the two strips together precisely.
  3. 3Trim the left and right ends along the outer red vertical lines to match the panel width.
  4. 4Slide the strips into the patchbay label slots โ€” top strip in the top row, bottom strip in the bottom row.
15 โ€” Data & Storage

Data & Storage

All data is stored entirely in your browser's local storage. Nothing is sent to any server. The app works fully offline.

Storage keyContents
patchbay-labeler-state-v3Active patchbay state: model, labels, sections, dividers, font settings, geometry values.
patchbay-labeler-presets-v2All saved presets as a JSON array.
px3000-crayon-palette-v1Custom crayon palette colours.
Browser data warning: Clearing browser site data, using private/incognito mode, or switching browsers will result in loss of saved state and presets. Use โ†“ Export presets to keep a backup file.

Moving to a Different Computer

  1. 1Click โ†“ Export presets โ€” this downloads a patchbay-presets.json file.
  2. 2Copy the JSON file and the patchbay-labeler.html file to the new computer.
  3. 3Open the HTML file in a browser, then click โ†‘ Import presets to load your presets.
16 โ€” Tips & Shortcuts

Tips & Shortcuts

Workflow Tips

  • Use sections for everything that spans more than one channel โ€” it's much cleaner than individual channel labels and allows larger, more readable text.
  • Set the section label to empty and just use a fill colour for a colour-only block with no text โ€” useful as a visual spacer between groups.
  • Single-channel sections (start = end) are great for labelling individual important channels in a contrasting colour without a spanning label.
  • Use Leading spaces in a section to push the text off-centre if you want the label to appear on the right half of a wide span.
  • The preview is interactive โ€” clicking labels is faster than scrolling through 24 channel cards.
  • Save a preset before making large changes so you can always revert.
  • Use dashed borders on sections to indicate patching that is temporary or variable.

Print Tips

  • Print on plain white 80gsm paper first to verify scale, then on heavier card stock for the final version.
  • Laminating the strips significantly extends their life in a working studio environment.
  • For A4 tiled prints, use a metal ruler and scalpel for the join cuts โ€” even a 0.5mm error will be visible.
  • If your printer has a "borderless" mode, disable it โ€” standard margins are fine since the strips sit well within the printable area.
  • Save as PDF first, then print the PDF โ€” this gives you one more opportunity to check scale before committing to paper.

Supported Browsers

Chrome, Firefox, Safari, and Edge (all modern versions). Internet Explorer is not supported. For best print results use Chrome or Edge which offer the most accurate PDF export.