PODIUM: Sheet Music Studio

Podium icon
Guidebook
Version 2.0

Open in new window for convenient side-by-side reading with Podium. | Print me

Overture

Podium is:

...that runs on:

...with input devices:

...and practice tools:

...url:
https://studiop5.org/podium

Podium is provided as-is, without warranty of any kind. See the license for complete terms. Users are responsible for ensuring they have the right to use any score files opened in Podium.

Chapter 1: Quick Start

Welcome to Podium! This Quick Start guide will get you up and running in minutes. For detailed information on any topic, follow the chapter references throughout.

Getting Started in 3 Steps:

1. Open a Score

Launch Podium at https://studiop5.org/podium. You'll see a circular menu on a gray background, and the Score cell is highlighted. Drag out from the Open cell to reveal the Open Panel. Select a storage location (Local, Google Drive, Dropbox, OneDrive, or Recent), then navigate to a PDF score and tap to open it.

Opening a score
Screenshot showing the circular menu with Score cell highlighted and Open Panel displayed with file list

See Chapter 4: Score Ring for complete file management details

2. Choose Your Layout

Once your score is open, tap the inner ring's Layout cell. The outer ring will show 4 layout options:

Tap any layout cell to activate the layout. Drag out from the cell to open a configuration panel. Use a two-finger pinch-and-pan gesture on the score to resize and reposition.

Book layout Horizontal layout Vertical layout Table layout
Side-by-side comparison showing all 4 layout types with the same score

See Chapter 5: Layout Ring for detailed layout controls and settings

3. Navigate and Annotate

Navigation: Tap, swipe, or fling score pages to turn them. Long-press anywhere on the background to summon the menu. To hide the menu, fling it to any corner or edge, or long-press its center grip to park it in the upper left corner.

Annotations: Tap the inner ring's Ink cell to add annotations. The outer ring shows tools for:

Activate any Ink tool by tapping, then tap or drag on the score to use it. Configure the tool by dragging the corresponding panel from its cell. Note: Most Ink tools automatically deactivate after a few seconds of inactivity, so you won't accidentally stay in annotation mode when navigating pages.

Ink Ring with annotations
Screenshot (dark theme) showing Ink Ring activated with various annotation types visible on a score

See Chapter 6: Ink Ring for complete annotation tools and techniques

Essential Interface Tips:

The Circular Menu

The menu has three parts:

Both rings can be rotated by dragging them in a circular motion.

Circular menu
The circular menu showing Grip, Inner Ring, and Outer Ring

See Chapter 3: Interface Basics for complete interface details

Panels

Cells with small diamond-shaped pointers (like compass points) contain hidden panels. Drag out from these cells to reveal the panel. Once open, reposition panels by dragging their textured header. Hide a panel by flinging it from the header, or close them by tapping the 🗙 button.

Resizing and Moving

Everything in Podium—menu, panels, layouts—is resizable and movable using two-finger pinch-and-pan gestures (or Ctrl+mouse/Ctrl+wheel for desktop). See Chapter 3: Interface Basics for details.

Background Gestures:

Saving Your Work

Tap the inner ring's Score cell, then tap Save (or drag out from Save to choose a new location/name). Your annotations and settings are saved within the PDF file.

Save Panel
Screenshot showing Save Panel with file name field and storage options

See Chapter 4: Score Ring for saving, printing, and score details

Managing Pages

To add, remove, or rearrange pages, tap the inner ring's Page cell. The outer ring provides:

Note: Like Ink tools, Page tools auto-deactivate after a few seconds of inactivity.

The shared buffer lets you transfer pages between Podium tabs: use Export to send a page to the buffer, and Import to insert it into another score. The buffer is shared across all web app tabs and windows, and persists across sessions. Tabs of the web app (studiop5.org) share one buffer, and tabs of the browser extension share another; transferring across these boundaries is not possible.

Page Ring with horizontal layout
Horizontal layout with Page Ring active
Quick tip: In Table layout, you can reorder pages by simply dragging them to a new location; other pages split apart to show where the page will be inserted. You can also cut pages by dragging them completely out of the layout. This direct manipulation is often faster than using Page Ring tools!

See Chapter 7: Page Ring for complete page management features

Practice Tools

Tap the inner ring's More cell to access a suite of musician's practice tools. Most of these panels can be detached from their headers and positioned anywhere on screen for convenient access while practicing:

Practice tools
Screenshot showing Clock, Metronome, Stopwatch, Piano, Volume, and Review panels open simultaneously

See Chapter 9: More Ring for detailed information on each practice tool

Keyboard and Pedal Support

Podium works with footpedal page turners that simulate arrow key presses. Configure arrow key behavior in the Page Ring's Numbers panel to map pedal presses to page turns or bookmark navigation.

See Chapter 7: Page Ring - Numbers for keyboard shortcut configuration

Need Help?

Tap the inner ring's App cell, then tap the Guide cell to access this document.

That's it! You're ready to use Podium. Explore the chapters below for in-depth information on each feature.

↑ Back to Table of Contents

Chapter 2: Running Podium

The simplest way to use Podium is to launch it directly from the URL. No installation required. Just open studiop5.org/podium.html in your browser and start using it immediately. There is no registration, login, or onboarding of any kind.

However, installation may be desirable in certain situations, especially when using Podium in performance where internet connectivity cannot be assumed.

Offline use. After your first visit, Podium stores itself on your device automatically, so it can open and run without an internet connection, even without explicit installation. However, if you plan to use Podium offline, for example in performance, installing it is strongly recommended. Without explicit installation, the browser may quietly discard the stored copy when it needs space or when you clear your browsing history, leaving you without Podium when you need it most. Fortunately, Podium is remarkably compact: the storage it uses on your device is roughly equivalent to two photos from a typical smartphone camera.

Installing as a browser extension or PWA makes Podium a permanent resident on your device. The extension, being fully self-contained, is the most robust option for offline use on desktop. A PWA install is equally reliable on Android, desktop, and Chromebook. The one exception is iPhone and iPad: even as an installed PWA, the system may occasionally require an internet connection after a long period of inactivity; simply open Podium every now and then to keep it fresh.

Keep in mind that only scores you have stored locally will be available offline; scores in cloud storage require an internet connection to open.

2.1 Browser Extension

Podium can be installed as a browser extension in supported desktop browsers (Chrome, Edge, and other Chromium-based browsers like Brave or Opera). After installation, the Podium icon will be available under the browser's extensions menu (the puzzle piece icon in the toolbar). We recommend pinning it straight away for easy access: tap the puzzle piece, find Podium in the list, and tap the pin icon next to it. Once pinned, tap the Podium icon in the toolbar and tap "Launch Podium" to open the app directly. Scores can then be loaded in the usual way. The extension also provides two fast ways to open scores while you are browsing the web:

Since the extension works both online and offline, it's ideal for performance situations where you can't rely on an internet connection. The extension maintains its own recent list of scores opened via "Open with Podium", allowing you to reopen them with a single tap.

The extension works well with online score libraries such as Musopen and IMSLP. For IMSLP, logging in to your account provides the best experience—scores open instantly in Podium with no intermediate pages. Please support this invaluable resource for musicians by becoming an IMSLP member. Musopen works without a subscription; a one-time permission grant is required on first use. Consider supporting Musopen's mission to provide free music resources.

Podium context menu on IMSLP
Right-click context menu showing "Open with Podium" option on IMSLP
Podium's extension is not available on iPhone or iPad, but can be installed as a progressive web app, see below. On Android, Chrome does not support extensions, but Edge for Android has Beta support for extensions as of this writing.

2.2 Progressive Web App (PWA)

Podium can also be installed as a Progressive Web App. Once installed, Podium appears as a standalone application on your device and works offline.

Desktop (Chrome, Edge, etc.): When visiting the Podium URL, look for the Podium icon and "Open in app" prompt in the address bar. Tap to install.

Chrome PWA install prompt in address bar
Chrome address bar showing Podium icon and "Open in app" prompt (Linux)

Android (Chrome): Tap the browser menu (three dots) and select Add to Home Screen. A popup will offer two options: choose Install (not "Create shortcut") for the full PWA experience with the correct icon and offline support. Podium will appear in your apps drawer, where you can add it to your home screen in the usual way.

iPhone/iPad: Apple does not display automatic install prompts for PWAs. To install, open Podium in your mobile browser (such as Safari or Chrome), tap the Share button in the toolbar (iPhone: bottom centre; iPad: beside the address bar), scroll down in the share sheet and tap "Add to Home Screen", then tap "Add". Once installed, the Podium icon appears on your home screen; if you long-press it, the system refers to it as a bookmark — this is normal Apple terminology for home screen web apps. Also note that if the PWA is not used for several weeks, the iPhone/iPad system may offload the app's data. This can cause settings to reset or require an internet connection to re-verify the app on its next launch. To prevent this, simply open Podium occasionally.

A significant advantage of the PWA over running Podium in a browser tab is that it always occupies the full screen with no browser toolbar, address bar, or other distractions: a clean, app-like experience unique to the PWA. As a result, the Screen button and the full-screen swipe gesture have no effect when running as a PWA, since Podium is already in full screen.
Naturally, when offline, only locally stored scores can be accessed.

2.3 Browser Compatibility

Podium works in all modern browsers. The table below summarizes feature availability:

Feature Chrome / Edge Firefox Safari
Core functionality Full Full Full
Local file open/save Remembers location Choose location each save Choose location each save
Page-turn animations Full Full Simplified page-turn effect
Full-screen swipe gesture Full Full Enter: use Screen button (iPhone/iPad)
Browser extension Full N/A N/A
PWA install Full N/A iPhone/iPad: Full. macOS Sonoma or later only.
Cloud storage Full Full Full
Offline use Works in browser tab; PWA install recommended for reliability Works in browser tab; PWA install recommended for reliability Works in browser tab; PWA install recommended. iPhone/iPad: cache may expire after long inactivity.

For the best experience, Chrome, Edge, or similar browsers are recommended.

Recommended browser by platform:

↑ Back to Table of Contents

Chapter 3: Interface Basics

Podium has four interface elements:

Moving and Resizing

Everything in Podium—menu, panels, layouts—is resizable and movable.

Sand texture: Notice the sand-like texture on the menu's center grip, panel headers, and sliders. Drag any textured area to move that element.

Two-finger pinch gestures: Use pinch-zoom to resize any element. The behavior depends on where your fingers are:

Mouse alternative: Hold Ctrl and drag to move. Hold Ctrl and scroll the mouse wheel to resize. For greater accuracy, hold Ctrl+Shift while scrolling.

Background Gestures

Menu

On launch, Podium displays a circular menu on a gray background. The menu has three parts:

Grip (center circle)

Inner Ring

Tap any cell to activate it. This determines which cells appear in the outer ring. Only one inner ring cell can be active at a time. Active cells have a white background.

Outer Ring

Tap any cell to activate it and trigger its action. Only one outer ring cell can be active at a time.

Unavailable cells are grayed out. On launch, only the Score and More cells (inner ring) and Open and New cells (outer ring) are available.

Cell Auto-Deactivation

Cells in the Ink Ring and Page Ring automatically deactivate after 4 seconds of inactivity, returning control to normal page navigation. This is an important feature: when an Ink or Page cell is active, touch gestures on score pages are intercepted by that cell's action rather than being interpreted as page navigation. Auto-deactivation ensures you won't accidentally draw on a page or delete it when you intended to simply turn the page.

Cell Locking

To prevent a cell from auto-deactivating, long-press it. A locked cell displays a circle around its outer edge and remains active indefinitely. Long-press the cell again, or select a different cell, to unlock it. Cell locking is supported by all Ink Ring cells and most Page Ring cells (except Numbers and Merge).

Locked cell showing circle indicator around outer edge
A locked cell with circle indicator around its outer edge

Rotating Rings

Drag either ring in a circular motion to rotate it. This is helpful when the menu is positioned near a screen edge and some cells aren't visible. Rotating the ring brings hidden cells into view without having to move the menu.

Ring rotation showing hidden cells brought into view
Rotating a ring to reveal hidden cells when the menu is near a screen edge

Panels

Menu cells with small diamond-shaped pointers contain hidden panels. To open a panel, drag inward or outward. As long as the drag motion isn't circular, the panel will be revealed—circular motion rotates the ring instead.

Revealing a panel does not activate the corresponding cell—cell activation by tapping is a completely independent gesture.

Moving panels: Drag from the textured header, or use two-fingers (Ctrl-mouse-drag) to drag anywhere on the panel.

Resizing panels: Use two-finger pinch-zoom, with at least one finger on the panel (Ctrl-mouse-wheel, or Ctrl-Shift-mouse wheel for greater precision). Only the selected panel will resize.

Closing vs. hiding:

Most panels work the same whether closed or hidden. However, panels that run continuously (Metronome, Stopwatch, Clock, Review) will keep running in the background when hidden. For example, a hidden Metronome keeps ticking, but a closed one stops completely.

Sliders

Many panels use sliders to adjust values. For more precision, drag the slider to approximately the right value, then (without lifting your finger) drag up or down. The farther you drag, the more precise the slider becomes.

A floating window displays the current value, positioned so your hand won't block it.

Slider precision mode
Slider with precision mode (dark theme): drag away from the slider, then drag left ⇄ right to adjust with increased sensitivity

Browser Tab Naming

Podium can run in multiple browser tabs simultaneously, sharing a common shared buffer between them. Tabs of the web app (studiop5.org) share one buffer, and tabs of the browser extension share another; transferring across these boundaries is not possible. To distinguish tabs, each is assigned a short musical identifier drawn from dynamics and solfege: do, re, mi, fa, so, la, ti, ff, mf, mp, pp, sf. When a score is loaded, the browser tab displays the score's file name; otherwise it shows Podium followed by the tab's identifier in parentheses, for example Podium (do). Extension tabs use square brackets instead, like Podium [do], so you can tell at a glance whether a tab is running the web app or the browser extension. In theory, up to 12 Podium tabs can be open at the same time. Keep in mind that each tab consumes additional browser memory and processing resources, so opening more than two or three can be impractical.

↑ Back to Table of Contents

Chapter 4: Score Ring

Manage scores stored as PDF files.

Most of the Score Ring's cells are grayed out until a score is Opened, or until a New, empty score is created.

In Podium, only one score can be open at a time in each browser window or tab. When opening a score, if the current score has unsaved changes, those changes will be lost. For this reason, you'll be prompted to confirm. You can open multiple scores simultaneously by opening Podium in additional browser windows or tabs. The Page Ring allows you to copy pages between scores opened in different windows.
Score Ring menu cells
Score Ring menu cells diagram

4.1 Score Ring: Open, Save

Open and save PDF score files.

Both Open and Save Panels work with locally attached storage or with cloud storage services: Google Drive, Dropbox, or Microsoft OneDrive. These services require accounts and are subject to their respective terms of service.

Panel Navigation (Common to Both)

In either Panel, tap any tab on the tab strip to select a storage service. Drag the strip left ⇄ right to access other tabs.

Each Panel displays a scrolling list of PDF file and folder entries. Drag or fling that list up/down to scroll the contents. The list is alphabetical A-Z, with directories grouped after files.

Tap a folder entry to repopulate the list with that folder's contents. Below the tab strip is the Folder Path strip: it shows the current folder path. Tap a folder name or icon to load the corresponding folder. Tap the current (last) folder name to refresh the listing from the cloud provider. Tap New to create a new folder.

Each entry in the file/folder list has icons for renaming or deleting. There is no built-in copy/paste functionality: instead, open the file, save it to the desired location, then delete the original.

By design, Podium moves deleted files to the storage provider's recycle bin rather than permanently deleting them. Behavior may vary by provider. Log in to the provider to manage the recycle bin through its native interface.

Opening Scores

Tap a PDF score file in the Open Panel to download and display that score.

Open Panel
Open Panel showing cloud storage tabs and file list

The Menu's Open cell is also tappable. With a score already open, tapping the Open cell reloads the current file (i.e. "revert to saved").

Recent Tab: The Recent tab provides quick access to the 20 last visited PDF score files. This list is stored in the browser's local storage, so it will have unique contents for each device/browser combination.

Local Files

The Local tab hands off control to the operating system's built-in file picker. This file picker provides access not only to files stored on the device, but also to cloud storage services registered with the operating system:

Because browser security limits direct access to local files, it is not possible to pre-populate the file picker with a specific folder location.

Drag and Drop (Desktop): On desktop browsers, you can drag a PDF file directly from your file manager onto the Local tab to open it in Podium.

Password-Protected PDFs: Podium can open password-protected PDF files. You will be prompted to enter the password. Once opened, you can view and annotate the score, but you cannot save changes or copy pages from a protected PDF.

Saving Scores

The Save Panel has a widget for editing the file name. Inside the widget there is an Upload button: tap it to save the current score, with the given name, to the selected folder.

Save Panel
Save Panel with file name editor and upload button

The Menu's Save cell is also tappable. With a score open, tapping the Save cell saves the current file to its original location, bypassing the Save Panel.

Local Save on Firefox

Firefox does not support the File System Access API, so local saving works differently:

Recommended Firefox Desktop Settings

For the best experience with Podium on Firefox desktop, configure these settings (found in Firefox Settings → General):

Firefox on Android, iPhone, and iPad is not recommended for use with Podium. On these devices, use Chrome (Android) or Safari (iPhone/iPad) for the best experience.

On platforms that don't allow specifying the file name during save, edit the score name first in the Details Panel (Score Ring → Details). The .pdf extension is not required—it's added automatically on save if not present.

4.2 Score Ring: New

Create new, empty scores.

New empty scores are created by activating the New cell. The newly created score is made using the number of pages, size, and background color and opacity specified in the New Panel. Each new score is given a default name (e.g. "Opus 42"). If desired, use the Details Panel to rename it before saving.

New Panel
New Panel showing page count, size options, and background settings

The New Panel allows you to configure:

4.3 Score Ring: Print

Print the current score with or without annotations.

Print Panel
Print Panel showing ink options and page range settings

In Podium, user-created annotations are called Ink. The Print Panel allows you to configure printing options:

iPhone/iPad: Safari does not support automatic print dialogs from web apps. After tapping Ink or No Ink, your PDF will open in a new tab. From there, tap the Share button in the toolbar (iPhone: bottom centre; iPad: beside the address bar) and choose Print.
Large scores or scores with particularly dense or poorly encoded, unoptimized PDF content can fail while printing. If you encounter printing failures, try printing the score in several smaller sections by specifying different page ranges.

4.4 Score Ring: Details

The Details Panel displays comprehensive information about the currently open score.

Details Panel
Details Panel showing score metadata and display options

Score Name: At the top of the panel is an editable field showing the score's file name. Edit this field to rename the score before saving. The .pdf extension is not required—it's added automatically on save if not present. This is especially useful on platforms where you cannot specify a file name during save (such as Firefox or Android).

Metadata: The panel displays metadata created by Podium (such as when the score was last modified) as well as any metadata from the original PDF file. This may include information about the score's provenance, such as the original author, creation date, and other document properties.

Page Sizing: In Podium, all pages in a score are displayed at the same size, though this is not necessarily the case for PDF files in general. A single PDF file can contain pages of many different sizes—for example, a score might mix Letter and A4 pages, or include wide foldout pages alongside standard portrait pages. This is common with scanned scores from libraries like IMSLP, where pages may have been scanned at different times or from different editions. By default, Podium sizes pages to match the largest page in the PDF and centers smaller pages within that rectangle. The Details Panel contains a radio button that determines how smaller pages are treated:

Display Quality: The panel allows you to configure display quality. Higher quality uses more memory but provides sharper rendering.

↑ Back to Table of Contents

Chapter 5: Layout Ring

Determine how scores are displayed.

Layout Ring menu cells
Layout Ring menu cells

Podium implements 4 layout schemes:

By default, scores open with the last used layout on the current browser/platform or, if none, Book. The layout can be changed any time by tapping the desired cell. Whenever a score is saved, its last layout is stored as metadata in the PDF file, as well as in browser local storage.

In a Podium Layout, all pages must be the same size. Whenever a score file is opened, the maximum page width and height are first determined. Then, if any pages are smaller than this maximum, they are by default centered and padded with a gray border on all sides. Alternatively, smaller pages can be expanded: the score is scaled so its largest dimension fills the page, then centered in the other dimension. See the Details Panel to configure this behavior.

5.1 Layout Ring: Book

Simulate a physical book.

Book layout
Book layout with pages and panel
In addition to being aesthetically pleasing, the Book layout allows you to practice with page turns the way you would in performance using a physical score. This helps build muscle memory for when and how to turn pages during actual performances.

Turn pages by tapping, flinging (i.e. touch→drag→release, all in one quick motion), or by more deliberate dragging. Tap the right page to advance, or the left page to go back. When dragging, if you release without dragging past the central spine, the dragged page will flop back to its original position.

The Book Panel's Fit buttons determine the score's initial sizing:

After initial layout, use 2 fingers to pinch-pan-zoom the score to move/resize as desired. Mouse users: Ctrl-drag/Ctrl-wheel (Ctrl-Shift-wheel for extra precision).

Page numbers can be turned on or off in the Book Panel. Current page numbers are shown at the left and right sides of the layout: drag the page number to quickly flip to other pages.

Bookmarks: Long-press on a page number to set a bookmark. Bookmarks appear as colored tabs on the book jacket. Press on any bookmark to jump there. Long-press on any bookmark to remove it.

Physical books must have an even number of pages, as each page has 2 sides. If the PDF score file contains an odd number of pages, the last page is displayed on the right (back inside cover position) and cannot be flipped to the left.

5.2 Layout Ring: Horizontal

Display the score as a continuous, horizontally-scrollable flow of pages.

Horizontal layout
Horizontal layout with pages and panel

The Horizontal Panel's Fit buttons determine the layout's initial size:

After initial layout, use 2 fingers to pinch-pan-zoom the score to move/resize as desired. Mouse users: Ctrl-drag/Ctrl-wheel (Ctrl-Shift-wheel for extra precision).

The Panel's Show: slider determines how many pages are visible at a time (from 1-8)

The Panel's Gap slider determines how much space to leave around each page, as a percentage of the page's width.

Scroll pages by tapping, dragging, or flinging. When Snap is enabled, tap the right half of the layout to advance or the left half to go back. The Panel's Snap: slider determines how many pages the scroll advances when a page is tapped, dragged, or flung, ensuring that after a scroll, the leftmost and rightmost pages align with the left and right scrollers. Move the Snap: slider all the way to the left to completely disable page snapping.

Page numbers can be turned on or off in the Panel. Current page numbers are shown at the left and right sides of the layout: drag the page number to quickly scroll to other pages.

Bookmarks: Work the same as in Book layout (see above).

5.3 Layout Ring: Vertical

Display the score as a continuous, vertically-scrollable flow of pages.

Vertical layout
Vertical layout with pages and panel

Settings for this layout function identically to the Horizontal Layout, see previous section.

Try disabling Snap. Slide the Snap slider all the way to the left to turn it off. With snapping disabled, pages scroll freely and continuously, letting you position the score exactly where you need it. You can line up the bottom of one page directly above the top of the next, eliminating the visual interruption between pages.
Vertical layout on smartphone
Vertical layout on smartphone
For viewing on a smartphone or small tablet, Vertical layout often gives the best experience. Smartphones work best in landscape orientation. Activate full-screen mode, turn off Numbers, set Page Fit: Width, Show: 1 page, and Snap: disabled. Dismiss the Panel, either by tapping the close button's X, or by simply flinging the panel. Then thumb-scroll through the score. Pro tip: add a blank page at the end of the score so the bottom of the last page can be scrolled fully into view.

5.4 Layout Ring: Table

Display all pages of the score in a single table.

Convenient for adding or rearranging pages (using the Page Ring), or for quickly locating a page in a large score.

Table layout
Table layout with pages and panel

The Table Panel's Fit buttons determine the layout's initial size:

After initial layout, pinch-zoom the score to resize/move as desired.

The Panel's Pages per row: slider determines how many pages are shown in each row.

The Panel's Horizontal Gap slider determines the horizontal gap between neighbouring pages, as a percentage of the page's width. Setting this to a negative value causes the pages to be displayed overlapping each other, much like playing cards.

The Panel's Vertical Gap slider determines the vertical gap between neighbouring pages, as a percentage of the page's height. Setting this to a negative value causes the pages to be displayed overlapping each other, much like playing cards.

Page numbers can be turned on or off in the Panel.

Current Page: At any time, there is always a current page, drawn in higher resolution, slightly larger, and on top of all other pages. Tap on any page to make it current. If you change to another layout, that layout will open at the current page.

You cannot add annotations to a page in Table layout unless it is current. See the Ink Ring chapter for details on annotations.

Bookmarks: Long-press on a page to both make it current and toggle its bookmark state (add bookmark if none exists, remove bookmark if one already exists).

Reordering pages: Touch-drag a page to a new location. As you drag the page across the layout, other pages will split apart showing you where the page will be inserted if you release the drag. This effect works best when pages are not too extensively overlapped using negative values for the Vertical and Horizontal Gap sliders in the Layout Panel.

Cutting pages: Dragging pages out of the layout cuts them from the score. This can also be accomplished using the Cut cell of the menu's Page Ring.

To ease memory usage, the Table Layout shows low-resolution copies of all pages except the current page. These copies must all be generated before the Table Layout can be drawn: this may take several seconds to several minutes, depending on score size and complexity.
↑ Back to Table of Contents

Chapter 6: Ink Ring

Add annotations to a score.

Ink Ring menu cells
Ink Ring menu cells

The Ink Ring's cells add annotation objects—staves, music symbols, text boxes, external images, and line drawings—to score pages. Tap any cell to activate it, then touch any score page to start drawing, to insert a symbol, image, or text box, or to perform any of the Ring's other actions: cut, copy, paste, grid, or edit.

Normally, any gestures made on score pages are interpreted as page navigation commands. However, if the Ink Ring is selected, and if it has an activated cell, that cell's action will be performed instead.
When an Ink Ring Cell is activated, it stays active until tapped again, or until a different Ink Ring Cell is activated. Cells automatically deactivate after 4 seconds if not used. To prevent this, long-press a cell to lock it—a circle appears around its outer edge to indicate the lock. Long-press again or select a different cell to unlock. All Ink Ring cells support locking.

Tools Overview:

Pencil, Pen: line drawing tools. They are functionally identical; however, using their associated panels, they can be configured differently (color, line width, etc.) so that two different line types are immediately available for use.

Rastrum: A tool for drawing staves. More generally, a tool that draws a settable number of parallel lines, either horizontally or vertically. Consequently, the tool can also be used for medieval/renaissance staves, lute and guitar tablatures, chord diagrams, and so on.

Text: adds editable, multi-line text boxes to a page.

Symbols: adds individual music symbols. The Symbol cell's panel provides access to the several thousand music glyphs contained in the included Bravura music font.

Cut, Copy, Paste: Each annotation is an independent object that can be cut, copied, pasted, or transformed. To cut or copy an object, tap the Cut or Copy cell, then tap the target object on the score page. Then, if desired, tap the Paste cell, then tap the score page where you want to paste the previously Cut/Copied object.

Undo: Undo the last Ink Ring action. To undo an action, activate the undo cell, then tap the page to revert it to its state before the last action. To conserve memory, only the most recent 10 actions per page can be undone.

Grid: Displays a configurable drawing grid over the page.

Edit: while active, tapping on any existing annotation allows it to be selected, moved, rotated, or resized. Drag out to reveal a panel with precision sliders for exact positioning.

6.1 Ink Ring: Pen, Pencil

Draw on score pages.

Pen and Pencil panels
Pen and Pencil panels

The Pen and Pencil Tools have identical functionality. Configure them independently: that way, two unique line-drawing styles will be readily available.

Tap on the color swatch in the Panel to invoke the Browser's native color chooser.

Tap on the interlocking circles in the Panel to reveal a slider that adjusts opacity.

Buttons on the bottom affect how the lines are drawn:

6.2 Ink Ring: Rastrum

Draw music staves.

Rastrum Panel
Rastrum Panel showing 5-line staff, staff with barlines, renaissance lute staff, plainchant staff, guitar and mandolin chord charts

The tool's name comes from the Latin word for "rake." Historically, a rastrum was a specialized multi-nibbed writing instrument used to draw the parallel lines of musical staves on manuscript paper. Like a small rake, its multiple nibs would draw several lines simultaneously—typically five for standard notation, though rastra with different numbers of nibs existed for various musical purposes.

Podium's Rastrum extends this concept, allowing you to draw up to 60 parallel lines with optional bar lines.

The tool is used by first touching the page, then dragging to define the rastrum object's length.

Set the style to L-R or T-B to draw horizontally or vertically. The T-B setting is useful for making chord charts for guitar, ukulele, mandolin, and other fretted instruments. Once drawn, a rastrum object can always be rotated using the Edit tool.

Staff Space: In music typography, a staff space is the standard unit of measurement: the distance from one staff line to the next. All musical elements—noteheads, rests, clefs, accidentals—are sized relative to this unit, so that notation scales consistently regardless of the physical size of the staff. A standard notehead, for example, is designed to fill the space between two adjacent lines. The staff space panel setting determines the distance in pixels between staff lines. Matching this value with the staff space setting in the Symbols tool ensures that staves and symbols are correctly sized for each other.

Width: Sets the thickness of staff lines. Move the slider all the way to the left for Auto, which uses the default recommended thickness for the Bravura font at the current Staff Space value.

Barline Width: Sets the thickness of barlines. Move the slider all the way to the left for Auto, which uses the default recommended thickness for the Bravura font at the current Staff Space value.

The Rastrum tool, in combination with Copy/Paste, the Grid, and the Merge operation, can be used to design manuscript paper of considerable complexity.

6.3 Ink Ring: Text

Add text boxes to a page.

Text Panel
Text Panel

The Text Panel allows you to configure text properties:

6.4 Ink Ring: Symbols

Add music symbols to a page.

Symbols Panel
Symbols Panel showing random selection of the approximately 3500 available glyphs

Symbols are arranged in groups as defined by the Standard Music Font Layout (SMuFL). The SMuFL webpage displays a comprehensive table showing all glyphs and their names in the SMuFL standard. In Podium, all music symbols come from the SMuFL reference Bravura font.

Choose a Symbols Group from the dropdown, then tap to select a symbol in the Preview. Note that most groups have many more symbols than are visible in the preview: drag left ⇄ right to see them all.

Staff Space Sizing: This setting sizes the symbol by specifying the distance between adjacent staff lines that symbol is designed for. Matching the staff space value in the Symbols Panel to the staff space value in the Rastrum tool will ensure that music symbols are correctly sized for a corresponding staff.

After placing a symbol, use the Edit tool to precisely position, resize, or rotate it.

6.5 Ink Ring: Cut, Copy, Paste

Manage annotation objects.

Each annotation is an independent object that can be cut, copied, pasted, or transformed. To cut or copy an object, tap the Cut or Copy cell, then tap the target object on the score page. The object is placed in a paste buffer associated with the score, allowing annotation objects to be moved or copied between pages.

To paste an object from the paste buffer, tap the Paste cell, then tap any score page where you want to paste that object.

The Copy cell has an associated Open Panel that can be used to select an external PNG or JPEG image file from digital storage. Drag out the panel and select the desired image file. Then use the Paste cell to paste the image as an annotation object into a score page.

If you have a PNG or JPEG of a score page, for example a photo you've taken with your camera, you can incorporate it into your score as a permanent PDF page: open the image from the Copy cell's Open Panel, then use the Page Ring's Add cell to add a blank page. Paste the image onto that page using the Ink Ring's Paste cell, and resize or reposition it as needed using the Edit tool. Finally, use the Page Ring's Merge command to bake the image into the PDF, giving you a new score page with your image embedded.

Deleting annotations: To delete an annotation object, activate the Cut cell and tap the object. If you don't subsequently paste the object elsewhere, it is effectively deleted from the score.

6.6 Ink Ring: Undo

Undo the last Ink Ring action.

To undo an action on a page, activate the Undo cell, then tap on that page to revert it to its state before the last action. Podium stores the most recent 10 actions made on each page.

You can undo any Ink Ring action including paste, delete, and transform operations. The only exception is the Copy action itself, which cannot be undone (though you can undo the subsequent paste).

6.7 Ink Ring: Grid

Draw a 2-d guide grid for measuring and layout.

Grid Panel
Grid panel and grid overlay on score

The Grid panel can be configured using Metric or Imperial (inch) units.

The Grid is 2-dimensional: adjust the X and Y Step sliders to change distance between grid lines.

To precisely position the Grid, first activate the Grid cell, then touch any page in the score. Before releasing this touch, the position of the grid will follow your touch. Use this to align the grid with current features of the score page. The grid can be repositioned by first tapping the page to remove the grid, then tap-hold and drag to reposition.

When Numbers is On, labels on the grid lines show the distance from the origin, marked with a "o".

The Grid is not itself an annotation object: it does not interfere with any other Ink actions and is not present when a score is saved or printed.

The Grid helps in aligning and precisely positioning ink elements. It can also be used to measure distance between elements or score features: when activating the grid, set the 0 point to the start of the measurement and then read off the length. Grid measurements represent Podium's best guess at the size of the corresponding printed representation of the score, regardless of zoom level or monitor resolution.

6.8 Ink Ring: Edit

Edit (move, resize, rotate) annotation objects.

Transform handles
Transform handles on selected object

With the Edit cell activated, select an object by touching it, or by sweeping a rectangle around it.

Move the rectangular handles to resize/rotate the object:

Group transformation
Multiple objects selected for group transformation

You can drag across multiple objects to select them, then transform them as a group. Tap the lock icon to make the group behave like a single object. Tap it again to ungroup.

Edit Panel: Precision Sliders

Drag out from the Edit cell to reveal a panel with precision sliders for exact numeric control of the selected object:

The panel displays the type of the selected object (Path, Text, Symbol, Rastrum, Image) and updates in real time. When multiple objects are selected, the panel shows the group type and count.

Annotations and Workflow Tips

Saving and persistence: All annotations are automatically saved with the score when you save the file. Annotations are preserved when switching between different layout modes.

Page limitations: Annotation objects cannot span multiple pages, but they can be easily copied between pages using the Cut/Copy/Paste tools.

Performance considerations: Annotations, especially free drawings with many pen/pencil strokes, can significantly increase the size of a saved score. For complex annotated pages, consider using the Merge operation (in the Page Ring) to convert annotations into the PDF itself, which can improve performance.

Precision workflow: For precise notation work, combine the Grid tool with Rastrum for staff placement, then use Symbols to add notation. The Edit tool allows fine-tuning of symbol positions after placement.

Reusable symbol library: If you frequently reuse a set of symbols, add a blank page to your score and place those symbols on it. This creates a personal symbol library that's always available for Copy/Paste. You can easily move this symbol set page around the score using Page Ring commands or by dragging pages in the Table Layout.

↑ Back to Table of Contents

Chapter 7: Page Ring

Manage the pages and page numbers of a score.

Page Ring menu cells
Page Ring menu cells
Normally, any gestures made on score pages are interpreted as page navigation commands. However, if the Page Ring is selected, and if it has an activated cell, that cell's action will be performed instead.
When a Page Ring Cell is activated, it stays active until tapped again, or until a different Page Ring Cell is activated. Cells automatically deactivate after 4 seconds if not used. To prevent this, long-press a cell to lock it—a circle appears around its outer edge to indicate the lock. Long-press again or select a different cell to unlock. All Page Ring cells support locking except Numbers and Merge. Exception: the Numbers cell never activates—it simply holds a panel for configuring page numbering and keyboard shortcuts.

Page Ring Tools:

Numbers: Drag out to reveal a panel that displays and configures score page numbers.

Add: Insert a new, empty page into the score, as configured by the Add Panel.

Cut: Remove a page from the score and hold it in a local clipboard for pasting elsewhere in the same score.

Copy: Copy a page to a local clipboard for duplication within the current score.

Paste: Insert the page from the local clipboard at a new location in the current score.

Undo: Undo the last page operation (cut, copy, or paste).

Export: Copy a page to the shared buffer, making it available to other Podium tabs.

Import: Insert pages from the shared buffer into the current score.

Merge: Merge all Ink objects on a page into the page itself, converting annotations into permanent PDF content.

Magnify: Drag out to reveal a magnifier panel that shows a zoomed-in view of the score at the touch point.

7.1 Page Ring: Numbers

Configure page numbering and view the current page number displayed in the layout margins.

Numbers panel
Numbers panel showing page numbering controls

Every page in a score has two numbers: its sequential position (1st, 2nd, 3rd...) and its displayed page number. Podium shows the displayed page number in the layout margins, which you configure using two settings:

Roman pages: How many pages at the beginning of the score should be numbered with lowercase Roman numerals (i, ii, iii...). Typically used for front matter such as title pages, table of contents, and introductory material.

First Page Number: What number to display on the first non-Roman page. This allows you to match page numbers from the original score.

In the screenshot example:

This is useful when working with excerpts from larger scores. Here, you might have extracted a title page, table of contents, and pages 143-145 from a complete work. The numbering scheme preserves the original page references.

Footpedal Keys:

These controls are designed for Bluetooth footpedal page turners commonly used by musicians. Since footpedals are simply specialized keyboards with only a few keys, these commands work equally well with regular computer keyboards.

You can assign one shortcut to the up or right cursor arrow keys, and one to the left or down cursor arrow keys. Tap the appropriate button to determine if an up or right key press will navigate to the next page, or instead navigate to the next bookmark. Similarly, choose the appropriate button to determine if the left or down keys will navigate to the previous page, or navigate to the previous bookmark.

The usual usage is to page forward or backward through the score. However, the ability to navigate forward or backward through bookmarks is a particularly helpful feature for reading scores with repeats spanning several pages. Set a bookmark on the page containing the beginning of the repeated section, then configure the right or up arrow keys to Pages, and the left or down arrow key to Bookmarks. Play through the repeat, using the right arrow key (or its foot pedal equivalent) to navigate forward through the following pages. Then, when you reach the end of the repeated section, use the left arrow key to immediately flip back to the beginning of the repeat.

Additional Keyboard Shortcuts:

In addition to the configurable arrow key behavior above, the following keyboard shortcuts are always available:

7.2 Page Ring: Add

Configure the appearance of new pages added to the score.

Add Panel
Add panel configuration

To add a new page to a score, activate the Add cell, then tap on any page in the score. If the tap is on the left side of the page, the new page is added before the tapped page, else it is added after. (For Vertical Layout only: tap above the middle of the score page to add before, or below the middle to add after).

The Add Panel is used to configure the color and type of added pages:

To configure the color and opacity of added pages:

To set the size of added pages:

7.3 Page Ring: Cut, Copy, Paste

Cut, copy, and paste pages within the current score.

These three cells operate on a local clipboard that exists only within the current tab and session; they do not interact with the shared buffer or other Podium tabs.

Cut: Activate the Cut cell, then tap a page. The page is removed from the score and placed in the local clipboard.

Copy: Activate the Copy cell, then tap a page. The page is placed in the local clipboard. The original page remains in the score.

Paste: Activate the Paste cell, then tap a page in the score. The clipboard page is inserted before or after the tapped page (tap left/top half to insert before, right/bottom half to insert after). The clipboard is preserved after pasting, so you can paste the same page multiple times.

Deleting pages: To delete a page, activate the Cut cell and tap the page. If you don't subsequently paste it elsewhere, it is effectively deleted from the score. In Table Layout, you can also cut pages by dragging them out of the table.

Cut and Paste operations can be undone using the Undo cell. Copy cannot be undone.

7.4 Page Ring: Undo

Undo the last page operation.

To undo a page operation (cut, paste, or import), activate the Undo cell. The most recent operation will be immediately reversed. The Page Ring maintains an undo history of the last 10 operations.

Undo does not modify the shared buffer: if you undo an import operation, the imported pages are removed from the score but remain available in the buffer for importing again. To undo an export, use the Import panel's Undo or Clear buttons.
Unlike the Ink Ring's per-page undo stack, the Page Ring undo operates on page-level operations across the entire score.

7.5 Page Ring: Export, Import

Share pages between Podium tabs via the shared buffer.

Import Panel
Import panel showing shared buffer with multiple pages

The shared buffer has superpowers! Behind the scenes, it's actually a separate PDF file consisting of all the pages you've exported, in the order you exported them.

Export: Activate the Export cell, then tap a page. The page is appended to the shared buffer. The original page remains in the score.

Import: Activate the Import cell, then tap a page in the score. All pages in the shared buffer are inserted at that position, before the page if you tap on the left half (top half for Vertical Layout) or after if you tap the right half (bottom half for Vertical Layout).

The Import Panel shows you a horizontally draggable view of thumbnails of the shared buffer, along with two management buttons:

Cross-Instance Sharing and Privacy: The shared buffer is shared by all instances of Podium running within the same browser origin. This means that all browser tabs and the installed Progressive Web App (PWA) share a single buffer, while the browser extension maintains its own separate one; transferring across these boundaries is not possible. The buffer persists even if you close your score or restart the browser. If you share a browser with others and are concerned with privacy, you should clear the shared buffer after your session. Note that if you use both the web app and the extension, you must clear each buffer separately.

Primary Use Case: Practice Scores

Create your own custom practice scores by extracting pages from all the scores you're currently practicing into one combined score. This reduces the chore of opening and closing multiple files during practice sessions.

Performance Note: Copying pages between PDFs is very compute intensive, as the PDF format was not designed for this type of operation. It's best not to fill the shared buffer with too many pages at once, or the system will become very slow.

7.6 Page Ring: Merge

Merge a score page's Ink annotations into the PDF.

In Podium, each page comprises two overlapping layers:

Activate the Merge cell, then tap a page to merge its overlay layer into the background layer. The operation converts all of the page's Ink objects into PDF objects, then incorporates these objects into the background layer [courtesy of the open-source pdf-lib library]. After that, these merged objects can no longer be selected or edited: they have become an integral part of the score's PDF content.

Common Use Cases:

Adding smartphone photos to a score: If you've photographed score pages with your smartphone, you can incorporate them as permanent PDF pages. See the Ink Ring: Cut, Copy, Paste section for the full workflow — Merge is the final step that bakes the image into the PDF.

Preventing accidental edits: Suppose you've used the Ink Ring's Rastrum tool to draw a staff on a page, and you want to use the Pencil and Pen tools to draw on that staff. The drawing will be much easier to edit if you first Merge the staff into the background layer. That way, you'll be able to perform edits without accidentally selecting and editing the staff itself.

Creating manuscript paper: You can create custom manuscript paper by using Ink annotations to design the page layout, then merging them to make them permanent. Use the Rastrum tool to draw staves, add Symbols for clefs if desired, and use the Grid for proper alignment. Once everything is positioned correctly, merge all these annotations so they become an integral part of the page. You can then copy this page to create multiple pages of custom manuscript paper, or use it as a template for your compositions.

Because a merge operation cannot be undone, you'll be prompted to confirm before the operation is performed.

7.7 Page Ring: Magnify

Magnify a portion of a page.

Drag out from the Magnify cell to reveal a panel that displays a zoomed-in view of the page at the current touch point. Touch any page in the score and the magnifier panel updates in real time, showing both the PDF content and any annotations at the touched location.

The Panel's Zoom: slider adjusts the magnification level from 0.25x to 5x.

Magnify panel
Magnify panel showing a zoomed-in view of the score at the touch point (Dark theme)
The Magnify tool is especially useful when annotating. It allows you to see a zoomed view around the pointer when, for example, placing an ornament in a score or when free drawing with the pen or pencil.
Use Magnify with Ink ring tools for increased accuracy
Use the Magnify tool with Ink ring's annotation tools for increased accuracy
↑ Back to Table of Contents

Chapter 8: App Ring

Application information and display settings.

App Ring menu cells
App Ring menu cells

App Ring Cells:

About: Application version, release notes, credits, and license information.

Storage: Manage Podium's browser storage.

Guide: Opens this guidebook.

Theme: Toggle between light and dark display themes.

Screen: Toggle full screen mode.

8.1 App Ring: About

A tabbed panel providing application information.

About panel Version tab
About panel showing the Version tab

About Tab:

Shows the application's version number and provides links to:

Release Notes Tab:

Shows all release notes for Podium version history.

Credits Tab:

Lists the open source projects Podium is built on.

License Tab:

Official copyright and license statement (GNU Affero General Public License v3).

8.2 App Ring: Storage

Manage Podium's browser storage.

Storage panel
Storage panel

The Storage Panel provides buttons to manage data that Podium stores in the browser:

Where available, the panel also displays a refreshable set of storage statistics useful for developers.

Privacy: If you share a browser with other users, use the factory reset buttons to clear information you don't want to share after your session. This includes recent file lists, shared buffer contents, and menu settings. Note that the web app and the browser extension maintain separate storage; if you use both, you must use these reset buttons in both environments to clear all your data.

8.3 App Ring: Guide

Opens this guidebook in the app. The guidebook is fetched from the web, so an internet connection is required. In the browser extension, the guidebook opens in a new tab. To save it for offline reading, open it in a new window and use your browser's Save Page feature (typically Ctrl+S or Cmd+S) to download it with all images and videos.

8.4 App Ring: Theme

Toggles between light and dark display themes. The current theme is stored and persists across sessions.

8.5 App Ring: Screen

Toggles full screen mode. Alternatively, toggle full screen by swiping left ⇄ right on the background. On iPhone/iPad, the swipe gesture can only exit full-screen; use this button to enter.

↑ Back to Table of Contents

Chapter 9: More Ring

Musician's toolkit.

More Ring menu cells
More Ring menu cells

More Ring Tools:

Metronome: Animated metronome with simulated conductor patterns.

Stopwatch: Practice timer with split times for tracking practice sessions.

Clock: Wall clock displaying current time and date.

Piano: Playable piano keyboard with tuning features and pitch detection.

Review: Audio/video recording with waveform/spectrogram display and instant replay.

Volume: Master volume control slider for all audio playback.

Since all More Ring cells exist solely to provide panels, the touch action, an alternative to dragging, automatically opens the panel and positions it near its icon for convenient access.

9.1 More Ring: Detached Panels

Simplify layout by detaching panel contents.

Detached panels
Detached panels on background

The graphical contents of the Metronome, Stopwatch, Volume, and Clock Panels can be detached from their panels by dragging onto the background.

Reposition detached panels by touch-dragging.

To hide a detached panel, simply fling it.

To close and delete a detached panel, drag out the panel from the menu again, then tap the panel's X button.

9.2 More Ring: Metronome

Animated metronome with simulated conductor.

Metronome panel
Metronome panel with conducting pattern

Use the buttons to play/pause the metronome and the slider to set beats per minute.

Use the dropdown list to change the graphic from traditional metronome to conducting pattern, with six different beat patterns.

Metronome dropdown options
Metronome display options, showing detached panels

When the metronome is detached, the tempo is displayed on the pattern itself. In the diagram above, the left pattern shows 60 bpm and displays a fermata symbol indicating it is paused, while the right pattern shows 167 bpm and is actively playing.

While detached, long-press to play/pause. You can change the tempo by tapping on the pattern at the desired frequency.

Hiding the panel by flinging (detached or not) keeps the metronome playing in the background. To stop and close the metronome, tap the X button—this effectively deletes the panel. The next time you drag out the Metronome cell, the panel is recreated from scratch.
The conducting patterns are experimental: due to the complexity of the animation, expect some misalignment between the pattern and the animation, particularly on slower devices, and at faster tempos.

9.3 More Ring: Stopwatch

Timer for your practice sessions.

Stopwatch panel
Stopwatch panel showing controls and split times

The stopwatch displays split times with the latest split first. If the list scrolls off the panel, drag the lower-right corner to resize the panel.

The stopwatch is fully functional when detached: touch the middle button to start/stop, the left button to reset, and the right button to record a split. To see the split times, you'll need to view the whole panel—simply drag out from the menu cell again.

Hiding the panel by flinging (detached or not) keeps the stopwatch running in the background. To stop and close the stopwatch, tap the X button—this effectively deletes the panel. The next time you drag out the Stopwatch cell, the panel is recreated from scratch.

9.4 More Ring: Clock

Wall clock displaying the current time and date, using the platform's default time zone. Useful for keeping track of time during practice sessions without leaving Podium.

The clock can be detached and positioned anywhere on screen.

9.5 More Ring: Piano

Playable piano keyboard with tuning and pitch detection features.

Piano panel
Piano keyboard with controls

Drag left ⇄ right from the 8va button to widen/narrow keyboard range to a maximum of F1-F6, or minimum of E3-A4.

Multiple notes can be played simultaneously using multiple fingers, including chords and intervals, up to the polyphony limit set in Settings: Timbre (see below). Podium supports as many simultaneous notes as you can play; in practice, real-world touch screens typically recognize no more than 5 simultaneous touches.

Piano samples make up a significant portion of Podium's download size. For this reason, the maximum keyboard size is limited to 5 octaves, a common size for an 18th century harpsichord or pianoforte. Samples have been truncated and down-sampled, reducing size while maintaining (hopefully) acceptable audio quality.

Sustain Mode: Identified by the standard piano pedal symbol. In sustain mode, notes continue to sound even after the key is released. Note however that piano notes only last for a maximum of a little over 2 seconds. Podium is not a sophisticated audio workstation.

Autorepeat Mode: Tap the Autorepeat Mode button to toggle autorepeat mode. When enabled, key presses automatically repeat at intervals (2.5 seconds for piano samples, 5 seconds for tuning fork timbre; see Settings: Timbre below), allowing you to hear sustained notes for easier tuning.

For traditional tuning using the "beats" method, use Autorepeat Mode with Tuning Fork timbre. For electronic tuning assistance, use the Pitch Detector described below.

Pitch Detector: Identified by a tuning fork icon. Tap the Pitch Detector button to toggle pitch detection on/off. When on, a YIN-based pitch detector attempts to estimate the closest piano note to what it hears in the microphone. It overlays a whole note (semibreve) on the corresponding key, plus shows the number of cents deviation from that key's expected pitch. The opacity of the whole note reflects the algorithm's confidence; the symbol becomes more transparent as confidence decreases. The expected pitch is affected by the Settings Pitch setting (see below), but not by the Temperament setting, i.e., it's the deviation from equal tempered tuning regardless of Temperament setting.

The pitch detector is monophonic: it works best with a single note at a time. When multiple pitches or unpitched sounds (such as speech or noise) are present in the microphone input, the detector will produce unreliable results.
iPhone/iPad: Due to audio system constraints on these devices, the microphone indicator will remain active after the pitch detector is turned off. This is expected behaviour — the microphone is kept open in the background to prevent interruption of piano and metronome audio. The microphone is fully released when the Piano panel is closed.
Piano pitch detector
Pitch detector showing detected note and cents deviation

Settings: Tap the Settings button to open/close the Settings Panel. Once open, you can close it by flinging. This internal panel is always enclosed by the keyboard: drag horizontally to reposition. It has 3 tabs:

Piano settings panel
Piano settings showing Pitch, Temperament, and Timbre tabs
The tuning and pitch detection tools are provided for reference purposes and may not be suitable for professional instrument tuning.
Most options include links to explanatory web articles. To select an option, tap the option name itself rather than the link.

9.6 More Ring: Review

Record audio/video with instant replay.

The browser will request camera and microphone permissions when this tool is first used. If Podium does not find a usable camera and microphone, this tool will not run.

Monitor a device's camera and microphone, with instant replay of the last ~30 seconds (configurable).

The tool is designed for interactive use only. By design, its recordings are transient and discarded when the tool is closed.

The Review panel has three tabs:

Video Tab:

Displays live video from your camera with playback controls.

Review video tab
Review panel Video tab showing live camera feed with playback controls

The Review tool records you continuously while practicing/rehearsing. If you make a mistake (or do something great!) you can immediately replay the moment for analysis.

You can let the Review run for hours without worrying about running out of memory. Behind the scenes, Podium automatically manages memory by keeping only the most recent portion of your session available for replay (typically 30 seconds to a few minutes). This ensures that you can always review your most recent performance without exhausting your device's resources.

Although this prevents your system from consuming memory, it can use a lot of battery, so works best if your device is plugged in to a power supply rather than running off battery.

At any time, the tool will be in one of two modes:

Live Mode: Audio and video are continuously recorded, and the Play button displays "Live". As described above, when the recording reaches the preset maximum, older content is automatically discarded while recording continues.

Pause recording by tapping the Pause button, and resume by tapping the Play button (labeled Live).

The scrubber will always be at the far right, with its label indicating the recording duration in seconds. This duration will skip backwards by half whenever the first half of the recording is discarded.

To enter Playback mode, drag the scrubber to the left. Playback begins at the chosen location.

Playback Mode: Recorded audio and video are played back, and the Play button's text label is "Replay".

Pause playback by tapping the Pause button, and resume by tapping the Play Button (labeled Replay).

To reenter Live mode, drag the scrubber to the right, or simply wait until Playback ends. Then tap the Play Button to restart recording. Any previous recording will be lost.

Waveform Tab:

Displays the waveform of the input from the microphone overlaid on a waterfall spectrum. Mostly useful as just something to look at when practicing scales and arpeggios!

Review waveform tab
Review panel Waveform tab showing audio visualization

Options Tab:

Configure the Review tool settings:

Review options tab
Review panel Options tab showing camera, recording, and device settings

9.7 More Ring: Volume

Master volume control for all Podium audio output (metronome, piano, review playback).

This volume control attenuates the platform's own volume setting. For best results, set the platform volume to a high value, then use Podium's volume slider to decrease to the desired level. This is especially convenient when the platform's volume controls are hard to reach, such as during a practice session in full-screen mode.

↑ Back to Table of Contents

Chapter 10: About the Author

I'm a Canadian software engineer living in Colorado. Originally a classical guitar wannabe, I studied music theory / computer music at McGill U (EMS) and Stanford U (CCRMA). After ~30 years in the software industry, I now devote way too much of my free time to various music projects.

-glen diener
glen@studiop5.org

↑ Back to Table of Contents