New to Timbral? This page orients you in the window and names the parts referred to throughout the rest of the guide.
TL;DR Watch these:
The window at a glance
The window is one tile grid. Worksheets and feature panes (Plots, PDF viewers, Maps, Notes, Data, Auralizer, Duct run, Variables) are all tiles of equal standing — there is no fixed left/right split any more.
- Click a tile to target it. The targeted tile gets a purple ring, and the ribbon at the top acts on whatever is targeted.
- Add a pane with the Add ▾ button at the right-hand end of the ribbon (it opens as a new tile), or with a feature tile's own + (it joins that tile as a tab).
- Drag a tile's tab to re-arrange, or drop it against an edge to split the space.
- Drag the borders between tiles to rebalance them.
- Pop a tile out into its own window and drag it to a second monitor; dock it back when you're done (Dock all back, under Workspace, docks every one). Feature tiles can be popped out; worksheets stay in the main window.
- Workspaces — the bar at the bottom switches between several tile layouts in the same project, so you can keep (say) a calculation layout and a drawing layout side by side. Right-click a workspace tab for Duplicate (copy the tile arrangement as a new workspace, with its own panes and its own copies of the sheets it shows), Rename or Close.
What the panes are for. Plot charts rows of a sheet (see Plotting Spectra) and PDF Viewer holds drawings for take-off (see PDF Viewer & Take-off). Notes is a free-text note saved with the project. Map shows the site on a map, with measuring and mark-up. Variables lists every published variable and can print one onto a sheet. Duct run builds a duct-run calculation element by element (straight duct, bend, junction/split, end reflection) — Mechanical › Ducting › Duct run… opens it. Auralizer lets you listen to how a room sounds, built from a reverberation-time row: select the row, then Plot ▾ › Auralize. Data is for importing survey measurements, but the component it needs is not yet included in the installers, so for now it shows "Data sidecar unavailable".
Worksheet tabs
Along the top of the spreadsheet tile is a strip of tabs. Timbral has three kinds of sheet, added from the buttons at the right of the spreadsheet tile's header:
- + — a new octave-band sheet, columns 31.5 Hz → 8 kHz (9 bands).
- +⅓ — a new one-third-octave sheet, columns 25 Hz → 10 kHz (27 bands).
- +⅓LF — a new low-frequency one-third-octave sheet, columns 0.8 Hz → 315 Hz (27 bands), for low-frequency and vibration work.
- Templates ▾ — start a sheet from a template: the built-in RT sheet (room parameters, absorption, Sabine and Eyring reverberation time, with a linked plot), any of your own under My templates, or Set templates folder… to share templates with colleagues through a common folder.
You can mix all three kinds in one workspace. To manage a tab:
- Rename — double-click the tab.
- Colour — right-click the tab and pick a colour (handy for grouping sheets by project or stage).
- Duplicate — right-click the tab and choose Duplicate to copy the sheet — data, formatting, and every calculation block — into a new tab next to it.
- Duplicate to — the same, but the copy goes into another workspace.
- Copy / Paste — right-click a tab and choose Copy, then right-click a tab in this or another open Timbral window and choose Paste sheet to drop the sheet in.
- Save as template… — save the sheet as a reusable template; Save sheets as template… saves it together with related sheets you pick. Rename, share or delete templates in File › Options… › Templates & data.
- Side by side — right-click › Move to new tile › Right (or Below) shows the sheet in a second spreadsheet tile, so you can work on two sheets at once; Move to tile moves a sheet into another spreadsheet tile. Dragging a tab to the edge of a tile does the same.
- Hide — the tab's × (or right-click › Hide) hides a sheet without deleting it; bring it back from the Hidden (n) button on the tile header. Delete sheet, at the bottom of the right-click menu, removes it for good after asking you to confirm.
- Switch — click a tab.
The ribbon
A single Excel-style ribbon runs across the top. It is a compact icon ribbon: hover over any icon and a tooltip names it (with its keyboard shortcut, where it has one). It has two rows of groups, left to right.
Top row — spreadsheet tools:
- File — New Workspace, Open…, Save, Save As…, Export…, Find in project…, Report a bug / request a feature…, and Options….
- Edit — Undo (Ctrl+Z) and Redo (Ctrl+Y). Undo covers cell edits, calculation blocks, plots, mark-ups and notes, and acts on the tile you are working in.
- Decimals — fewer decimal places, .0 (whole numbers), more decimal places, for the selected cells.
- Font — font and size, bold / italic / underline, text colour (A), cell background colour, and cell borders.
- Cells — merge, unmerge, and conditional formatting. (Rows are inserted and deleted from the right-click menu or the keyboard — see Working in the Spreadsheet.)
- Find — a Search… box: type and press Enter to highlight matches on this sheet; clear it to reset.
- View — zoom out / zoom level (click it to reset to 100%) / zoom in, fit the sheet to the pane width, trace the dependents of the selected cell, the Freeze Panes menu, and — on octave sheets — the Hide 31.5 Hz checkbox.
Bottom row — acoustics tools:
- Calculations · row N (N is the row a new block will go in) — one dropdown per family of calculations: Fundamentals, Propagation, Environmental, Mechanical, Buildings, Vibration and Ratings; then Curves, the 1/3 > 1/1 octave converter, Data (Global variable, Process Rows, Data library) and Custom (your own saved blocks). This is where you insert calculation blocks (see the Formula Reference).
- Plotting — the Plot ▾ menu: Plot spectrum, Plot vertical… and Auralize (see Plotting Spectra).
- Workings — the Show switch for intermediate “workings” rows, hide fully-empty rows, and unhide them again.
Right-hand end — Project, an optional project name that is saved with the project and printed as the heading of Excel, CSV and PDF exports; and Workspace, which shows the tile the ribbon is acting on, the Add ▾ button, and Dock all back while any pane is popped out.
The formula bar
Directly under the ribbon is a single formula bar (fx), shared by every sheet. It shows the contents of the currently selected cell and lets you type a value or a =formula. Editing here is identical to editing in the cell itself: Enter commits, Esc cancels. The bar can hold several lines — click Expand at its right-hand end (or press Ctrl+Shift+U) to give a long formula more room, and Collapse to shrink it again.
Showing and hiding detail (Workings)
Calculation blocks include intermediate “workings” rows. The Show switch in the Workings group hides them so a finished sheet shows only inputs and results; switch it back on whenever you need to check the intermediate steps. To change just one block, right-click its gutter handle and choose Hide workings (this calc) or Show workings (this calc). Hide blank rows collapses empty rows for a tidy printout, and Unhide blank rows brings them back.
Zooming and fitting
The View group zooms the spreadsheet grid in and out (or hold Ctrl and scroll over the grid), resets to 100% when you click the percentage, or fits the sheet to the current pane width — the Fit button on the spreadsheet tile's header does the same. (Charts have their own zoom inside their panes — see Plotting Spectra.)
Saving and loading
Use the File menu: Save (Ctrl+S), Save As…, Open… (Ctrl+O), and Export… for an Excel workbook, a PDF report, or a CSV of the active sheet. Double-clicking a saved .tmb file also opens it in Timbral. A saved Timbral workspace is self-contained: any PDF drawings you import are stored inside the workspace file, so it travels as a single document with all its data and annotations intact.
New Workspace and Open… open in a second window instead of replacing what you already have open, so starting a new file or opening another one can no longer overwrite unsaved work in your current window. (A blank window you haven't touched yet is simply reused.)
While you work, Timbral also keeps an auto-save recovery snapshot (how often is set in File › Options… › General). If Timbral closes before you've saved, it offers to recover that unsaved work the next time it starts — but this is a safety net, not a substitute for saving.