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.

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

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

Supported Hardware Devices

StageConnect Devices

The following StageConnect stageboxes can be configured in Device Labels and the Project Editor:

Beta notice: StageConnect device support is currently in Beta. Specifications are based on documentation and have not yet been verified against physical hardware. Device parameters (channel counts, capabilities) may change in a future update once hardware testing is complete.

AES50 Stage Boxes

AES50 stage boxes (S16, S32, DL16, DL32) are fully supported. See the Multi Device Signal Flow documentation for AES50 topology configuration.

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:

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:

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:

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:

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 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 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 for details

Multi Device Signal Flow (Pro):

• Multi-console signal visualization
• AES50/StageConnect topology definition
• Cross-mixer signal tracing
• See Multi Device Signal Flow 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 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 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
• Getting Started: 01-getting-started.md
• My Files: 02-my-files.md
• Projects: 03-projects.md
• Routing Generator: 04-routing-generator.md
• Signal Flow: 05-signal-flow.md
• Routing Diff: 06-routing-diff.md
• Account Management: 07-account-management.md
• Audio Engineer Guide: 08-audio-engineer-guide.md
• Snapshot Linter: 10-snapshot-linter.md
• Source Tags: 11-source-tags.md
• Multi Device Signal Flow: 12-multi-mixer-flow.md
• Source Management: 13-source-management.md
• Snapshot Generator: 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