Getting started
SessionHUD sits beside Pro Tools and shows the take number that is recording right now. This page gets you from download to a number on the desk.
What you need
- macOS 15 or later
- Pro Tools 2023.9 or later
- SessionHUD downloaded from sessionhud.com
- A network connection for a moment when you start the 14-day evaluation
Install
- Download SessionHUD from sessionhud.com/download. If you have bought a license, the same file is linked from your purchase email and your account page.
- Move SessionHUD to Applications and open it. The first time, macOS asks whether you want to open an app downloaded from the internet. Choose Open. If it says instead that it can’t check the app for malicious software, or that the app is damaged, that copy is not ours: download it again from sessionhud.com.
That is the whole install. Nothing goes into Pro Tools: no plug-in, no session template, nothing inside your sessions.
Your 14-day evaluation
The fourteen days begin when you choose Start Evaluation in the Designer, not when you install, so you can set SessionHUD up days before the project you want to try it on and start the evaluation when the project does. Starting needs the Mac to be online for a moment; if it can’t connect, the Designer says so and you can press the button again. Each Mac gets one evaluation.
- Every output works, with the built-in presets.
- Each output has an Evaluation Layout to design: start it blank, or right-click a preset and choose Duplicate to Evaluation Layout. The presets themselves stay as they shipped.
- The days left are shown above the canvas and in the status menu.
When the evaluation ends, the outputs stop until you add a license. If you are recording at that moment, everything stays up until you stop. Your layouts and settings are kept.
A license keeps the outputs running and unlocks the whole layout designer (as many layouts as you like, and editing the presets) and your own logo. If you already have one, choose SessionHUD ▸ License… and type in its serial number. Buying a license, moving it to a new Mac and recovering a serial number are on Support.
Connect to Pro Tools
Leave Pro Tools running with a session open. SessionHUD connects on this Mac only, and there is no setting to change in Pro Tools. If it cannot see Pro Tools, confirm Pro Tools is running with the session open; Diagnostics lists the connection and says why it is up or down.
The take number comes from the folders Pro Tools records into, which SessionHUD reads. If your sessions are in Documents, on the Desktop or on an external drive, macOS asks once whether SessionHUD may read that folder. Allow it, or the take number stays a dash.
If you chose Don’t Allow, open System Settings ▸ Privacy & Security ▸ Files & Folders, find SessionHUD and turn on the location your sessions are in: Documents Folder, Desktop Folder, Removable Volumes for an external drive, or Network Volumes for a server. Then quit and reopen SessionHUD.
Your first take
- Open SessionHUD. The Designer is the output workspace: one canvas for the output you have selected. Settings is in the SessionHUD menu (⌘,).
- Every output starts off, so nothing appears on screen until you ask for it. Press the HUD button at the bottom of the Designer to put a floating panel over Pro Tools. It reads HUD On or HUD Off and turns it on and off; so do ⌃⌘1 and HUD Window in the status menu.
- Arm a track and record. SessionHUD watches the file Pro Tools creates and puts that take number on the panel.
The pass is also on the take sheet, which logs every take as you record. Open it with File ▸ Take Sheet… (⌥⌘T) to mark selects and alts, tag takes, type the script line and export the sheet. See Your first take sheet. Choose the Take Log preset in the Designer to show those marks on an output.

Until Pro Tools first connects, the HUD window, the full-screen display and the virtual camera show sample values, so you can judge a layout at real size. The browser viewer never does. Turn it off in Settings ▸ General with Show sample values until Pro Tools connects.

Optional setup
The other three outputs each have their own power button. A few things take a moment of setup first:
- Running timecode: in Pro Tools, open Setup ▸ Peripherals ▸ Synchronization and set MTC Generator Port to SessionHUD MTC (under Predefined), then turn on GEN MTC in the Synchronization controls and press play. See Features ▸ MTC timecode.
- The browser viewer on other devices: turn on the Browser button, then copy the Page link from Settings ▸ Browser & API ▸ Links and open it on any phone, tablet or computer on the same network. If macOS asks whether SessionHUD may accept incoming connections, choose Allow. See Features ▸ Browser Viewer.
- The virtual camera: press the Camera button; the first press installs the camera extension, and macOS asks you to allow it. See the Virtual camera guide.
The Designer

- Outputs: pick the output you are designing for. The dot beside each says what it is doing: purple-to-blue means it is on, in the colors of its lit power button; half-filled amber means it is on but waiting, for example set to show only while recording; a red ! means it is not running; an eye means the camera is off but an app is still watching it; an amber circular arrow means SessionHUD has to reopen before it can use the camera. No dot means off.
- Canvas: the selected output’s layout, drawn the way that output draws it. The strip under it sets the layout’s size (W × H) and has Fit to Content, the grid, Undo and Redo, and a button that opens the canvas in a larger window.
- Layouts: your own layouts, then the built-in presets.
- Elements: Appearance first (the layout’s color profile, typeface, border and background), then everything in the layout, front to back.
- Inspector: settings for whatever is selected in Elements (an element’s text and look or, with Appearance selected, the whole layout’s look).
- Status: the armed track SessionHUD counts takes on, or whether Pro Tools is connected. While recording, hover it for the take and how sure SessionHUD is of it. With more than one track armed, it becomes the Track menu, which picks the one it counts.
- Power: one button per output; the arrow beside each, or a right-click, opens its menu.
- Session Controls: opens a small window with the names and notes you type for this session, a countdown, and every output’s power. It is the first of the two buttons beside the SessionHUD logo, at the top of the Outputs column; the second opens the take sheet.
The first time the Designer opens, a few cards introduce it, one at a time, each beside what it explains. Press Next to go on, or Hide Tips to stop them; Show tips in Settings ▸ General brings them back.
What a dash means
Where SessionHUD does not know a value, it draws a dash, and a value that has stopped updating is dimmed. SessionHUD never fills in a value it can’t back up. When it has to choose, for example which of several armed tracks the take number comes from, its best guess draws like any other value, and File ▸ Diagnostics… names it as a guess and says why.

- How sure: confirmed was seen directly; near certain was seen with one safe assumption, such as a take file that is still growing meaning it is still recording; best guess is SessionHUD’s choice where more than one answer fit.
- Take reasoning: why the take on screen is that take.
Where the windows are
- Designer: the four outputs, the canvas, the Layouts, Elements and Inspector panels, and the power buttons with the session status beside them (see The Designer). Open it with Designer in the status menu, or by clicking SessionHUD in the Dock.
- Settings: SessionHUD ▸ Settings…, or ⌘,. Six tabs: General (the look of SessionHUD’s own windows, the menu bar icon, keeping it running in the menu bar after ⌘Q, sample values, what outputs show when Pro Tools disconnects, the red and green Background follows transport uses, tips, and updates); Take Sheet (the take sheet’s setups, the colors of selects and alts, where exports are saved, your studio’s name and logo on its PDFs, and the switch for New Take and Stop); Session Controls (which sections, fields and output buttons the Session Controls window shows, the size of its take number, and its transport line); Browser & API (who can reach the page and the API, the port, and both addresses to copy); and Virtual Camera (installing the camera extension, the picture size and Standby). Hover a setting for what it does, or click the ⓘ beside it where there is one. See Settings.
- License: SessionHUD ▸ License…, a window of its own.
- Session Controls: File ▸ Session Controls…, or the first button beside the SessionHUD logo at the top of the Designer. Talent, client and notes that layouts can show, a countdown, every output’s power, what Pro Tools’ transport is doing, buttons for the take sheet and Camera Preview, and New Take and Stop, in a window you can keep beside Pro Tools. Settings ▸ Session Controls chooses what it shows. See Features ▸ Session Controls.
- Take Sheet: File ▸ Take Sheet…, or ⌥⌘T; also the second button beside the SessionHUD logo in the Designer and in Session Controls, the status menu and the Dock menu. Every record pass, with your selects, alts, lines and notes, in a window that stays above Pro Tools without taking its keyboard. See Take sheet.
- Camera Preview: File ▸ Camera Preview…, the button beside the logo in Session Controls, the status menu, the Dock menu or the Camera button’s menu. It shows what the virtual camera is sending, in a small window you can resize and keep above Pro Tools. See Virtual camera ▸ Watching what the camera sends.
- Diagnostics: File ▸ Diagnostics…, or ⌥⌘D. The connection, the watched folders, and why the current take is the current take. When you write to support, press Copy beside Log and paste it into your email; names and file paths stay out unless you turn on Include content.
- Status menu: the SessionHUD icon in the menu bar, for what you do without stopping. It holds the status line (and the evaluation’s days left); with more than one track armed, Take number from track, which picks the one SessionHUD counts; every output’s power, ticked while it is on; the HUD window’s layout and Always on Top; Designer, Session Controls…, Camera Preview…, Take Sheet…, Show Dock Icon and Quit SessionHUD. It does not open Settings or Diagnostics.
- Dock menu: right-click the Dock icon for the same status line, every output’s power, Designer, Session Controls, Camera Preview and Take Sheet. Useful if macOS hides the menu-bar icon, or you turned it off in Settings ▸ General.
Settings, License and Diagnostics are in the app’s own menus, which are there only while the Dock icon is showing. If you turned it off, Show Dock Icon in the status menu brings them back.

Uninstalling
- If you have a license, choose SessionHUD ▸ License… and press Release This Mac…, so the seat is free for another Mac.
- If you installed the camera extension, open File ▸ Diagnostics… and press Remove Camera Extension….
- Quit SessionHUD, then drag it from Applications to the Trash.
Nothing was added to Pro Tools or your sessions, so there is nothing to clean up there.
Your settings and layouts stay in ~/Library/Application Support/SessionHUD;
delete that folder too for a clean removal.