Logs

The Logs window shows a running record of what Cliqer is doing: sign-in, the room, cameras and devices, Studio, outputs and your key, MIDI and OSC input. It is the first place to look when something does not behave, and the file to attach when you contact support.

Open the window

On macOS:

• Help > Show Logs
• Window > Show Control Monitor, which opens Logs already filtered to your control input (see Control Monitor)
• Settings > Advanced > Troubleshoot, Logs row: Show Logs. Reveal Logs next to it shows the log file in Finder.

Windows:

• The menu bar: Help > Show Logs and Window > Show Control Monitor
• The More menu of a page's command bar: Logs and Show Control Monitor
• The Settings menu in the Studio top bar: Logs... and Show Control Monitor
• Settings > Advanced > Troubleshoot, Logs row: Show logs and Show control monitor

On macOS the window opens at 900 by 520 points. It has no keyboard shortcut of its own, because keys belong to External Control.

What is in the log

Cliqer writes one log. The app, the engine that runs rooms and Studio, and the libraries it uses all write to it, so you read one list in time order.

Secrets are removed before a line is stored, so the window, the file and every export are already clean.

Levels

Pick a Level to see that level and everything more severe.

Each line shows its level as a symbol and a word, never by colour alone.

Areas

Use Areas to look at one part of the app. The button reads All Areas, the area name, or " Areas". You can tick several. Ticking All Areas clears the selection.

The window

Toolbar

Windows: the bar has Level, Areas (the button reads All areas, the area name, or " areas"), Search logs, and Pause or Resume, Clear View, Copy (Ctrl+C), Export and Open Log Folder, which opens File Explorer with the log file selected. Search also matches the level. Ctrl+A selects every line and Escape clears the selection. An empty list says "No log lines at this level and area yet.", or "No line matches the search." while you search.

Table

Columns: Time, Level, Area, Message. The time is your local time with milliseconds. The message is one line; hover to read it in full. The table follows the newest line until you scroll up, and follows again when you scroll back to the bottom. You can select several lines.

Windows: the time column is headed Time (UTC) and shows UTC.

The bottom bar says " lines", or " of lines" when a search narrows the list, then ", selected". Paused shows while paused. On Windows it says " lines", then ", selected" and ", paused".

The window holds up to 10,000 lines. Older lines drop out of the window, but not out of the file.

Open and close

Cliqer only sends lines to the window while it is on screen. Closing or minimising it stops and empties the view; showing it again reads the log from the start and ends any Clear View.

Copy and export

On macOS, a copied or exported line looks like this:

2026-10-08 03:14:15.926  Info     Studio   message

• Visible Lines... saves the lines you see, after your level, area and search filters, as a .log text file.
• Log File... saves a copy of the current log file as it is on disk. It is off when there is no log file yet.
• Both open a save panel with the name Cliqer-<date and time>.log.

Windows: Export saves the lines shown as a text file named cliqer-log-<date>.txt, and there is no Log File... choice. A line reads 2026-10-08 12:34:56.789Z WARN Rtc message (UTC, level in capitals), and a message of several lines continues on indented lines.

The log file is named cliqer.log. It rotates at 5 MB, and Cliqer keeps 5 files.

What is removed

Cliqer removes these before a line is stored:

Control Monitor

Window > Show Control Monitor opens Logs with Areas set to Control and Level set to Debug. It lists each key press, MIDI message and OSC message Cliqer sees and what it did with it, or that no binding matched. Use it to find out why a control does nothing. The lines use developer wording, such as key names and action ids. On Windows, Show Control Monitor is in the places listed under Open the window, and it resumes a paused list.

Send logs to support

1. Open Logs.
2. If the problem is about one area, tick it; otherwise leave All Areas.
3. Choose Export > Log File... and save it.
4. Send the file to support.

Windows: choose Export and save the lines shown, or choose Open Log Folder and send cliqer.log from it.

Related