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 15 patchbay models across TRS, XLR, and Bantam/TT formats, with accurate hardware preview diagrams for each unit. Print options include A2 (single sheet), A3 tiled, A4 tiled, A3 diagonal (full panel on one sheet), and a multi-bay stacker for printing entire studio racks efficiently.
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
Bantam / TT 48-Channel Models
Bantam (TT) patchbays are twice as dense as TRS โ 96 points (48 channels) in a single 1U rack space. Jacks are 4.4mm diameter vs 6.35mm for TRS. The channel grid expands to 48 channels automatically when a Bantam model is selected.
Neutrik NPPA-TT Series
The NPPA-TT series uses a distinct silver-anodised aluminium front panel (AlMgSi0.5 F22) fitted into a black coated steel shell โ visually different from other bantam panels. All models use NJ3TTA gold-plated double-contact TT jacks (4.4mm barrel, 5000+ cycle lifetime) and share identical front panel dimensions: 482.6 ร 44.45mm. Two removable paper label strips (top and bottom row) are accessible by unscrewing one outer fixing screw.
| Model | Rear connection | Normalling |
|---|---|---|
| NPPA-TT-PT | 288 push terminals | Half-normal (bottom row) |
| NPPA-TT-PT-FN | 288 push terminals | Full normal |
| NPPA-TT-PT-I | 288 push terminals | Isolated |
| NPPA-TT-S | 288 solder terminals | Half-normal (bottom row) |
| NPPA-TT-S-FN | 288 solder terminals | Full normal |
| NPPA-TT-IDC | IDC fast-wire | Half-normal (bottom row) |
| NPPA-TT-SD25 | 12ร DB-25 (Tascam DA-88 pinout) | Half-normal (bottom row) |
| NPPA-TT-SD50 | 4ร DB-50 (Elco pinout) | Half-normal (bottom row) |
| NPPA-TT-E56 | 6ร Edac 56-pin | Half-normal (bottom row) |
| NPPA-TT-E90 | 4ร Edac 90-pin | Half-normal (bottom row) |
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.
Draft Persistence
All in-progress form field values โ section name, channel range, fill colour, font, border settings, divider fields, normalling fields, and the preset name โ are automatically saved to your browser as you type. If you close the tab, refresh the page, or navigate away, every field is restored exactly as you left it when you reopen the app. Drafts are only cleared when you successfully submit a form (e.g. click Add section or Save preset).
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. |
Normalling Indicators
Normalling indicators add visual arrows in the gap between the top and bottom label strips, showing which channels carry a normalised connection and in which direction. They appear in the preview and all print formats.
The section sits beneath Vertical Dividers in the Sections panel.
| Field | Description |
|---|---|
| Label | A descriptive name shown in the indicator list. Not printed on the label strip. |
| At point | The first channel to apply the arrow to. |
| To point | The last channel in the range. Set both to the same number for a single channel. |
| Direction | See direction options below. |
Direction Options
| Symbol | Option | Meaning |
|---|---|---|
| โ | Half-normal | Top row feeds bottom row when nothing is patched into the bottom jack. Standard studio normalling. |
| โ | Full normal | Both rows are normalised to each other. Rendered with a crossbar through the arrow shaft to distinguish from half-normal. |
| โ | Top feeds bottom | Single downward arrow. Signal flows from top row to bottom row. |
| โ | Bottom feeds top | Single upward arrow. Signal flows from bottom row to top row. |
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. Each bay is packed top-to-bottom with a preset name label above it. A new sheet is created automatically when the current page is full.
- 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.
- 4Choose a Print mode: Full patchbay or Labels only.
- 5Click Print multi-bay layout.
- 6In the print stage, click Print or Save PDF at 100% scale.
Print Modes
| Mode | Description | Bays per A4 page |
|---|---|---|
| Full patchbay | Complete hardware diagram with jacks, panel body, and label strips. Accurate visual representation of the physical unit. | ~3 |
| Labels only | Just the two label strips, tightly packed with no hardware background. Maximum density for large studio rack runs. | ~8 |
A3 Diagonal Print
The A3 Diagonal button prints the full 482.6mm panel on a single A3 sheet by rotating it 35.26ยฐ โ the exact angle of the A3 diagonal (514mm), which is comfortably longer than any supported panel width.
| Value | |
|---|---|
| A3 page size | 420 ร 297mm landscape |
| A3 diagonal | 514mm |
| Rotation angle | 35.26ยฐ (atan2 of 297รท420) |
| Maximum panel width | 483mm (ART P48, Millenium) |
| Sheets required | 1 |
How to Use
- 1Click A3 Diagonal in the print button row.
- 2The print stage shows the panel rotated diagonally on the A3 page with teal and red cut guides overlaid.
- 3Print at 100% actual size on A3 landscape paper.
- 4Cut along the teal diagonal lines to extract each label strip. The strips will be at an angle on the page โ this is correct.
- 5Straighten and fit into the patchbay as normal.
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. |
| A3 diagonal | Full panel on one A3 sheet, rotated 35.26ยฐ. Single continuous strip โ no tile join. Requires careful diagonal cutting. |
| 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. |
| patchbae-stats-v1 | Usage statistics (session count, print history, model usage). Viewable via admin panel. |
| patchbae-drafts-v1 | In-progress form field values โ restored automatically on next page load. |
Moving to a Different Computer
- 1Click โ Export presets โ this downloads a
patchbay-presets.jsonfile. - 2Copy the JSON file and the
index.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.
Version History
New Patchbay Models
| Model | Type | Notes |
|---|---|---|
| ART P48 | TRS 24ch | Per-channel N/HN selector button, matte black steel, 483ร44mm |
| Black Lion Audio PBR TRS | TRS 24ch | Gold-plated jacks, deep matte black anodised faceplate, rear switching only |
| dbx PB-48 | TRS 24ch | Medium warm grey panel, 24 swappable card modules, 482ร44mm |
| ART P16 | XLR 8ch | XLRF front, XLRM rear, passes +48V phantom, 483ร44mm |
| Hosa PDR-369 | XLR 12ch | Gold-plated contacts, reversible XLRF/XLRM |
| Millenium PB16 XLR | XLR 8ch | Hard-wired thru, no normalling, 483ร44mm |
| Switchcraft StudioPatch 9625 | Bantam 48ch | DB-25 rear, EZ Norm front-panel screwdriver normalling |
| Switchcraft StudioPatch 6425 | Bantam 32ch | Smaller 64-point variant of the 9625 |
| Bittree B96DC / 961 Series | Bantam 48ch | Solid-gold contacts, DB-25 or solder rear |
| Redco R196-D25PG | Bantam 48ch | Silver/black panel, top-access normalling, DB-25 Tascam pinout |
| ADC BJF Series | Bantam 48ch | Industry-standard broadcast/studio bantam bay |
| REAN MA96-1S (Neutrik) | Bantam 48ch | Nickel contacts, silver faceplate, five solder lugs per jack |
Print Features
| Feature | Description |
|---|---|
| A3 Print | Standard A3 landscape tiled layout added alongside A2 and A4 |
| A3 Diagonal | Full panel on one A3 sheet rotated 35.26ยฐ along the diagonal โ no tile join required |
| Multi-Bay: Full patchbay mode | Stack multiple presets with complete hardware diagrams, ~3 bays per A4 page |
| Multi-Bay: Labels only mode | Strip-only stacking at ~8 bays per A4 page for efficient full-rack runs |
Section Enhancements
| Feature | Description |
|---|---|
| Section borders | Optional bounding box per section: None, Solid, Dashed, or Dotted โ with independent colour and width (0.1โ3mm) |
Presets
| Feature | Description |
|---|---|
| Export presets | Download all presets as a patchbay-presets.json file for backup or cross-device transfer |
| Import presets | Load a previously exported JSON file โ merges by ID (adds new, updates existing) |
| Multi-bay preset select | Multi-select list in the preset panel for choosing which presets to stack in a print run |
Dimension Accuracy
All panel dimensions verified against official manufacturer manuals and datasheets. Corrections applied to: Neutrik NYS-SPP-L1, ART P48, Black Lion PBR TRS, dbx PB-48, ART P16, Hosa PDR-369, and Millenium PB16 XLR.
Normalling Indicators
New section beneath Vertical Dividers. Add visual arrows between label strips showing normalised connections โ half-normal (โ), full normal (โ with crossbar), top-to-bottom (โ), or bottom-to-top (โ). Specify a channel range in one step. Saved in presets and printed in all layouts.
Neutrik NPPA-TT Series (10 models)
All 10 current Neutrik NPPA-TT bantam panels added in a dedicated dropdown group with accurate silver-anodised aluminium front panel diagram and gold NJ3TTA jack rendering. Models grouped by rear connection type: push terminal, solder terminal, IDC, DB-25, DB-50, Edac 56-pin, Edac 90-pin.
Draft Form Persistence
All in-progress form values (section, divider, normalling, preset name fields) are saved automatically to patchbae-drafts-v1 on every keystroke and restored on page load. Drafts are cleared only on successful submission.
Other Improvements
- Preview background colour now matches page background โ no more white gap beside the panel diagram
- Preview SVG stretches to fill the full panel width of the preview container
- Hardware diagrams updated for ART P48 (per-channel N button), Black Lion PBR TRS (deeper matte black, prominent screws), and dbx PB-48 (accurate medium grey panel with red logo)
- Dynamic channel count โ switching to a Bantam model expands the label editor to 48 channels; XLR models show 8 or 12
- Admin statistics panel accessible by typing
adminon the keyboard while the app is open (password protected) - Contact link in app header (obfuscated to protect against spam harvesters)
- User manual linked directly from app header
- App renamed to
index.htmlfor standard web deployment
- 24-channel label editor with Top and Bottom row fields per channel
- Sections with colour fill, spanning labels, font control, and leading space offset
- Vertical dividers between channels
- Named presets with save, load, and update
- A2 and A4 print layouts with cut guides
- Three initial models: Behringer PX3000, Neutrik NYS-SPP-L1, Samson S-Patch Plus
- Customisable crayon palette for quick colour selection
- All state persisted in browser local storage
- Fully offline โ no server, no account, no dependencies