---
title: Reference
description: Complete feature reference and troubleshooting guide
---

# Reference

Complete technical reference for Wing Tools, including all features, file formats and troubleshooting guidance.

## Supported Snapshot Formats

### File Format Specifications

Wing Tools parses Behringer Wing snapshot files.

| Extension | Format Version | Support Status  |
| --------- | -------------- | --------------- |
| `.snap`   | snapshot.9     | Fully supported |
| `.snap`   | snapshot.10    | Fully supported |
| `.snap`   | snapshot.11    | Fully supported |

**File structure**: file with mixer configuration data including:

- Input/output routing
- Channel configurations
- Bus and matrix assignments
- Effects settings
- Scene metadata

**Typical file size**: 300-500 KB for complex configurations

### Snapshot Version Detection

Wing Tools automatically detects snapshot version from the file metadata.

If an untested version is encountered, Wing Tools will:

1. Still attempt to parse the file
2. Display warning banner in PDF: "This snapshot version is untested"
3. Generate output with potentially incomplete data

## Input and Output Groups

### Physical Input Groups

| Group ID | Display Name | Description                      | Typical Channels |
| -------- | ------------ | -------------------------------- | ---------------- |
| LCL      | LCL          | Local physical inputs on mixer   | 8-24             |
| A        | AES50 A      | AES50 Port A (stage box)         | 48               |
| B        | AES50 B      | AES50 Port B (stage box)         | 48               |
| C        | AES50 C      | AES50 Port C (stage box)         | 48               |
| AUX      | AUX          | Auxiliary inputs                 | 8                |
| SC       | SC           | StageConnect protocol            | Variable         |
| USB      | USB          | USB audio interface              | 32               |
| CRD      | CRD          | Expansion card                   | Variable         |
| MOD      | MOD          | Modular expansion (DANTE, WAVES) | Variable         |
| USR      | USR          | User-defined virtual             | Variable         |
| OSC      | OSC          | Internal oscillators             | 2-4              |
| AES      | AES          | AES/EBU digital                  | Variable         |
| PLAY     | PLAY         | Playback channels                | Variable         |

### Physical Output Groups

Same as input groups, plus:

- Direct output patches (input → output without mixer processing)
- Mixer outputs (BUS, MTX, MAIN routed to physical outputs)

### Mixer Internal Groups

| Group | Description        | Count |
| ----- | ------------------ | ----- |
| CH    | Regular channels   | 40    |
| AUX   | Aux input channels | 8     |
| BUS   | Mix buses          | 16    |
| MTX   | Matrices           | 8     |
| MAIN  | Main outputs       | 4     |

## PDF Section Reference

### Section 1: Metadata Page

**Page orientation**: Portrait
**Content**:

```
Wing Routing Documentation
==========================

Mixer Information:
  Creator Name: WING-PP-14091119
  Creator Model: wing-rack
  Created: 2025-06-18 14:43:28
  Firmware Version: snapshot.10

Summary Statistics:
  Total Inputs: 152
  Total Outputs: 134
  Total Channels: 48
  Active Routes: 156
```

**Purpose**: Quick reference for snapshot identification and configuration scope

### Section 2: INPUTS (Sources)

**Page orientation**: Mixed (portrait for 8 or fewer items, landscape for more than 8 items)
**Layout**: 2-column landscape for large groups, single-column portrait for small groups

**Columns**:

| Column      | Width | Description                       |
| ----------- | ----- | --------------------------------- |
| Group       | 15mm  | Input group identifier            |
| Number      | 12mm  | Channel number (1-48)             |
| Source Name | 40mm  | User-assigned name                |
| Mode        | 12mm  | "ST" for stereo, blank for mono   |
| Gain (dB)   | 15mm  | Preamp gain setting               |
| +48V        | 12mm  | "ON" if phantom power enabled     |
| Used By     | 41mm  | Channels/outputs using this input |

**Special handling**:

- OSC inputs show "Waveform" and "Level" instead of "Gain" and "+48V"
- Empty cells for unused/unnamed inputs
- "Used By" truncated to 10 characters in Free tier
- OSC, AES, and PLAY groups kept together on single page

### Section 3: OUTPUTS (Physical)

**Page orientation**: Mixed (portrait for 8 or fewer items, landscape for more than 8 items)
**Layout**: 2-column landscape for large groups, single-column portrait for small groups

**Columns**:

| Column       | Width | Description                     |
| ------------ | ----- | ------------------------------- |
| Group        | 15mm  | Output group identifier         |
| Number       | 12mm  | Channel number                  |
| Type         | 15mm  | "Mixer" or "Direct"             |
| Connected To | 35mm  | Mixer output or input reference |
| Source Name  | 50mm  | Actual signal name              |

**Type values**:

- **Mixer**: Processed signal from BUS/MTX/MAIN
- **Direct**: Unprocessed signal from physical input
- **Blank**: Unpatched (connected to OFF.1)

### Section 4: CHANNELS

**Page orientation**: Portrait
**Layout**: Single-column table

**Columns**:

| Column          | Width | Description                          |
| --------------- | ----- | ------------------------------------ |
| Ch #            | 12mm  | Channel number (1-40) or aux (A1-A8) |
| Channel Name    | 35mm  | User-assigned channel name           |
| Active Src      | 25mm  | Currently selected input             |
| Active Src Name | 35mm  | Name of active input                 |
| Active Src Type | 20mm  | "MAIN" or "ALT"                      |
| Other Src       | 25mm  | Non-active alternate input           |
| Other Src Name  | 35mm  | Name of alternate input              |

**Channel ordering**:

1. Regular channels (1-40) in numeric order
2. Aux channels (A1-A8) after regular channels

### Section 5: ROUTING TABLE (Active Routes)

**Status**: Currently disabled by default
**Page orientation**: Portrait when enabled
**Layout**: Single-column table

**Columns**:

| Column       | Description                             |
| ------------ | --------------------------------------- |
| Ch #         | Source channel number                   |
| Channel Name | User-assigned channel name              |
| Output Type  | "Main", "Bus", or "Matrix"              |
| Out #        | Output number                           |
| Output Name  | User-assigned output name               |
| Pre/Post     | Pre-fader or post-fader send (optional) |

### Premium/Pro Sections

Available with Premium or Pro subscription:

**Signal Flow Diagram** (Premium):

- Interactive visual diagram
- Three-layer layout (Physical Inputs → Mixer → Physical Outputs)
- Aggregated connections with /N notation
- See [Signal Flow](05-signal-flow.md) for details

**Routing Matrix** (Premium):

- Four matrices: Input→Channel, Sources→Outputs, Mixer→Physical, Direct
- Circle/gray/text display modes
- Row/column omission for compact output
- See [Routing Generator](04-routing-generator.md#routing-matrix-premium) for details

**Pre/Post Fader Details** (Pro):

- Expanded routing table
- All send configurations
- Level information

**Advanced Channel Config** (Pro):

- Insert points
- Channel linking
- DCA assignments
- Mute groups

**Snapshot Linter** (Premium):

- 25+ automated analysis rules
- Four severity levels (Critical, Error, Warning, Info)
- Channel type auto-detection
- Custom linter configurations
- AI-powered analysis with contextual insights
- See [Snapshot Linter](10-snapshot-linter.md) for details

**Multi-Mixer Signal Flow** (Pro):

- Multi-console signal visualization
- AES50/StageConnect topology definition
- Cross-mixer signal tracing
- See [Multi-Mixer Signal Flow](12-multi-mixer-flow.md) for details

**Source Management** (Basic):

- Remap physical input source properties between I/O groups
- CopyTable with per-property control (gain, phantom, name, color, etc.)
- Channel reference and direct patch reference auto-updates
- See [Source Management](13-source-management.md) for details

**Snapshot Generator** (Pro):

- Create WING snapshots from Excel or PDF channel lists
- 4-step wizard: Upload, Channels, Monitors, Generate
- Per-channel source assignment with auto-fill from a main source group
- Drag-and-drop channel reordering, stereo pair visualization
- Template snapshot support for preserving EQ, dynamics, and FX
- Session recovery and Ctrl+Z undo
- See [Snapshot Generator](14-snapshot-generator.md) for details

## Troubleshooting

### Upload Issues

#### Error: "Only .snap files allowed"

**Cause**: File doesn't have `.snap` extension

**Solutions**:

1. Verify file has `.snap` extension
2. If file is named `snapshot.10`, rename to `snapshot.snap.10` or `snapshot.snap`
3. Don't upload compressed files (.zip, .tar.gz) - extract first

#### Error: "File size exceeds limit"

**Cause**: File larger than tier allows

**Solutions**:

1. Check your tier's file size limit (5 MB Free, 10 MB Premium, 25 MB Pro)
2. If file is legitimately large, upgrade to higher tier
3. If file seems unusually large, try re-exporting from Wing console
4. Verify file isn't corrupted or contains unexpected data

#### Error: "Rate limit exceeded"

**Cause**: Too many uploads in the time period

**Solutions**:

1. Wait until tomorrow (limits reset at midnight UTC)
2. Upgrade to higher tier for more uploads
3. Use CLI tool for local processing (no upload limits)

#### Upload Progress Stuck

**Cause**: Network issue or large file

**Solutions**:

1. Check internet connection
2. Try refreshing page and uploading again
3. Try different browser
4. For large files, be patient - may take 30-60 seconds
5. If consistently failing, try CLI tool for local processing

### PDF Generation Issues

#### PDF is Blank or Missing Sections

**Cause**: Snapshot file corrupted or invalid format

**Solutions**:

1. Re-export snapshot from Wing console
2. Verify snapshot opens correctly in Wing Edit app
3. Try exporting different scene from Wing
4. Contact support with snapshot file (Premium/Pro)

#### Wrong Information in PDF

**Cause**: Snapshot doesn't match current console state

**Solutions**:

1. Verify you uploaded the correct snapshot file
2. Check snapshot creation date in PDF metadata
3. Ensure you saved scene to snapshot before exporting
4. Re-export snapshot and try again

#### PDF Shows "Untested Version" Warning

**Cause**: Snapshot format version not explicitly tested

**Solutions**:

1. Update Wing firmware to latest version
2. PDF will still be generated with available data
3. Report any issues to support (Premium/Pro)
4. Warning is informational only - most features should work

#### Missing Input/Output Names

**Cause**: Names not assigned in Wing console

**Solutions**:

1. This is normal - Wing Tools shows ALL inputs/outputs including unnamed
2. Use empty PDF for manual note-taking
3. Assign names in Wing console and re-export
4. Premium users can use Source Name Replacement hack

### Signal Flow Issues (Premium)

#### Diagram Won't Load

**Cause**: Browser compatibility or network issue

**Solutions**:

1. Try different browser (Chrome/Firefox recommended)
2. Clear browser cache
3. Check browser console for errors (F12 key)
4. Disable browser extensions temporarily
5. Contact support with error details

#### Connections Appear Incorrect

**Cause**: Complex routing or direct patches

**Solutions**:

1. Toggle filter modes (Show Everything / Direct Only / Hide Direct)
2. Zoom in to see individual connections
3. Hover over connections for details
4. Cross-reference with PDF OUTPUTS section
5. Verify console routing matches expectations

#### Too Many Elements

**Cause**: Large configuration with many routes

**Solutions**:

1. Use filter modes to focus on specific routing types
2. Zoom to specific areas of interest
3. Generate routing matrix for tabular view
4. Use PDF for complete documentation

### Routing Matrix Issues (Premium)

#### Matrix Pages are Blank

**Cause**: No active routes in configuration

**Solutions**:

1. Verify snapshot has routing configured
2. Check that buses/matrices are actually assigned
3. Try disabling "active only" mode
4. Verify console has sends configured

#### Too Many Omitted Rows/Columns

**Cause**: Sparse routing configuration

**Solutions**:

1. This is intentional - keeps PDFs compact
2. Only active routes are shown by default
3. Disable `--matrix-active-only` to see all
4. Omission notes show what was omitted

#### Can't Read Matrix Labels

**Cause**: Too many items for page size

**Solutions**:

1. Matrix automatically spans multiple pages if needed
2. Increase zoom level when viewing PDF
3. Consider using text mode instead of circle mode
4. Print on larger paper (A3) if available

### Account and Billing Issues

#### Can't Log In

**Cause**: Incorrect credentials or unverified email

**Solutions**:

1. Verify email address is correct
2. Use "Forgot Password" if needed
3. Check spam folder for verification email
4. Ensure account is verified (check email for verification link)
5. Clear browser cookies and try again

#### Payment Failed

**Cause**: Card declined or insufficient funds

**Solutions**:

1. Verify card details are correct
2. Check with your bank
3. Try different payment method
4. Ensure billing address matches card
5. Contact support if issue persists

#### Features Not Activating After Upgrade

**Cause**: Payment processing delay or cache issue

**Solutions**:

1. Wait 5-10 minutes for payment to process
2. Log out and log back in
3. Clear browser cache
4. Verify payment was successful (check email receipt)
5. Contact support with payment receipt

#### Can't Download Previous Files

**Cause**: Files expired or storage limit exceeded

**Solutions**:

1. Check file expiration date (30 days after upload for Free tier)
2. Verify you haven't exceeded storage quota
3. Files deleted after cancellation (30-day grace period)
4. Re-upload snapshot if file was deleted

## Technical Specifications

### Browser Requirements

**Supported browsers**:

- Chrome 90+
- Firefox 88+
- Safari 14+
- Edge 90+

**Not supported**:

- Internet Explorer (any version)
- Opera Mini
- Browsers with JavaScript disabled

**Required features**:

- JavaScript enabled
- Cookies enabled (for authentication)
- LocalStorage enabled
- File upload API support

## Glossary

**AES50**: Digital audio protocol used by Behringer/Midas for stage box connections (48 channels per port)

**Alternate Source**: Secondary input assignment for a channel, switchable via console

**Bus**: Mixer output used for aux sends, monitor mixes, or subgroups (16 total on Wing)

**Channel**: Mixer input strip with processing (40 regular + 8 aux on Wing)

**CLI**: Command-Line Interface - text-based program for local snapshot processing

**Direct Patch**: Signal routing that bypasses mixer processing (input → output)

**Matrix**: Secondary output mixer fed by buses and mains (8 total on Wing)

**Pre-fader Send**: Signal taken before channel fader (level independent of fader)

**Post-fader Send**: Signal taken after channel fader (level follows fader)

**Scene**: Saved mixer state including all routing, levels, and processing

**Snapshot**: Exported scene file in `.snap` format

**Stage Box**: Remote preamp unit connected via AES50 (e.g., S16, S32)

**Source Management**: Tool for remapping input source properties between I/O groups

**Snapshot Generator**: Tool for creating WING snapshots from Excel/PDF channel lists

**Tier**: Subscription level (Free, Basic, Premium, Pro) with different feature access

## Support Resources

### Documentation

- **User Manual Home**: [index.md](index.md)
- **Getting Started**: [01-getting-started.md](01-getting-started.md)
- **My Files**: [02-my-files.md](02-my-files.md)
- **Projects**: [03-projects.md](03-projects.md)
- **Routing Generator**: [04-routing-generator.md](04-routing-generator.md)
- **Signal Flow**: [05-signal-flow.md](05-signal-flow.md)
- **Routing Diff**: [06-routing-diff.md](06-routing-diff.md)
- **Account Management**: [07-account-management.md](07-account-management.md)
- **Audio Engineer Guide**: [08-audio-engineer-guide.md](08-audio-engineer-guide.md)
- **Snapshot Linter**: [10-snapshot-linter.md](10-snapshot-linter.md)
- **Source Tags**: [11-source-tags.md](11-source-tags.md)
- **Multi-Mixer Signal Flow**: [12-multi-mixer-flow.md](12-multi-mixer-flow.md)
- **Source Management**: [13-source-management.md](13-source-management.md)
- **Snapshot Generator**: [14-snapshot-generator.md](14-snapshot-generator.md)

### Contact Support

**Free Tier**: Self-service documentation only
**Premium Tier**: support@theta-tontechnik.de (24-48 hour response)
**Pro Tier**: support@theta-tontechnik.de (12-24 hour priority response)

**When contacting support, include**:

1. Your account email
2. Tier level (Free/Premium/Pro)
3. Detailed description of issue
4. Steps to reproduce
5. Browser/OS version (for web issues)
6. Snapshot file (if upload/processing issue)
7. Error messages (exact text or screenshot)

### External Resources

- **Behringer Wing Manual**: Official console documentation
- **Wing Edit Software**: Console control and scene management
- **Wing Firmware Updates**: Latest firmware from Behringer/Music Tribe

---

**End of Reference Documentation**