UC4 SysEx Editor

Complete Usage Guide — A web-based configuration editor for the Faderfox UC4 MIDI controller

Quick Start
Interface Overview
Working with Files
Navigating Setups & Groups
Focused View — Detailed Editing
Overview Mode — See Everything
Quick Copy/Paste — Rapid Configuration
Setup Manager — Organize Your Setups
Conflict Detection
Context Menu Copy & Paste
Undo, Redo & Reset
Session Persistence
Keyboard Shortcuts
Workflow Examples
Validation & Troubleshooting

Quick Start

┌────────────────────────────────────────────────────────────────┐
│  1. Open editor        →  Factory defaults load automatically  │
│  2. Select Setup 1-18  →  Pick which setup to edit            │
│  3. Edit in Focused    →  Change individual parameters        │
│  4. Check in Overview  →  See all 64 controls at once         │
│  5. Export .syx        →  Send to UC4 via MIDI                │
└────────────────────────────────────────────────────────────────┘

That's it! The editor auto-loads factory defaults so you can start immediately.

Interface Overview

Header Elements

Button	What It Does
Import SysEx	Load a .syx dump from your UC4
Export SysEx	Save changes as .syx to send back to UC4
Import JSON	Load a human-readable JSON backup
Export JSON	Save human-readable JSON (great for git!)
↶ Undo	Reverse your last change
↷ Redo	Replay an undone change
Manage Setups	Open Setup Manager for bulk operations

Navigation Elements

Element	What It Does
Setup [▾]	Choose which of the 18 setups to edit
🔗 Link	Sync encoder and fader groups together
Encoder Grp [1-8]	Select group for encoders + push buttons
Fader/Btn [1-8]	Select group for faders + green buttons
GrP1	Shows the 4-character group name from UC4
Focused / Overview	Toggle between edit modes

Status Bar

Indicator	Meaning
● Modified	You have unsaved changes
○ (outline)	Data matches last saved state
100,640 bytes	Valid UC4 dump is loaded

Working with Files

SysEx Files (.syx)

The native format for UC4 data.

Import:

Click Import SysEx
Select a .syx file (must be exactly 100,640 bytes)
File loads immediately

Export:

Click Export SysEx
File downloads to your Downloads folder
Send this file to your UC4 via MIDI

JSON Files

Human-readable format, great for backups and version control.

Import:

Click Import JSON
Select a .json file exported from this editor
All 18 setups are loaded

Single Setup JSON

Export and import individual setups via the Setup Manager.

Export Single Setup:

Click Manage Setups
Select one setup
Click Export
Choose filename and save

Import to Slot:

Click Manage Setups
Click Import
Select single-setup JSON file
Choose target slot
Click Import

The UC4's Two-Domain System

The UC4 has two independent group selectors:

ENCODER DOMAIN (Shift + Encoder 1-8)
├── 8 Encoders
└── 8 Push Buttons

FADER/BUTTON DOMAIN (Shift + Green 1-8)
├── 8 Faders (1-8)
├── 8 Green Buttons
└── Fader 9

You can be on Encoder Group 3 while Fader Group 7 is active. They're independent!

Link Groups Toggle

Enabled (🔗 checked):

Clicking any group tab sets BOTH domains to that group
Useful when your groups are organized by channel (Group 1 = Ch1, etc.)

Disabled:

Encoder and Fader groups are independent
Matches actual UC4 hardware behavior

Focused View — Detailed Editing

The default editing mode, showing one group at a time with full parameter access.

Section Order

Faders (from Fader group)
Green Buttons (from Fader group)
Encoders (from Encoder group)
Push Buttons (from Encoder group)
Fader 9 (from Fader group)

Contextual Tooltips

Hover over any parameter label or dropdown option to see explanations!

Example	Tooltip
Hover over Chan	"MIDI channel (1-16). Controls which channel receives messages."
Hover over CCr1 option	"Relative mode 1. Sends 1 for clockwise, 127 for counter-clockwise. Best for Ableton, Bitwig."
Hover over Acc	"Acceleration sensitivity. Higher values = faster response to quick turns."

Control Parameters

Encoder:

Param	Range	Description
Chan	1-16	MIDI channel
CC	0-127	Controller number
Type	CCr1/CCr2/CCAb/PrGC/CCAh/Pbnd/AFtt	Message type
Acc	0-4	Acceleration sensitivity
Disp	0-4	Display mode on UC4
Min	0-127	Minimum output value
Max	0-127	Maximum output value

Push/Green Button:

Param	Range	Description
Chan	1-16	MIDI channel
Type	Note/CC/PrGC/AFtt/Off	Message type
Note/CC	0-127	Note or CC number
Lower	0-127	Value on release
Upper	0-127	Value on press
Mode	Momentary/Toggle/Step	Button behavior

Fader:

Param	Range	Description
Chan	1-16	MIDI channel
CC	0-127	Controller number
Type	CCAb/PrGC/Pbnd/AFtt	Message type
Min	0-127	Value at bottom
Max	0-127	Value at top

Overview Mode — See Everything

Grid view showing all controls across all 8 groups simultaneously.

Tabs

Tab	What It Shows
All	All control types stacked vertically
Encoders	8×8 grid of encoders only
Push	8×8 grid of push buttons
Green	8×8 grid of green buttons
Faders	8×8 fader grid + fader9 row

Cell Format

Each cell shows: Channel:Type CC#

Display	Meaning
`1:CC 64`	Channel 1, CC, number 64
`2:Nt 60`	Channel 2, Note, number 60
`3:PC 0`	Channel 3, Program Change, number 0
`1:PB --`	Channel 1, Pitch Bend
`1:AT --`	Channel 1, Aftertouch

Cell Interactions

Action	Result
Single-click	Select cell (green outline)
Double-click	Jump to Focused view
Right-click	Context menu + select
Hover (in Quick Paste)	Preview paste target

Quick Copy/Paste — Rapid Configuration

The fastest way to copy/paste in Overview mode. Press Q to activate.

Quick Paste Toolbar

┌──────────────────────────────────────────────────────────────────┐
│ Mode [Off][Copy][Paste]   Scope [Cell][Column][Row]              │
│ Source: Enc G1.1          Ch [+1▾]  CC [0▾]   [Clear Source]     │
│ Status: Click to paste • 3 pasted                                │
└──────────────────────────────────────────────────────────────────┘

Workflow

Press Q or click Copy — Enter Quick Paste mode
Select scope: Cell (1), Column (2), or Row (3)
Click a cell — Copies source and switches to Paste mode
Click target cells — Pastes with offsets applied
Press Q again — Exit Quick Paste mode

Channel/CC Multipliers

The multipliers apply offsets based on the group difference between source and target.

Formula: offset = (targetGroup - sourceGroup) × multiplier

Example with Ch=+1, CC=0:

Source	Target	Group Diff	Channel Offset
G1	G2	1	+1
G1	G3	2	+2
G1	G5	4	+4

So copying from G1 Ch1 to G3 with Ch=+1 results in Ch3.

Scope Options

Scope	What's Copied	What's Pasted
Cell	One control	One control
Column	All 8 controls in group	All 8 controls in target group
Row	One control from all 8 groups	Same row across 8 groups

Visual Feedback

Green highlight: Source cells
Cyan outline: Paste preview (hover)
Toast message: Confirms each paste

Keyboard Shortcuts

Key	Action
Q	Toggle Quick Paste on/off
1	Cell scope
2	Column scope
3	Row scope

Setup Manager — Organize Your Setups

Manage entire setups: label, copy, swap, clear, reset, export, import.

Opening Setup Manager

Click [Manage Setups] in the header.

Setup Grid

┌─────────────────────────────────────────────────────────────────┐
│ Setup Manager                                            [×]   │
├─────────────────────────────────────────────────────────────────┤
│  1: Synth      2: Drums     3: (factory)  4: FX               │
│  5            6: Keys       7            8                     │
│  9            10           11           12                     │
│  13           14           15           16                     │
│  17: Ableton  18: Ableton                                      │
├─────────────────────────────────────────────────────────────────┤
│ [Label] [Clear] [Copy] [Swap] [Reset] [Export] [Import]        │
└─────────────────────────────────────────────────────────────────┘

Visual Indicators

Accent border: Setup has been modified
(factory): Setup matches factory defaults
Label text: Custom label you've assigned

Selection

Click: Select one setup
Ctrl+Click: Multi-select (add/remove from selection)
Click empty area: Deselect all

Operations

Button	Requires	Action
Label	1 setup	Assign a name (stored in browser, not SysEx)
Clear	1+ setups	Zero out all parameters
Copy	1 setup	Duplicate to other slot(s)
Swap	2 setups	Exchange two setups
Reset	1+ setups	Restore factory defaults
Export	1 setup	Save as single-setup JSON
Import	—	Load single-setup JSON to a slot

Labels

Labels are stored in your browser (localStorage), not in the SysEx file. They appear in:

Setup dropdown: "1: Synth"
Setup Manager grid
Export filenames (suggested)

Conflict Detection

Automatically finds MIDI assignment conflicts.

Conflict Types

Type	Description	Severity
Concurrent	Same message from controls active at the same time	⚠️ Fix these!
Mutually-Exclusive	Same message in different groups	Usually OK

Understanding Conflicts

Concurrent conflicts happen when two controls in the same active domain send identical messages. Examples:

Encoder 1 and Encoder 3 both send Ch1 CC64 (same group)
Fader 1 and Green Button 1 both send Ch1 CC64 (same fader group)

Mutually-exclusive conflicts happen across different groups—only one can be active at a time, so usually intentional.

Filter Chips

[✓ Concurrent (3)] [□ Mutually-Exclusive (12)]

Click to show/hide each conflict type in the grid.

Context Menu Copy & Paste

Right-click in Overview mode for advanced copy/paste operations.

Copy Scopes

Menu Item	What's Copied
Copy Control	Single cell (one control)
Copy Row	Same control index across all 8 groups
Copy Column	All controls in one group

Paste Special Dialog

Opens a dialog with transform options:

Option	Range	Description
Channel offset	-15 to +15	Shift MIDI channel
CC/Number offset	-127 to +127	Shift CC or note number
Auto-increment	Any integer	Add sequential offset per target
Wrap mode	Clamp / Wrap	Out-of-range behavior

Undo, Redo & Reset

Full edit history with intelligent coalescing.

What's Tracked

Individual parameter changes
Batch operations (paste to row/column)
Setup Manager operations (copy, swap, clear, reset)
Label changes

Coalescing

Rapid edits to the same parameter (within 1 second) are combined into one undo step. This means dragging a slider doesn't create 50 undo entries.

Limits

100 undo steps maximum
Oldest actions are dropped when limit reached

Shortcuts

Action	Windows/Linux	Mac
Undo	Ctrl+Z	Cmd+Z
Redo	Ctrl+Shift+Z	Cmd+Shift+Z
Redo (alt)	Ctrl+Y	—

Session Persistence

Auto-saves your work to browser storage.

How It Works

Changes are saved every 2 seconds
Survives page refresh and browser restart
Only prompts to restore if you have unsaved changes

When Session Clears

After Export SysEx
After Export JSON
After Import (new file replaces session)
After clicking Discard

Keyboard Shortcuts

Global

Key	Action
Ctrl+Z	Undo
Ctrl+Shift+Z	Redo
Ctrl+Y	Redo (alternate)

Overview Mode

Key	Action
↑↓←→	Move selection
Enter	Jump to Focused view for selected cell
Tab	Move right
Shift+Tab	Move left
Escape	Clear selection
Ctrl+C	Copy selected control
Ctrl+V	Paste to selected

Quick Paste

Key	Action
Q	Toggle Quick Paste mode
1	Cell scope
2	Column scope
3	Row scope

Workflow Examples

Create a Channel-Per-Group Setup

Goal: Group 1 = Channel 1, Group 2 = Channel 2, etc.

Method (Quick Paste):

Configure Group 1 exactly as you want (all controls on Ch1)
Switch to Overview → Encoders tab
Press Q → select Column scope
Set Ch to +1, CC to 0
Click any cell in Group 1 (copies whole column)
Click Group 2, 3, 4... headers (pastes with channel offset)
Repeat for Push, Green, Faders tabs

Time: ~2 minutes for complete setup

Sequential CCs Across a Row

Goal: Encoder 1 in all groups = CC1, CC2, CC3...CC8

Method (Context Menu):

Overview → Encoders tab
Right-click Enc 1, Group 1 → Copy Control
Right-click same cell → Paste Special...
Set Auto-increment CC by: 1
Paste to: Entire row
Click Paste

Result: G1=CC1, G2=CC2, G3=CC3...

Prepare Setups for Live Show

Label your setups: Setup Manager → select setup → Label → "Opener", "Main", "Encore"
Check for conflicts: Overview mode → ensure Concurrent count is 0
Export backup: Export JSON → save as "live-show-backup.json"
Export SysEx: Export SysEx → send to UC4
Test on hardware: Verify all setups work correctly

Validation & Troubleshooting

"Invalid file size" Error

Cause: The file isn't a complete UC4 dump.

Fix: Use "Send All Setups" from UC4, not single-setup dump.

Changes Don't Appear on UC4

Checklist:

Did you click Export SysEx? (JSON won't work)
Did you send the .syx file to UC4 via MIDI?
Is UC4 ready to receive? (Check manual for receive mode)

Lost My Edits

Refresh the page — Look for restore dialog
Check Downloads — Look for exported files
Check for JSON backup — You did export JSON, right?

Prevention: Export JSON frequently as backup!

Conflicts Everywhere

This is normal for factory defaults!

Factory config uses identical settings across groups intentionally.

Mutually-Exclusive: Different groups, same message (OK)
Concurrent: Same group, same message (fix these)

Use filter chips to show only Concurrent conflicts.

Quick Paste Not Working

Are you in Overview mode? Quick Paste only works there.
Is the toolbar visible? Press Q to toggle.
Did you set a source? Click a cell in Copy mode first.
Same control type? Can't paste encoders to faders.

Tooltips Not Showing

Wait 500ms — There's a delay before tooltips appear
Focused view only — Tooltips only show in Focused view
Hover over labels — Not the input fields

UC4 Parameter Reference

Encoder Types

Type	Description
CCr1	Relative mode 1 (1/127). Best for Ableton, Bitwig.
CCr2	Relative mode 2 (65/63). Alternative relative format.
CCAb	Absolute 7-bit CC. Standard 0-127 range.
PrGC	Program Change. Turn to increment/decrement.
CCAh	High-resolution 14-bit CC. Uses CC and CC+32.
Pbnd	Pitch Bend. Full -8192 to +8191 range.
AFtt	Channel Aftertouch.

Button Types

Type	Description
Note	Standard MIDI note on/off.
CC	Control Change message.
PrGC	Program Change on press.
AFtt	Channel Aftertouch.
Off	Button disabled.

Button Modes

Mode	Description
Momentary	Upper on press, Lower on release.
Toggle	Alternates between Upper and Lower.
Step	Increments through range.

Fader Types

Type	Description
CCAb	Absolute CC. Standard fader mode.
PrGC	Program Change across range.
Pbnd	Pitch Bend.
AFtt	Channel Aftertouch.

Getting More Help

[? Guide] button in editor → Opens this guide
HOWTO.md → Practical workflow examples
SPECIFICATION.md → Technical details
UC4 Manual → Official Faderfox documentation

UC4 SysEx Editor

Table of Contents

Quick Start

Interface Overview

Header Elements

Navigation Elements

Status Bar

Working with Files

SysEx Files (.syx)

JSON Files

Single Setup JSON

Navigating Setups & Groups

The UC4's Two-Domain System

Link Groups Toggle

Focused View — Detailed Editing

Section Order

Contextual Tooltips

Control Parameters

Overview Mode — See Everything

Tabs

Cell Format

Cell Interactions

Quick Copy/Paste — Rapid Configuration

Quick Paste Toolbar

Workflow

Channel/CC Multipliers

Scope Options

Visual Feedback

Keyboard Shortcuts

Setup Manager — Organize Your Setups

Opening Setup Manager

Setup Grid

Visual Indicators

Selection

Operations

Labels

Conflict Detection

Conflict Types

Understanding Conflicts

Filter Chips

Context Menu Copy & Paste

Copy Scopes

Paste Special Dialog

Undo, Redo & Reset

What's Tracked

Coalescing

Limits

Shortcuts

Session Persistence

How It Works

When Session Clears

Keyboard Shortcuts

Global

Overview Mode

Quick Paste

Workflow Examples

Create a Channel-Per-Group Setup

Sequential CCs Across a Row

Prepare Setups for Live Show

Validation & Troubleshooting

"Invalid file size" Error

Changes Don't Appear on UC4

Lost My Edits

Conflicts Everywhere

Quick Paste Not Working

Tooltips Not Showing

UC4 Parameter Reference

Encoder Types

Button Types

Button Modes

Fader Types

Getting More Help