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.
Quick Start
- 1Select your patchbay model from the Model dropdown in the Preview panel. The diagram and geometry update automatically.
- 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.
- 3Optionally add coloured sections to group channels visually (e.g. Inputs 1โ8 in green, Outputs in blue).
- 4Click A2 Print, A3 Print, or A4 Print to open the print layout.
- 5In your browser's print dialog, set scaling to 100% or Actual size. Print or save as PDF.
- 6Cut along the guide lines and fit the strips into your patchbay.
Interface Layout
The workspace is divided into five numbered panels:
| Panel | Purpose |
|---|---|
| 01 โ Preview | Live 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 โ Labels | Channel-by-channel label editor. Type Top and Bottom row text for each of the 24 (or 8/12 for XLR) channels. |
| 03 โ Sections | Add coloured fill sections spanning one or more channels, set fonts and borders, add vertical dividers, and manage presets. |
| 04 โ Geometry | Fine-tune millimetre dimensions for the printed label strips. Default values are pre-set accurately for each patchbay model. |
| 05 โ Instructions | Quick reference print guide. |
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
XLR Models
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
| Button | Action |
|---|---|
| Number channels | Fills any empty Top and Bottom fields with CH-01 through CH-24. Existing labels are preserved. |
| Clear all | Removes 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.
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
- 1Enter a Section label โ this text appears centred across the span.
- 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.
- 3Choose Apply to row: Top only, Bottom only, or Top + Bottom (default).
- 4Pick a Fill color using the colour picker or the quick crayon palette swatches.
- 5Optionally set a Font, Bold, Italic, or Leading spaces offset.
- 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.
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.
| Field | Description |
|---|---|
| Border style | None (default), Solid, Dashed, or Dotted. Rendered as an SVG stroke overlaid on the fill rectangle. |
| Border color | Any colour via the colour picker. Defaults to black. |
| Border width | Thickness in millimetres. Range 0.1โ3mm. Default 0.5mm. |
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).
| Field | Description |
|---|---|
| Label | A descriptive name shown in the divider list (not printed on the label strip). |
| Position | After point (right edge of channel N) or Before point (left edge of channel N). |
| Point | Channel number 1โ24 where the divider is placed. |
| Row | Apply to Top row, Bottom row, or both. |
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
- 1Type a name in the Preset name field (e.g. "Studio Patchbay โ Synths").
- 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
| Button | Action |
|---|---|
| โ Export presets | Downloads all saved presets as a patchbay-presets.json file. Use this to back up your work or transfer presets to another computer. |
| โ Import presets | Loads a previously exported .json file. Merges with existing presets โ new ones are added, existing ones (matched by ID) are updated. |
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.
- 1Save all the patchbays you want to print together as presets first.
- 2In the Multi-Bay Print section, select one or more presets from the list. Hold Cmd (Mac) or Ctrl (Windows) to select multiple.
- 3Choose a Page size: A2, A3, or A4 landscape.
- 4Click Print multi-bay layout.
- 5In the print stage, click Print or Save PDF at 100% scale.
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.
| Setting | Description |
|---|---|
| Left / Right margin | Gap from panel edge to first/last channel. Accounts for rack ears. |
| Top strip Y | Distance from panel top to the start of the top label strip. |
| Bottom strip Y | Distance from panel top to the start of the bottom label strip. |
| Strip height | Height of each label strip in mm. |
| Channel gap | Gap between adjacent channel label slots. |
| Cut extension | How far vertical cut guide lines extend beyond the strip. |
| Divider extension | How far explicit divider lines extend beyond the strip. |
| Font size | Size of individual channel labels in mm (SVG units). |
| Region size | Size of section/group labels in mm. |
| Panel width | Total panel width in mm. Standard 19-inch 1U = 482.6mm. |
| Panel height | Total panel height in mm. Standard 1U = 44.45mm. |
Print Guide
Page Formats
| Format | Best for |
|---|---|
| A2 landscape | Single full-width strip โ entire 482.6mm panel fits on one sheet. Requires A2 printer. |
| A3 landscape | Two tiles โ panel split across 2 sheets. Requires A3 printer or PDF to print shop. |
| A4 landscape | Two tiles โ panel split across 2 A4 sheets. Standard office printer compatible. |
100% or Actual size. Disable Fit to page. Do not shrink or enlarge.Cutting Guide
The printed sheet includes coloured reference lines to guide your cutting:
| Line colour | Meaning |
|---|---|
| Teal / green horizontal | Cut here horizontally โ the top and bottom edges of each label strip. |
| Red / orange vertical | Cut here vertically โ the left and right edge of the entire panel span. On A4 tiles, these mark the tile join points. |
| Dark vertical | Section divider marks โ do not cut here, these show section boundaries on the strip itself. |
- 1Cut along the horizontal teal lines to separate the top and bottom strips from the rest of the page.
- 2For A4 tiled prints, cut along the red vertical lines at the tile edges, then butt the two strips together precisely.
- 3Trim the left and right ends along the outer red vertical lines to match the panel width.
- 4Slide the strips into the patchbay label slots โ top strip in the top row, bottom strip in the bottom row.
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 key | Contents |
|---|---|
| patchbay-labeler-state-v3 | Active patchbay state: model, labels, sections, dividers, font settings, geometry values. |
| patchbay-labeler-presets-v2 | All saved presets as a JSON array. |
| px3000-crayon-palette-v1 | Custom crayon palette colours. |
Moving to a Different Computer
- 1Click โ Export presets โ this downloads a
patchbay-presets.jsonfile. - 2Copy the JSON file and the
patchbay-labeler.htmlfile to the new computer. - 3Open the HTML file in a browser, then click โ Import presets to load your presets.
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.