Settings
Open Settings with SessionHUD ▸ Settings… (⌘,). It has six tabs: General, Recording, Take Sheet, Session Controls, Browser & API and Virtual Camera. This page also covers the power buttons and the license. In the app, hover a setting or click its ⓘ for more.
Settings ▸ General
Appearance
System, Light or Dark (the default), for SessionHUD’s own windows and menus. System follows macOS, including its automatic switch. Each layout keeps the profile you chose for it.
Show menu bar icon
On by default. Off, SessionHUD is in the Dock only; right-click its Dock icon for the same status line and every output’s power. The Dock icon and the menu bar icon are never both off: this checkbox is unavailable while the Dock icon is off, so turn on Show Dock Icon first.
Keep running in the menu bar when quit with ⌘Q
Off by default. On, ⌘Q closes SessionHUD’s windows and its Dock icon and leaves every output running, with SessionHUD in the menu bar; the app menu names it Keep Running in Menu Bar. Choose Designer in the menu bar to bring the windows back. To quit, choose Quit SessionHUD in the menu bar or press ⌥⌘Q. It needs the menu bar icon: while Show menu bar icon is off, ⌘Q quits.
Show tips
On by default. Tips are short cards beside what they explain. The first time the Designer opens, four of them introduce it one at a time: the power buttons, the canvas, the Layouts panel and the take sheet button. The take sheet shows how it works until this Mac has logged its first take. A card never appears while a take is recording, and never on an output. Next or Got It puts a card away; Hide Tips on any card turns them all off. Show Tips Again, beside this setting, brings back every card you put away. After an update from an earlier version you see only the cards about what is new.
Reading an output
Show sample values until Pro Tools connects (on by default): lets you judge a layout at full size on its screen before Pro Tools connects. The browser viewer never shows sample values. More about sample values.
When Pro Tools disconnects (Keep Last Values by default): what every output shows once Pro Tools quits, crashes or drops. Keep Last Values leaves the last values on screen, dimmed, so the take number is still readable. Show Dashes blanks every output and the API instead. Running timecode keeps going either way.
Hold changes until Update
On by default. While an output is on, a change you make to it in the Designer waits: picking a different layout, or editing the one it shows, changes the canvas and not the screen. More about held changes. Off, changes reach the output as you make them.
Background follows transport
The colors Background follows transport uses, for every output at once. Recording offers Deep Red, Signal Red (the default) and Bright Red; Playing offers Deep Green, Signal Green (the default) and Bright Green. The Bright shades use black text. A preview under the menus shows both.
Solid background while recording or playing (on by default): draws the red or green at full strength, even on an output whose background opacity is lower. When stopped, the output’s own opacity applies.
Each layout turns Background follows transport on for itself, in the Inspector’s Appearance section (select Appearance at the top of the Elements list), or for a HUD on the camera, in that HUD’s Inspector. The ⓘ beside the heading says the same.
Updates
Check for updates automatically is on by default. SessionHUD always asks before installing anything, and the check sends nothing about your Mac, your sessions or your license. The Check for Updates… button under it looks now; the same item is in the SessionHUD menu.
Settings ▸ Take Sheet
Which take sheet setup new sessions start from, and what holds for every take sheet on this Mac. A sheet’s columns, grouping, look, details and logging are its own, set on the sheet in Sheet Settings, where you see the change as you make it, and saved to a setup from there. Each group’s ⓘ explains it.

New Sessions: Setup is the setup a session’s first sheet starts from, Standard until you choose another. It changes no sheet that already exists, or its exports. Setups are made, renamed and deleted on the take sheet, from Sheet Settings.
Three switches act when there may be no sheet yet, and hold for every session. Start a sheet at a session’s first take (on by default): off, takes are logged only once you press New Sheet. Open the take sheet with the session: when SessionHUD sees a session for the first time, its take sheet window opens by itself whenever that session opens in Pro Tools. Each session can change this afterwards with Open with session, under This Session in Sheet Settings. Offer a new sheet on a later day (on by default) asks before a later day’s first take.
Look: Select color and Alt color are the colors of the marks on take numbers and letters, on the sheet and in its PDFs. They are SessionHUD blue and magenta unless you choose. A select is filled with its color, with white or black lettering, whichever reads better; an alt is a ring of its color around a letter left as it was. A color that is hard to see on a light or a dark sheet says so under it. Default puts back the blue or magenta; Ink draws the mark in black, or white in dark mode, for a sheet printed in black and white.
Turn off Outline unmarked take numbers or Outline unmarked letters to draw a take number or a letter bare until it is a select, an alt or struck out. It stays where it was, and a click still marks it. A PDF never outlines an unmarked one. Show gridlines draws a line between every column.
Turn on Square alt letters to outline an alt letter in a rounded square instead of a circle, so an alt differs from a select in shape as well as color. It applies on the take sheet, its PDFs, the Letters line in Session Controls and a Take Log on an output. A take number is a box already, so an alt take number doesn’t change.
Letters: Show − + in Letters puts the buttons beside each take’s letters; off, click after the letters to add one. Right-click after the letters removes the last one; off, a right-click there opens the take’s menu, which has Remove Letter.
Exports: Folder is where saving an export starts: each session’s Bounced Files folder, or the session’s own folder until Pro Tools has made one. Choose… picks one folder for every export instead, and Use Bounced Files goes back. A chosen folder that is not there today, on a drive not connected, falls back to Bounced Files.
Your Studio name and a Logo go at the top of every take sheet’s PDF, the logo above the name. Choose… takes any image; a PNG with a transparent background prints cleanest. Remove takes the logo off. Under Header, an export places them right, left or centered, sizes the logo, or leaves them off. Branding comes with a license, not the evaluation: during the evaluation they can’t be set, and no PDF prints them.
Settings ▸ Session Controls
Choose what the Session Controls window shows, so it holds only what you use. Everything is shown until you change it.
Sections: Show Metadata, with a box for each of its fields, and Show Countdown.
Take number size: Regular or Large, for the number beside the track name.
Show transport state: the line that says what Pro Tools is doing. It is on by default and only reads, so it works with or without New Take and Stop.
A section or field you leave out comes back by itself while it is in use: a field with text in it, or a running countdown. That way you can always clear a name or stop a countdown from this window. Its row in Settings says when this is why it is still showing. Output buttons don’t come back; their outputs are turned off from the Designer or either menu.
The New Take, Stop and Play Last Take buttons and the Letters card in this window are placed from Settings ▸ Commands, beside each command’s own settings.
Settings ▸ Commands
Every command in SessionHUD that changes Pro Tools is set up here, and only here: New Take and Stop, Play Last Take, and the letters. Each one’s Show in row has a box for each place it can be pressed, Session Controls and the take sheet, so a command can be on one and not the other. A command with neither box ticked is off, and none of them sends anything to Pro Tools until you press it.
New Take and Stop: two buttons that stop and start Pro Tools. Show in puts them in Session Controls, on the take sheet, or both. Both start ticked; untick both to take the buttons away.
Start each take where the last one ends (off until you turn it on): New Take records after the last take on the armed tracks, even if you’ve played back or scrubbed elsewhere in the session since, or Insertion Follows Playback is off in Pro Tools. It moves the cursor there first, and only when it isn’t there already, so with nothing to move New Take is no slower. Pressed during a take, it waits for that take to reach the timeline. If the end can’t be found, no take starts and the line under the buttons says so; a first take, on empty tracks, starts at the cursor. While Insertion Follows Playback is off, a line under the setting says so. SessionHUD only reads that setting; it never changes it.
Play Last Take: a button that plays the last take back through Pro Tools. It is off until you tick a box under Show in, and when you press it, SessionHUD moves the selection in Pro Tools. How it plays is Play in place, or Copy to a track, then play, which also adds the take to the track chosen under Copy to: Track above the take’s, Track below the take’s, or a track by name: one of the open session’s audio tracks from the menu, or any name typed under Track name, for a session that isn’t open. A name finds its track whatever the capitals, so playback finds Playback; if two tracks differ only in capitals, choose one from the menu. A name the open session doesn’t have is kept, and listed under Not in this session. Under the name, a line says whether the open session has the track and whether a take can be copied to it: an audio track, not armed, and mono or stereo like the take’s track (or the armed track, before there is a take). A right-click on the button switches how it plays too.
When the open session has no track by the name you chose, the line under Track name says so, and so does the Play Last Take button (Play Last Take · No “Playback” Track). Add “Playback” to Session adds it: one audio track by that name, right below the take’s track and mono or stereo to match it, so the copy fits. Pro Tools has to be stopped. It adds that one track and nothing else, and only when you press it.
Turn off input monitoring for playback (on until you turn it off, and shown with Play in place): a take’s track with its input monitoring button on would play the booth, not the take, so SessionHUD turns that button off just before the take plays and back on when it stops, before New Take can record. While it is off, the Play Last Take button reads Playing · Input Monitoring Off and the line on the take sheet names the track. Only the take’s track and only its own button are touched (more). Turn it off and SessionHUD never touches input monitoring; a take whose track is monitoring its input then isn’t played, and the line says why.
Copy takes automatically when the transport stops (off until you turn it on, and only with Copy to a track, then play) copies every take to the Copy to track as soon as it stops, with or without the Play Last Take button, so the playback track always holds the last take. To turn it on and off mid-session without opening Settings, use the copy button beside Play Last Take in Session Controls; it is the same switch. New Take is never slower for it: the copy waits until the next take is recording, and gives way to any press. After a plain stop it copies straight away and puts your cursor back where it was. While recording, it copies only with Insertion Follows Playback on in Pro Tools, which puts the cursor right when you stop; with it off, the copy waits until you stop. If a take can’t be copied, the line under New Take and Stop says why.
Letters: Show in Session Controls adds the Letters card, for adding and marking the letters of the take being recorded, or the last take, from that window. It is off by default, and hidden while the take sheet hides its Letters column. On the take sheet, the letters are that column, chosen for each sheet in its Sheet Settings under Columns. Whether a letter also writes a marker in Pro Tools is each sheet’s choice, under Pro Tools Markers.
Mark letters from Session Controls (on by default): click a letter on the card for a select, right-click for an alt, Command-click to strike it out, as on the take sheet. Turn it off and the letters are only shown, so a stray click beside Pro Tools marks nothing; − + still add and remove them.
Settings ▸ Browser & API
The browser page and the API share these settings. Turning the page on and off is the Browser power button, not a setting here. More in Features ▸ Browser Viewer and the API reference. The layout the page shows is picked in the Browser Viewer designer’s Layouts list.
- Reachable from: Local network (the default) lets a phone, tablet or laptop on the same network open the page and the API. It applies only while the Browser button is on; with it off, the API answers on this Mac only. This Mac only keeps both on this Mac. Changing from This Mac only to Local network asks you to confirm.
- Port: 7373 unless you change it.
- Links: the Page and API addresses, each with a copy button. While the Browser button is off, the Page row says so instead of giving an address.
Settings ▸ Virtual Camera
Setup and day-to-day use are in the Virtual camera guide.
- Install Camera Extension…: shown until the camera is installed. Pressing the Camera button does the same. macOS asks you to allow it in System Settings. To take it out again, use Remove Camera Extension… in File ▸ Diagnostics….
- Output format: 720p · 30 fps (the default) or 1080p · 30 fps. A change takes effect once the apps watching the camera let go of it.
- Name in other apps: what Zoom, Teams and other apps call the camera (SessionHUD).
- Standby Mode (on by default): while the camera is off, an app that still has it open sees the Standby Layout, one of the Full-Screen Display’s layouts. Standby caption (on by default) puts a word of up to 16 characters above it, STANDBY unless you type another. More about Standby.
- Show elements while off (on by default, shown while Standby Mode is off): keeps the camera layout’s elements over the Camera off card; off, the app sees the card alone.
Once the camera is installed, a Preview shows what apps using it see. The source camera is not chosen here: pick it on the Camera element in the camera’s designer, or in the Camera power button’s menu.
Power buttons
One button per output at the bottom of the Designer. ⌃⌘1–⌃⌘4 turn them on and off; ⌘1–⌘4 open an output’s designer without changing what anyone sees. The arrow beside each button, or a right-click on it, opens that output’s menu:
- Layout: which layout the output shows. On the camera this is its Camera Layout, followed by Camera (which camera on the Mac shows the room, or None), Standby Mode and the Standby Layout.
- Display: Full-Screen only. Which monitor it fills.
- Click-through: HUD Window only. Clicks pass through the HUD to Pro Tools underneath. Turn it off to drag the HUD. Full-Screen always lets clicks through.
- Show only while recording: HUD Window and Full-Screen. Hides the output between takes.
- Always on top: HUD Window only, on by default. Keeps the HUD above Pro Tools and every other window. Turn it off to let Zoom, Teams or Meet offer the HUD as a window to share; they leave always-on-top windows out of their pickers. Sharing your whole screen shows the HUD either way, and the virtual camera is the usual way to put it in a call.
- Design… opens the output’s designer, and on Browser and Camera, Settings… opens its Settings tab.
Outputs menu
The same power switches are in the Outputs menu, with Turn Off Full-Screen Now (⇧⌘F) while Full-Screen is on. The View menu opens each output’s designer. Help ▸ SessionHUD Help (⌘?) opens this manual.
Elsewhere in the app
The license and the Dock icon are set outside the Settings window.
License
The license is in its own window, SessionHUD ▸ License….
- Moving to another Mac: choose Release This Mac… on the old Mac, then activate the new one with the same serial. A Mac is released from here, not from your account page; the account page revokes a lost or stolen Mac instead (once a year, and it replaces your serial).
- Releasing a Mac that is offline: on a subscription, if Release This Mac… cannot reach the license service, choose Release Offline. SessionHUD removes the license and shows a code; enter it on your account page, from any device, to free the Mac. A perpetual license is released online only: connect the Mac and try again, or, if it can’t go online again, revoke it from your account page.
- Working offline: a perpetual license keeps working offline. A subscription works offline for up to 30 days, and not past the month or year you have paid for (a few days more while a renewal goes through); it warns you in the last seven.
Show Dock Icon
In the status menu, not in Settings. Off, SessionHUD also has no app menus (File, Outputs, View…) at the top of the screen. Turn the icon back on from the status menu. The status menu is there only while the menu bar icon is, so the Dock icon can’t be turned off while Show menu bar icon is off.
Stuck? Support · Getting started.