Logs & Console
MetaServer's log output is your primary diagnostic tool for connection issues, MIDI routing, macro execution, and command processing. The presentation differs by platform — Mac uses the integrated Logs page, Windows uses a separate Console window — but both surface the same underlying log stream.
Opening the Logs
Mac
Open MetaServer and select Logs in the sidebar. Logs are an integrated page in the main window.
Windows
Right-click the MetaServer icon in the system tray and select Console. The Console opens as its own window and can stay open alongside the Setup window.
Reading the Log
Each entry has a timestamp, severity level, category (source of the message), and the message itself.
| Level | Meaning |
|---|---|
| Error (E) | Critical failures — MIDI port mapping problems, USB disconnections, unrecognised packet types |
| Warning (W) | Potential problems that didn't stop execution |
| Info (I) | Standard operational messages — device connections, file path confirmations |
| Debug (D) | Detailed diagnostic output |
| Trace (T) | Maximum verbosity, including raw network data |
Error rows are tinted red and warning rows are tinted yellow for visibility.
Mac only: The Logs page auto-scrolls as new entries arrive. Scroll up to pause auto-scroll and review earlier messages.
Logging Level (Mac)
Set the logging level in the settings card at the top of the Logs page. Use Info for normal operation. Switch to Debug or Trace only when troubleshooting a specific issue — they generate high volumes of output.
Windows logs at a fixed level today; severity filtering happens via the Lvl column (I / E).
Filtering (Mac)
The Logs page exposes four filter mechanisms:
- Level filter — dropdown that limits entries by severity. Selecting Info+ shows Info, Warning, and Error.
- Category filter — toggle Application, Network, Devices, Automation, or MIDI independently.
- Error / Warning indicators — counters in the toolbar. Tap one to filter to that level only; tap again to clear.
- Search — case-insensitive text match against the message and category columns.
All filters combine with AND logic — only entries matching every active filter are shown.
Windows shows all entries in the Console without filtering. Use the OS-level Find shortcut (
Ctrl + Fif your terminal-style window supports it) to search.
Sending Logs to Support
Mac
- Click Send to Support in the bottom-right corner of the Logs page. MetaServer creates a zip archive of all log files.
- Your default mail app opens with a pre-filled message and the log archive attached. Add a description and send.
If no mail app is configured, MetaServer reveals the log files in Finder so you can attach them manually.
Windows
Logs are written to MetaServer's data directory. Reach out to support and they'll guide you to the right files to attach.