Foundry

Foundry 1.0.8 · Windows and Linux

Foundry User Manual

Foundry is a digital audio workstation: you record and arrange audio, write parts with a piano roll and a drum machine, mix them with 33 built-in effects and your own VST3 plugins, and export the finished song. This manual explains every part of it, from installing Foundry to the last keyboard shortcut.

Foundry with the demo song open: the transport at the top, the arrangement in the middle, the inspector on the right and the drum machine in the panel at the bottom

Foundry with a song open. The screenshots in this manual show this demo song: drums and bass in a folder, keys through an arpeggiator, a pad, a lead and a reverb.

How to use this manual. Read Getting started first: it installs Foundry, activates your licence, tours the window and walks you through your first song. After that, use the contents below to jump to whatever you need. Sections link to each other wherever one feature works with another, and every chapter can be read on its own.

In Foundry, ? → User manual… (or F1) opens this manual in your browser; it comes with Foundry, so it works offline too.

In the text, bold names a button, menu or field exactly as it appears on screen, and key combinations are written like Ctrl+S. On Linux the keys are the same as on Windows.

Contents


Getting started

Welcome to Foundry

Foundry gives you everything needed to make a song on one screen:

Everything you do can be undone with Ctrl+Z (see Undo and redo), and everything is saved in one project file (see Projects).

What you need

Installing Foundry

Download the file for your system from your order or from the downloads page. Every version installs the same Foundry; choose the one that suits how you like to install software.

SystemFileInstall
WindowsFoundry-Setup-1.0.8.exeWindows installer
Windows, no installationFoundry-1.0.8-win-x64-portable.zipWindows portable
Ubuntu, Debian, Mint, Pop!_OSfoundry_1.0.8_amd64.debUbuntu and Debian
Fedora, RHEL, openSUSEfoundry-1.0.8-1.x86_64.rpmFedora and openSUSE
Any Linux, no installationFoundry-1.0.8-x86_64.AppImageAppImage
Linux with snapdfoundry_1.0.8_amd64.snapSnap package
Linux with FlatpakFoundry-1.0.8-x86_64.flatpakFlatpak

After installing, start Foundry and activate your licence. Until you do, Foundry runs as a demo.

Windows installer

  1. Run Foundry-Setup-1.0.8.exe.
  2. Windows may show Windows protected your PC, because the installer is not code-signed. Choose More info, then Run anyway.
  3. On the welcome page, choose Next. Read the licence agreement and choose I Agree.
  4. Choose the parts to install: Open .reel projects with Foundry (so double-clicking a project opens it) and Desktop shortcut are optional.
  5. Keep the suggested folder, %LOCALAPPDATA%\Programs\Foundry, or choose another, then choose Install.
  6. Leave Start Foundry ticked and choose Finish.

Foundry installs for your Windows account only, so it needs no administrator rights, and it appears in the Start menu. To remove it, open Settings → Apps → Installed apps, find Foundry and choose Uninstall. Uninstalling keeps your projects, settings and presets (see Where Foundry keeps its files).

Windows portable

The portable version needs no installation and leaves nothing behind on the computer.

  1. Unzip Foundry-1.0.8-win-x64-portable.zip anywhere: your documents, another drive, or a USB stick.
  2. Open the unzipped folder and run Foundry.exe.

Its data folder, beside Foundry.exe, holds all its settings, recent projects, autosaves, templates, presets and its licence, so you can move or copy the whole folder to another computer and carry on. Keep the folder together: Foundry.exe does not work on its own. Windows may warn about it on first run in the same way as the installer.

Ubuntu and Debian

In a terminal, in the folder where you downloaded the file:

sudo apt install ./foundry_1.0.8_amd64.deb

apt also installs anything Foundry needs. Foundry appears in your application menu, the foundry command starts it, and .reel projects open in it when you double-click them. The package includes the security profile that Ubuntu 23.10 and later need for Foundry's window sandbox, so it simply starts.

To remove it: sudo apt remove foundry. Your settings in ~/.config/Foundry are kept.

Fedora and openSUSE

sudo dnf install ./foundry-1.0.8-1.x86_64.rpm

On openSUSE, use sudo zypper install ./foundry-1.0.8-1.x86_64.rpm. As with the .deb, this adds Foundry to the menu, the foundry command and .reel files. The package is not signed, so it installs as a local file without a signature check.

To remove it: sudo dnf remove foundry (or sudo zypper remove foundry).

AppImage

The AppImage is one file that runs on almost any Linux without installing:

chmod +x Foundry-1.0.8-x86_64.AppImage
./Foundry-1.0.8-x86_64.AppImage

You can also double-click it after making it executable. It needs FUSE, which desktop Linux has; on a minimal system, install fuse3. On Ubuntu 23.10 and later an AppImage cannot use Chromium's window sandbox, so Foundry starts without it and says so; plugins still run in their own protected processes. On Ubuntu, the .deb keeps the sandbox and is the better choice.

Snap package

sudo snap install --dangerous --classic foundry_1.0.8_amd64.snap

--dangerous is needed because the file is not from the Snap Store; --classic lets Foundry reach your plugins, JACK and audio devices like a normal application. Foundry appears in the menu and as the foundry command. To remove it: sudo snap remove foundry.

Flatpak

If Flathub is not set up on your computer yet, add it first, then install Foundry:

flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
flatpak install --user Foundry-1.0.8-x86_64.flatpak

The first installation downloads the runtime Foundry runs on. Start Foundry from the menu, or with flatpak run io.github.artofscripting.Foundry. The Flatpak can see your home folder, the plugins installed on the system (see Plugins on Linux) and your audio and MIDI devices. To remove it: flatpak uninstall --user io.github.artofscripting.Foundry.

Updating Foundry

When Foundry starts, it checks download.artuststudios.com for a newer version. If there is one, Foundry 1.1.0 is available (for example) appears in the status bar; click it to open the downloads page. Nothing is downloaded or installed for you. To turn the check off, open the help (?) and untick Check for a new version when Foundry starts; ticking it again checks straight away.

Install the new version over the old one, the same way you installed it: run the new installer, or apt install, dnf install, snap install or flatpak install the new file. Your projects, settings, presets and licence are kept. For the portable version, copy the new version's files over the old folder, keeping its data folder.

Your licence

Foundry needs a licence to save and export. Your licence is for you, on every computer you use for your own music, and it never expires.

The demo

Without a licence, Foundry is a demo: every feature works, but you cannot save projects or templates and you cannot export anything (audio, stems, MIDI files or drum files). Autosave is off too. The Demo · Licence… button in the top bar reminds you, and Foundry tells you when an action needs a licence.

Use the demo to try everything with your own plugins, sound card and controllers before you buy. Choose Licence… → Buy Foundry to open the store.

Activating with your key

Your licence key looks like FDRY-XXXXX-XXXXX-XXXXX-XXXXX. It is in your order email, and under My Account → Foundry licence on the Foundry website.

The Licence dialog with the key field, Activate, Import licence file and Buy Foundry
  1. Choose Licence… (or Demo · Licence…) in the top bar.
  2. Type or paste your key. Upper or lower case, spaces and missing dashes do not matter.
  3. Choose Activate.

Activating needs the internet once. Foundry then keeps a signed licence file on the computer and never needs the internet again: it works offline from then on. The dialog shows who the licence belongs to.

Activating a computer without internet

For a studio computer that is never online:

  1. On any device with internet, sign in to the Foundry website and open My Account → Foundry licence.
  2. Choose Download licence file. You get a file named Foundry.foundrylicence.
  3. Copy it to the offline computer, for example on a USB stick.
  4. In Foundry, choose Licence… → Import licence file… and pick the file.

Licences on several computers

Activate each computer you use for your music with the same key, online or with the licence file. There is no limit on the number of computers. Licence… → Remove from this computer takes the licence off a computer you no longer use, and My account… opens your account page.

If an order is refunded, its licence is withdrawn: Foundry removes it the next time it starts with an internet connection.

A tour of the window

The top bar: project buttons, Import, Export, Audio, Licence, Undo and Redo, then the MIDI menu, Inspector and Help

The top bar

From left to right:

The transport

The transport: Stop, Play, Record, recording settings, Punch, Click, Loop, Return, Ref and Panic, the Go to box, the position display, Tempo, Time, Tempo map and the Master level

The arrangement area

The arrangement fills the middle of the window: one row per track, with the track headers on the left and the tracks' clips on a shared timeline. Its toolbar adds tracks, chooses the editing tool and holds the editing buttons. See Tracks and The arrangement.

The inspector

The inspector on the right shows the selected track's settings: its MIDI effects (on a MIDI track), its Track effects with its output, sends and start time, and the Desktop VST3 panel for plugins. See Built-in effects, MIDI effects and VST3 plugins. Hide or show it with Inspector or I.

The bottom panel

The panel at the bottom has two tabs:

Drag the bar above the tabs to make the panel taller or shorter. ⧉ Editor and ⧉ Mixer move the panel into a window of its own, for a second monitor. See Pop-out windows.

The status bar

The bar along the bottom of the window shows details of the project and the selected track on the left (tracks, pads, steps, tempo), and Foundry's latest message on the right: what an action did, or why it could not. When the selected audio clips past full scale, a Clipping — click to normalize button appears there.

In the desktop app, the far right shows the engine load: CPU 23% is how much of each audio block the audio engine spends working. It turns brass above 70 %, and red above 90 % or for a few seconds after a dropout. When the audio driver reports dropouts (gaps in the sound), it counts them, for example CPU 41% · 2 dropouts. Click it to reset the count. If dropouts keep happening, see Crackles or dropouts.

The window's title shows the project's name, with • while there are unsaved changes, and (demo) in the demo.

Your first song

This walkthrough makes a short song from scratch and touches each main part of Foundry. Each step links to the full explanation.

  1. Start a project. Choose New. Set Tempo to the speed you want, for example 100 BPM. See Tempo and time signature.
  2. Add drums. Choose + Drums in the arrangement toolbar. The drum machine opens in the bottom panel: click steps on the Kick, Snare and Closed Hat rows to build a beat. Press Space to hear it, and again to stop. See The drum machine.
  3. Add a bass line. Choose + MIDI. The piano roll opens: set Key and Scale to your key, tick Lock, and click in the grid to draw notes. Drag a note's right edge to make it longer. See The piano roll.
  4. Add chords. Add another MIDI track, set Chord to Triad, and click once for each chord: Foundry builds the right chord for each step of the scale. See Drawing chords.
  5. Add audio. Choose Import…, pick a folder of samples or recordings, and import one, or press Record to record one. See Importing and Recording audio.
  6. Arrange. Drag clips along their tracks; copy a bar of drums with Ctrl+C and paste it further on with Ctrl+V. See The arrangement.
  7. Loop a section while you work on it: hold Shift and drag across the ruler above the tracks. See Loop markers.
  8. Mix. Open the Mixer tab, set the levels and pan, and add an effect such as Reverb to a track from Track effects. See The mixer and Built-in effects.
  9. Save. Press Ctrl+S and choose where to keep the project. See Projects.
  10. Export. Press Ctrl+E, choose The mix, a format and a loudness, and choose Export. See Exporting audio.

↑ Contents

Projects and files

Projects

A Foundry project is one .reel file that holds the whole song: every track and its settings, all the audio (stored losslessly, as 32-bit float), MIDI notes, drum patterns and pad samples, effects and plugin settings, automation, markers, loop markers, the tempo map, and where you were working (the playhead and the selected track). Copy the file and you have copied the song.

Saving and opening

Whenever something you do would lose unsaved changes (opening another project, starting a new one, closing the window), Foundry asks first. When you close the window it offers Save, Don't save or Cancel.

Saving is safe: Foundry writes the new file completely before replacing the old one, so a crash during a save never damages your project. A project can hold up to 4 GB.

If your sound card runs at a different sample rate from the project, Foundry converts the project's audio when it opens it, and says so.

Opening projects with plugins

VST3 plugins run code on your computer, so when a project uses plugins Foundry lists them, by name and file, and asks before loading them. Choose Open without plugins to open everything else. Plugins that you decline, that are missing or that fail to load are left out, and the status bar says how many. See VST3 plugins.

Autosave and recovery

While a project has unsaved changes, Foundry saves a recovery copy every minute (for projects with less than 1 GB of audio). If Foundry or the computer stops before you save, the next start offers to recover the project. Recovering does not overwrite your file: Save then saves to the original project.

Autosave is off in the demo.

Undo and redo

Undo (Ctrl+Z) and Redo (Ctrl+Y) cover everything that changes the song: edits, effect and mixer settings, tracks added or removed, automation, markers, tempo changes and plugin chains. Foundry keeps the last 100 steps. A fader or knob move counts as one step when you let go, however far you dragged it. Opening a project starts a fresh history.

Templates

A template is a starting point for new songs: your usual tracks, routing, sends, effects, plugins with their settings, instruments and drum kits.

The Templates dialog

Saving a template needs a licence (see The demo).

Where Foundry keeps its files

Your projects are saved wherever you choose. Foundry's own files (recent projects, autosaves, templates, plugin presets, your licence and the plugin crash log) are kept in its settings folder:

FoundrySettings folder
Windows (installed)%APPDATA%\Foundry
Windows portablethe data folder beside Foundry.exe
Linux (.deb, .rpm, AppImage, snap)~/.config/Foundry
Linux Flatpak~/.var/app/io.github.artofscripting.Foundry/config/Foundry

Any copy of the Windows app folder becomes portable when you create a data folder beside Foundry.exe. Uninstalling Foundry never removes the settings folder.

↑ Contents

Tracks and the arrangement

Tracks

Kinds of track

TrackHoldsEdited in
Audio (∿)Audio clips: recordings, samples, frozen pluginsThe waveform editor
MIDI (♪)Notes and controller lanes, played by an instrumentThe piano roll
Drums (◎)A step pattern played by padsThe drum machine
Folder (▤)Other tracks, mixed togetherFolders

Any track can also receive other tracks and work as a bus, and a track that only receives sends is a return. See Routing and buses.

Adding tracks

The arrangement toolbar adds tracks below the others:

Importing files and recording also add tracks.

Track headers

Track headers: number, colour swatch, name, A and remove on the first line; mute, solo, volume and pan on the second

Each track's header has two lines.

First line:

Second line:

Every slider and value in Foundry goes back to its default when you right-click it twice. See Resetting a control.

Colours and icons

Click a track's colour swatch to choose one of 16 colours, or Auto for the automatic one, and an icon for the instrument (vocals, guitar, keys, drums, strings and more). The colour is used everywhere the track appears: its lane and clips, the mixer, and the automation and takes windows.

Finding tracks

Type in Find tracks (Ctrl+F) in the arrangement toolbar to show only the tracks whose name matches; folder names are searched too. Enter selects the first match and Esc clears the search.

Folders

A folder groups tracks so they play through one fader and one set of effects, and so you can fold them away.

  1. Select a track, or drag a range across several tracks.
  2. Choose Folder in the arrangement toolbar.

The folder is added above the tracks, and they now play into it: they are indented under it, the folder's lane shows their content, and the folder's volume, pan, effects, sends, mute and solo apply to all of them. Folders can be nested. To take a track out of a folder, set its Output to Main or another track (see Routing and buses). Removing a folder sends its tracks back to Main.

Where a track starts

Every track has a start time. Drag a track's content with Shift held to move the whole track, or type the time in Start (in seconds) in the inspector. See Moving clips and regions.

The arrangement

The arrangement: the toolbar, the ruler with markers and the loop band, and the tracks with their clips

Moving around

The ruler

The ruler with bar numbers, the playhead, markers and the loop band from bar 9 to bar 13

The ruler above the tracks shows the bars, and:

Snap

The Snap menu sets the grid that edits lock to: None, Measure, Beat, 1/2 beat, 1/4 beat, 1/8 beat, or triplets (1/3 beat, 1/6 beat). With Snap on, the tracks show the grid, and clicking, ranges, splits and moves land on it: a moved clip starts on a grid line. Hold Alt while you drag or click to ignore the grid for that action. The grid follows the tempo map.

Arrangement tools

Choose a tool in the arrangement toolbar, or press 1 to 5 after clicking in the arrangement:

ToolKeyWhat it does
Select1Click a clip (or a MIDI or drum region) to select it, and drag it to move it. Ctrl+click adds to the selection. Drag empty space to select a time range across tracks; Shift extends it. Shift+drag on content moves the whole track.
Edit2Drag anywhere, over clips too, to select a time range. Drag a clip's left or right edge to trim it. The top edge of a clip has its fade handles and gain. See Clip gain and fades.
Split3Click a clip, or MIDI notes, to cut them in two at that point.
Erase4Click or sweep over clips, notes and drum hits to delete them.
Paint5Drag across a drum track to paint its pattern into each bar you pass over; right-drag clears them. See Painting drums in the arrangement.

Double-clicking a clip

Double-click a clip to open it in the editor below, showing only that clip:

Whole track, in the editor's toolbar, shows the whole track again.

Cut, copy and paste

These work on the selected clips, or on a time range you selected across tracks, while the arrangement was the last thing you clicked:

ButtonKey
CutCtrl+XRemoves the selection, leaving a gap, and keeps it to paste.
CopyCtrl+CKeeps a copy to paste.
PasteCtrl+VPastes at the playhead, on the selected track (and the tracks below it, for a copy of several tracks).
DeleteDeleteRemoves the selection, leaving a gap.
DuplicateCtrl+DCopies the selection to right after itself.

Every edit is one undo step. When the arrangement is not the last thing you clicked, these keys go to the editor in the bottom panel instead.

Moving clips and regions

With the Select tool, drag a clip to move it along its track. It replaces whatever it lands on. With Snap on, its start lands on the grid; hold Alt to place it freely.

MIDI and drum tracks hold regions, blocks of notes or hits that move on their own like audio clips. A track you never cut or pasted is one region. A paste becomes its own region, and splitting cuts a region in two, even between notes.

Shift+drag moves the whole track, everything on it together.

Clip gain and fades

With the Edit tool, the top edge of every audio clip has two small square handles:

Each drag is one undo step.

Crossfades

Where two audio clips meet (touching, or within 10 ms), Crossfade in the arrangement toolbar blends them smoothly over the Length beside it (30 ms unless you change it). It crossfades every boundary in the selected range, or, without a range, the boundary nearest the playhead on the selected track. Each clip reaches into its own audio to make the overlap, so nothing is lost.

Nudging

Alt+← and Alt+→ move the selected range in the arrangement one grid step (the Snap setting, or a beat); Alt+Shift+←/→ move it a bar. Audio, notes and drums all move, replacing what they land on. In the piano roll, the same keys move the selected notes. See Selecting and editing notes.

Adding bars at the start

To make room before the song, for an intro or a count-in, type a number of bars beside Add bars at start and choose it (or press Enter in the box). Everything moves later by that many bars: every track and clip, markers, loop markers, tempo changes and automation. The new bars use the song's starting tempo and time signature. It is one undo step.

Markers

Markers name places in the song: Intro, Verse, Chorus.

The Markers dialog listing four markers

Markers are kept in beats, so they stay on their bar when you change the tempo. They are saved with the project and can be undone.

Exporting markers

In the Markers dialog, choose a format and click Export:

The file is named after the project, for example My song markers.txt. Like other exports, this is turned off in the demo.

Looping

Loop (L) makes playback repeat. What it repeats:

  1. the loop markers, when you have set them;
  2. otherwise, the selection;
  3. otherwise, the whole song, up to the end of its last bar.

If the playhead is outside the loop when you press Play, playback starts at the loop's start.

Loop markers

Loop markers are a start and an end on the ruler that Loop plays between, so you can repeat a section while you work on it.

The band is brass while Loop is on, and grey while it is off. Changing the loop while playing takes effect at once. Loop markers are saved with the project, can be undone, follow tempo changes, and move with Add bars at start.

Return

With Return on, pausing puts the playhead back where playback started, ready to play the same part again. With it off, the playhead stays where you paused. ■ always goes back to the very start. Foundry remembers the setting.

Playing and stopping

ControlKeyWhat it does
PlaySpacePlays from the playhead; pressing it again pauses.
■Stops and goes back to the start.
RecordRRecords; Space or Record stops. See Recording audio.
Home / EndGoes to the start or end of the song, or of the selection.
← / →Moves the playhead a little (with Shift, further).

You can change almost anything while the song plays (levels, effects, notes, clips, the tempo) and hear it at once. Playback does not stop.

The position display shows where you are as bar.beat.16th (5.1.1 is the first beat of bar 5), with the time and the song's length beside it.

Going to a bar or time

Click the Go to box (or press G), type a bar (17), a bar and beat (17.3) or a time (1:23.5 or 83s), and press Enter.

Tempo and time signature

Tempo sets the speed in beats per minute (20 to 300, with up to two decimals), and Time sets the time signature: beats per bar (1 to 32) over the beat unit (2, 4, 8 or 16). These are the song's starting values; changes later in the song go in the tempo map.

Tap tempo

To set the tempo by feel, tap Tap beside Tempo in time with the music (or with a song in your head). After four taps the tempo follows your taps: Foundry averages the last eight, so a wobble settles as you keep going, and steady tapping earns a decimal place. Pause for two seconds to start a fresh count. Each change is one undo step. Map Tap to a pad with MIDI Learn to tap from your controller.

MIDI notes, drum steps, markers and the grid are kept in beats, so changing the tempo makes them play faster or slower. Audio clips stay where they are in time; use Stretch to fit audio to a new tempo, or beat detection to find an audio file's tempo.

The tempo map

Tempo map… lists tempo and time-signature changes later in the song.

The Tempo map dialog with one change at bar 5
  1. Put the playhead in the bar where the change should start.
  2. Choose Tempo map…, then Add a change at the playhead.
  3. Set its Bar, its BPM, and if you like a new time signature. Leave a field empty to keep what was there before. × removes a change.

Changes start on a bar line, and the ruler shows each one in brass. MIDI notes, drums, markers, the grid, bar numbers and controller lanes follow the map everywhere: in playback, in exports and in MIDI files. Plugins are told the tempo and bar at each point. Audio clips stay where they are. The built-in tempo-synced delays use the starting tempo.

The metronome

Click (C) plays a click on every beat, higher on the first beat of each bar, following the tempo map (a 6/8 bar clicks in eighths). In the recording settings (⚙) you choose whether it plays Whenever it is on or Only while recording, its Level, and a Count-in of one or two bars before recording. The click is never exported.

↑ Contents

Editing

Audio tracks and clips

An audio track holds clips. A clip is a window onto a piece of audio: where it starts, which part of the audio it plays, its gain and its fades. Cutting, moving, trimming, splitting and copying only change those windows, never the audio itself, so they are instant at any length, nothing is ever lost, and copies of a clip share the same audio. Only the processing commands (gain, fades, normalize, reverse, stretch) write new audio, and only for the part they change.

In the arrangement, each clip is drawn as its own block; see Moving clips and regions, Clip gain and fades and Crossfades. The waveform editor below works on the selected track in detail.

The waveform editor

Select an audio track and the bottom panel's Editor tab shows its waveform, left channel above right, with the bars along the bottom and clip boundaries marked in teal.

The waveform editor with the lead track, its toolbar with View, Edit and Process

Selecting audio

With Snap on (see Snap), selections lock to the grid; hold Alt to select freely.

Editing audio

ButtonKeyWhat it does
CutCtrl+XRemoves the selection and closes the gap; keeps it to paste.
CopyCtrl+CKeeps a copy of the selection.
PasteCtrl+VInserts at the playhead, or replaces the selection. Later audio moves along.
DeleteDeleteRemoves the selection and closes the gap.
TrimTKeeps only the selection.
SplitSCuts the clip in two at the playhead, or at both edges of the selection, so the parts can be moved on their own.
Detect beatFinds the track's tempo. See Beat detection.

Unlike the arrangement's cut and paste, these close and open gaps: the rest of the track moves along.

To move audio within the track without moving the rest, drag inside the selection to where it should go; hold Ctrl to copy it there instead. The audio it covers is replaced, and silence is left where it was, so everything else keeps its timing.

Processing audio

These work on the selection, or on the whole clip when nothing is selected:

Stretch

Stretch… time-stretches and pitch-shifts the selection, or the whole track.

The Stretch dialog

The result replaces the audio, later audio on the track moves to follow, and Undo brings the original back.

Beat detection

After you import audio, Foundry offers to detect its beat (and asks which track, when you imported several). Detect beat in the editor's toolbar runs it again on the selected track.

It listens to the first two minutes and estimates the tempo and where the first beat is, then offers to set the song's tempo to it and shift the track so its beats land on the grid. If the tempo it found feels twice too fast or too slow, use ½× or 2×. Applying it is one undo step, and turns Snap to Beat if it was off.

It works best on music with clear drums or other sharp attacks, and assumes the tempo stays steady. It finds beats, not the start of each bar, so you may need to nudge the track by a beat or two to put bar 1 in the right place (see Nudging).

The piano roll

Select a MIDI track and the Editor tab shows the piano roll: pitches up the side with a keyboard, time across, and the track's notes as bars.

The piano roll showing the keys clip, with A minor highlighted, and its toolbar

Opening one clip

Double-click a MIDI clip in the arrangement to open just that clip: its notes are framed and selected, the rest of the track is shaded, and CLIP shows in the corner. Selecting, quantizing and the other commands then work on that clip only, and new notes can only be drawn inside it. Whole track shows the whole track again.

Piano roll tools

ToolKeyWhat it does
Select1Click or drag a box to select notes; drag them to move, drag an edge to resize.
Edit2Draw notes. Right-click a note, or right-drag across several, to delete. Shift+drag selects with a box.
Erase3Click or sweep over notes to delete them.
Velocity4Drag notes up or down to change how hard they play, or draw across the velocity lane at the bottom. See Velocity.
Slice5Click a note to split it at the grid line.

The number keys work while a MIDI track is selected, unless the arrangement was the last thing you clicked. Foundry remembers the tool you chose.

Drawing notes

With the Edit tool:

  1. Click in the grid to add a note at that pitch and time. It snaps to the grid.
  2. To make it longer, keep the mouse button down and drag to the right before you let go, or drag the note's right edge later.

You hear each note as you draw it.

New chooses what a click draws:

Selecting and editing notes

Key and scale

Choose a Key and a Scale (major, natural, harmonic and melodic minor, the modes, major and minor pentatonic, and blues) to see the key in the grid: the rows of the key note are brass, the other notes of the scale are teal, the rest are dimmed, and notes outside the key get a red edge.

New MIDI effects start in the key and scale chosen here.

Drawing chords

Chord draws a whole chord with each click:

Dragging while you draw sets the length of the whole chord. Single note goes back to drawing one note at a time.

Quantize and humanize

Quantize (Q) moves the selected notes (or all notes) to the grid; with Snap off, to sixteenths.

Humanize (H) does the opposite: it gives the selected notes (or all notes) small random changes in timing and velocity. Amount sets how much: at 100 % notes move up to ±30 ms (at 120 BPM) and up to ±24 in velocity. Pitches and lengths stay the same.

Each press is one undo step, and Foundry remembers these settings.

Velocity

Velocity is how hard a note is played, from 1 to 127; notes are drawn brighter the harder they play. With the Velocity tool:

Controller lanes

The Lane menu chooses what the lane at the bottom of the roll shows: Velocity, or a controller to draw: Pitch bend, CC 1 Modulation, CC 7 Volume, CC 10 Pan, CC 11 Expression, CC 64 Sustain, CC 71 Resonance and CC 74 Brightness.

Plugin instruments and MIDI Out receive the controllers, and MIDI files keep them. The built-in synth follows pitch bend (±2 semitones), volume and expression. Recording MIDI records controller moves into these lanes.

MIDI effects

A MIDI track's notes can pass through up to eight MIDI effects before they reach the instrument. They change what is played, not what is written: the piano roll and Export MIDI keep your notes as you wrote them, while playback, plugin instruments, MIDI Out and exports hear the result.

The MIDI effects section with an arpeggiator

Select a MIDI track, choose an effect under MIDI effects in the inspector and choose Add MIDI effect. The notes pass through the effects from top to bottom. On each effect, On switches it off and on, ↑ and ↓ reorder, and × removes it. Every change is one undo step and is heard at once. Notes you play live on a MIDI keyboard are not processed.

A new effect starts in the key and scale chosen in the piano roll; change its Key and Scale to use another.

Arpeggiator

Plays the notes you hold one at a time, on a beat grid.

Chord

Adds a chord above every note.

A note outside the key plays as written, with the chord of the nearest scale note added.

Note repeat

Repeats every note on a beat grid for as long as it is held, like a drum machine's note repeat. Rate sets the grid, Gate the length of each repeat, and Fade per repeat how much quieter each one is.

Velocity effect

Reshapes the velocities: Curve (above 0 lifts soft notes, below 0 softens them), Lowest and Highest (the range they are fitted into), and Random ± (a random change for each note).

Instruments

The built-in synth

Every MIDI track plays the built-in synth unless the first slot of its plugin chain is a plugin instrument. Choose its sound in Instrument in the piano roll's toolbar: Triangle, Sine, Square or Saw. It follows pitch bend, volume and expression lanes.

The sampler

The Sampler instrument plays an audio sample across the keyboard.

  1. Set Instrument to Sampler, then choose Sampler….
  2. Choose Load sample… and pick a sound from the sample browser or a file.
  3. Set the Root note: the key that plays the sample as it was recorded. Each key above or below plays it faster and higher, or slower and lower.

Attack, Decay, Sustain and Release shape each note, and notes ring on for their release. Loop while a note is held repeats the part of the sample between the two percentages for as long as you hold a note, for sustained sounds. Level sets the volume, and ▶ plays the root note. Pitch bend, volume and expression lanes apply. The sample is saved in the project.

Plugin instruments

A VST3 instrument goes in the first slot of a MIDI track's plugin chain, and then plays the track's notes and controllers live. See VST3 plugins.

The drum machine

Select a drum track and the Editor tab shows its step sequencer: one row per pad, one column per sixteenth note.

The drum machine: kick, snare and closed hat rows with their pad controls, and the drum toolbar

Programming a beat

Pads

Each pad has, from left to right:

Add pad adds another pad.

Velocity and chance

Drag a lit step up or down to change what Drag edits chooses:

Hold Shift for fine steps. New variation rolls the dice again for every step with a chance below 100 %. Playback and exports always play the same variation until you choose New variation.

Swing

Swing (50 % to 75 %) delays every second sixteenth: 50 % is straight, 66 % a triplet shuffle.

Long patterns and drum clips

A drum track repeats its pattern, but as soon as you cut, copy or paste across it in the arrangement, it becomes one long pattern that sounds the same, so each bar can then be changed on its own. Patterns can be up to 16,384 steps (1,024 bars of 4/4). Patterns longer than 128 steps show 8 bars at a time: ◀ and ▶ move through them, and the page follows the playhead while playing.

Double-click a drum clip in the arrangement to show only its steps; Whole track shows the whole pattern again.

Painting drums in the arrangement

The arrangement's Paint tool (5) copies a drum track's pattern into bars: drag across the drum track's lane and the pattern is painted into every bar you pass over, lined up with the track's start. Right-drag clears those bars. This is the quickest way to fill a song with a beat and then leave gaps for breaks.

Saving and sharing drum tracks

↑ Contents

Recording

Recording audio

Foundry records while the song plays, so you can play along with what is already there. Takes are recorded losslessly and lined up with the song automatically.

  1. Choose ⚙ beside Record and pick your Input and whether to record Mono or Stereo. See Recording settings.
  2. Put the playhead where you want to start. Turn on the metronome or a count-in if you want one.
  3. Choose Record (or press R). The song plays and the input meter shows your level: keep it out of the red.
  4. Choose Record again, or press Space, to stop.

By default the take goes on a new audio track. To record onto an existing track instead, choose Onto the selected audio track in the recording settings and select the track first. The new take replaces what it covers. Earlier takes on the track are kept (see Takes and comping), and Undo brings back what was there.

When a MIDI track is selected, Record records MIDI instead. See Recording MIDI.

Recording settings

The Recording settings dialog: input, channels, where takes go, latency fix, monitoring and the metronome

Echo cancellation, noise suppression and automatic gain are always off, so you record exactly what comes in.

Punch recording

To re-record only part of a take:

  1. In the arrangement, select the range to replace, with the Edit tool or by dragging empty space with Select.
  2. Turn on Punch.
  3. Choose Record. Playback starts a bar early so you hear the lead-in, and the take is cut to exactly the range you selected.

Loop recording

With Loop on, keep recording round the loop: every pass is recorded as a take of its own, all on one track. Record several attempts in one go, then choose the best parts in the takes window. With Punch on as well, each take is cut to the selected range.

Takes and comping

Every recording onto a track is kept as a take, and the newest one plays. T on the track's header (it appears once a track has takes) opens the takes window: the comp, what plays, on top, with each take under it.

Coloured bars show which take each part of the comp comes from. Each change is one undo step, with short crossfades at its edges so the joins are smooth. Takes are saved with the project.

Lining up takes

Foundry lines up every take with the song as it records, and removes the delay of your input and output that it knows about. If your takes still sound slightly late (some audio interfaces report their delay wrongly), record a click or a clap along with the metronome, see how far it lands after the beat, and enter that in Latency fix.

Recording MIDI

  1. Connect your MIDI keyboard and choose it as MIDI In in MIDI ▾ → Devices…. See MIDI devices.
  2. Select a MIDI track. With Thru on, what you play is heard through the built-in synth.
  3. Choose Record MIDI in the piano roll's toolbar, or the main Record button. The song plays, and the notes you play land on the track at the playhead.
  4. Stop with Record MIDI, Record or Space. The take becomes one undo step.

Controllers you move while recording (modulation, sustain, pitch bend and others) are recorded into the track's controller lanes.

↑ Contents

Mixing

The mixer

Choose the Mixer tab at the bottom (or ⧉ Mixer to open it in a window of its own). Every track has a channel strip, followed by the VCA groups and the Master strip.

The mixer: a channel strip for every track, a VCA and the master strip with a limiter

Each strip has, from top to bottom:

Faders and knobs are heard while you drag them, and each move is one undo step when you let go. A selected track's strip is outlined in its colour.

Mute and solo

M silences a track. S plays only the soloed tracks, together with what they need to be heard: a soloed track keeps playing through its folder or bus, and a soloed bus plays everything routed into it. Several tracks can be soloed at once.

Meters

Every track has a stereo level meter, in its header and in its mixer strip, and the master has one on its strip and beside the transport's Master level. Meters run from −60 to +6 dB, hold their peak for a moment, and get a red edge when the signal clips. The compressor, limiter, gate, de-esser and multiband compressor also show their gain reduction while playing.

Resetting a control

Right-click any slider, number box or menu twice to put it back to its default: track and mixer volume and pan, effect settings, the Master level and plugin parameters. You hear the change, and it is one undo step.

Routing and buses

Every track plays to Main (the master) or into another track. Set it in Output in the inspector, Out at the bottom of the track's mixer strip, or Out in an effect window.

A track that receives others is a bus: what arrives is added to its own sound, goes through its effects and fader, and on to its own output. Buses can chain, for example drums into a drum bus, the drum bus into a group, and the group into Main. Folders are buses too.

Sends and returns

Besides its output, a track can send a share of its sound to another track, a return. Typically, several tracks share one reverb or delay this way, instead of each having its own.

A muted track sends nothing, and soloing a track keeps its returns playing. Sends are copied when you duplicate a track.

VCA groups

A VCA group moves the level of several tracks together without mixing their sound into one channel, so each track keeps its own effects, sends and output.

Built-in effects

Every track, and the master, has an effect chain. Sound flows through it from top to bottom.

The Track effects section with the lead's EQ, compressor and delay

Adding and editing effects

  1. Select the track.
  2. Under Track effects in the inspector, choose an effect in Effect and choose Add effect. It goes at the end of the chain.
  3. Click an effect in the chain to show its settings below it.
The EQ's settings in the inspector, with the spectrum above its sliders

On each effect:

The compressor's settings, with the sidechain key menu and the gain reduction meter

Settings change while you drag and are heard at once, even while playing. Each change is one undo step when you let go. Built-in effects and VST3 plugins can be mixed in one chain. Effects with long tails (reverb, delay) extend the song's length, so exports do not cut them off.

Presets

Every built-in effect has ten presets: 330 in all. Choose one in Preset… at the top of the effect's settings for a starting point (a vocal compressor, drum glue, a sidechain duck, a de-esser, rooms and halls, slapback and dotted delays…), then adjust it to taste.

Effect windows

⧉ Window in Track effects opens the selected track's effects and plugins in a window of their own, and ⧉ on an effect opens just that effect. Open as many as you like, for example one per track on a second monitor.

An effect window with the lead's chain and the EQ's settings

Each window is either Sticky (it stays on the track it opened with; the track menu at the top changes it) or Follow (it shows whichever track is selected; ⧉ Follow opens one). Switch between them in the window; new windows use the mode you used last. In a window you can add, reorder, bypass and edit effects and plugins, change the track's output, and use MIDI Learn and Undo. Effect windows close with the main window.

The effects

EffectWhat it does and its main settings
EQShapes the tone: low cut, low shelf, two adjustable mid bands (gain, frequency, Q), high shelf and high cut. Shows the track's spectrum while playing.
CompressorEvens out the level: threshold, ratio, attack, release, knee, makeup, mix, and a sidechain key with its own filters.
LimiterKeeps peaks below a ceiling, without ever going over it: input gain, ceiling, release.
GateSilences the sound below a threshold, for noisy recordings or tight drums: threshold, range, attack, hold, release, sidechain key.
DelayEchoes: time, or in time with the song (1/2 to 1/16, dotted and triplet), feedback, mix, ping-pong, and the tone of the repeats.
ReverbRoom and hall ambience: size, damping, width, mix, pre-delay.
ChorusThickens and widens: rate, depth, delay, mix.
FlangerA sweeping, jet-like comb: rate, depth, delay, feedback, mix.
PhaserA swirling sweep: rate, depth, feedback, mix.
DistortionDrive and grit: drive, shape (soft, hard clip, wavefold), tone, mix, output.
BitcrusherLo-fi digital crunch: bits, downsampling, mix.
FilterLow-pass, high-pass, band-pass or notch, with resonance and an LFO to sweep it.
Tremolo / Auto-panPulses the volume, or moves the sound from side to side: rate, depth, sine or square.
Stereo utilityWidth (mono to extra wide), gain, mono, and polarity invert.
Tape saturationWarm tape-style drive with gentle even harmonics: drive, asymmetry, tone, mix, output.
De-esserTames harsh "s" sounds in vocals: frequency, threshold, maximum reduction.
Multiband compressorCompresses low, mid and high bands separately: two crossovers, per-band threshold and gain.
Transient shaperMakes attacks punchier or softer, and sustain longer or shorter.
Auto-wahA filter that follows how loud you play: frequency, range, sensitivity, resonance, attack, release, mix.
Ring modulatorMetallic, bell-like tones: carrier frequency, mix.
VibratoWobbles the pitch: rate, depth, mix.
ExciterAdds sparkle by saturating the highs: frequency, drive, amount.
ClipperShaves off peaks, hard or rounded: input gain, ceiling, softness, output.
Graphic EQTen octave bands from 31 Hz to 16 kHz (±12 dB each). Shows the spectrum while playing.
Haas widenerWidens a sound by delaying one side slightly (1 to 40 ms).
Tape echoA vintage tape delay with wow, tone and drive in its repeats.
ResonatorA tuned ring, like a string sympathetically resonating: frequency, feedback, damping, mix.
Pitch shifterShifts the pitch up or down 12 semitones, plus fine tuning in cents.
Lo-fi radioThe sound of a small radio: low and high cut, drive, hiss, mix.
ExpanderMakes quiet parts quieter, to reduce background noise: threshold, ratio, range, attack, release, sidechain key.
Mid/side EQChanges the centre and the sides separately: mid and side levels, a low cut and an air shelf for the sides.
Pitch correctionPulls a voice or solo instrument to the nearest note of a key and scale: speed (instant for a robotic effect, slower for natural), amount, mix. For one voice at a time.
Trance gateChops the sound in time with the song: rate (1/4 to 1/32, with triplets), open time, depth and smoothing. The pattern starts where playback starts.

Sidechain

The compressor, gate and expander can listen to another track instead of their own: choose it in Sidechain key. The classic use is a kick that ducks a bass or pad, so the two do not fight.

Tracks that would key each other in a loop are not offered.

The spectrum analyser

The EQ and Graphic EQ show the spectrum of their track (after its effects) while playing. For a larger view, ≋ on the master strip opens an analyser window for the master or any track, from 20 Hz to 20 kHz.

The master channel

The Master strip, at the right of the mixer, is everything you hear and export.

The Master level in the transport only sets how loud you listen. It does not change exports.

Reference tracks

A reference track is a finished song you compare your mix against. Import it as a track, then tick Reference in the inspector. The track shows REF, and it is left out of your mix and your exports.

Ref in the transport (or B) plays only the reference track, straight to your speakers without the master effects; press it again for your mix. Switching while playing carries on from the same place, so you can flip back and forth. Use the reference track's fader to match its level to your mix, so you compare the sound and not the volume.

Automation

Automation changes a setting over the course of the song: a fade-in, a filter sweep, a louder chorus. Volume, pan, every built-in effect setting and every plugin parameter can be automated.

The automation window with the lead's volume rising into the chorus

Opening the automation window

Each lane shows the track's audio, notes or drum hits faintly behind the curve, so you can see where things happen.

Drawing and editing points

ToolKey
Points1Click to add a point; drag points to move them.
Range2Drag across one or more lanes to select a stretch of time; clicking moves the playhead.
✎ Draw3Draw a curve freehand.

Each lane has ● (record, see below), On/Off (keep the lane but ignore it), Clear (remove its points) and × (remove the lane).

The window zooms and scrolls like the arrangement: −, Fit, +, Ctrl+scroll and Shift+scroll. Link, on by default, keeps it in step with the arrangement's zoom and scroll.

Recording automation

  1. Choose ● on a lane to arm it.
  2. Press Play and move the setting: its fader, its effect slider, its plugin slider, or a MIDI controller mapped to it (see MIDI Learn).
  3. From the moment you move it, the lane is written with what you do, replacing what was there, until you stop. Holding still writes the held value.

Stopping commits the recording as one undo step. While a lane is armed it does not play back, so you hear the control you are moving.

Watching automation play

While playing, automated controls follow their lanes on screen in every window (faders, pan, effect sliders and plugin sliders), so each shows the value you are hearing. A control you are dragging is left alone. Automated effect settings show ⤳ in the effect's settings, and the A button lights up on automated tracks.

Automation plays the same live and in exports, and is saved with the project. Freezing a track bakes its effect and plugin automation into the audio and keeps its volume and pan automation.

↑ Contents

Plugins

VST3 plugins

Foundry hosts VST3 effects and instruments. Each track has a chain of up to 32 slots, where plugins and built-in effects can be mixed in any order. Every slot is a separate copy of the plugin with its own settings, so the same plugin can be used several times.

Plugins run code on your computer: load only plugins you trust, from their makers. Foundry never scans your plugin folders by itself; you choose each plugin.

The Desktop VST3 panel with a plugin loaded, its presets and its parameter browser

Loading a plugin

  1. Select the track.
  2. In the Desktop VST3 panel of the inspector, choose Choose trusted VST3….
    • On Windows, choose VST3 file or VST3 bundle folder (most plugins are a .vst3 file in C:\Program Files\Common Files\VST3; some are folders), then pick it.
    • On Linux, VST3 plugins are folders. Foundry first offers the usual places where they are installed (~/.vst3, /usr/lib/vst3, /usr/local/lib/vst3), then opens the folder picker there. See Plugins on Linux.
  3. The plugin is added to the end of the track's chain, under Track effects.

The Plugin menu then holds the plugin you loaded (a plugin file that contains several plugins lists each of them). Add to track adds another copy of it to the selected track, and Add to master adds one to the master channel.

An instrument can only be the first slot of a MIDI track; it then plays the track's notes. Later slots are effects.

Plugin windows

On a plugin's slot in the chain:

Foundry compensates for the delay plugins add (their latency) automatically, so every track stays lined up. Audio settings shows how much is being compensated.

Plugin parameters

Every parameter of a plugin is also listed in Foundry, however many it has, under Normalized parameter controls in the panel and in effect windows. Each is a slider from 0 to 1.

Parameter sliders can be automated and mapped to a MIDI controller.

Plugin presets

Above a plugin's parameters, type a name and choose Save preset to keep the plugin's current settings. Choose a preset from the menu to load it into the slot; Undo returns to the settings before. Delete removes the preset shown. Presets belong to the plugin, not the project, so every copy of the same plugin in every project can use them.

Freezing a track

Freezing renders a track through its plugin chain into audio. Do this to save computer power on a heavy plugin, to commit a sound, or to edit a plugin instrument's part as audio.

  1. Select the track.
  2. Set Tail (0 to 10 seconds) so effects such as reverb can ring out at the end.
  3. Choose Render / freeze chain.

The track becomes an audio track with the result, keeping its place and mixer settings, and its chain is cleared. Undo brings back the original track and its chain. A track can be frozen when it is at most 4,000,000 samples long including the tail, about 83 seconds at 48 kHz. Buses cannot be frozen.

Crash-safe plugins

Every plugin runs in a protected process of its own. If a plugin crashes, or stops responding, only that plugin goes silent: Foundry says the plugin was switched off for the session, and the rest of the song keeps playing. You can still save; the plugin keeps the settings it last saved. The next time the project opens, the plugin is loaded again.

The plugin crash log

Foundry writes down every plugin that crashes, stops responding or fails to load: which plugin, what it was doing (loading, playing, showing its window, saving its settings, freezing), how it ended, and the last things it reported. Open it with ? → Plugin crash log….

The log is a text file, plugin-crashes.log, in the logs folder of Foundry's settings folder. It stays on your computer. If a plugin keeps crashing, the log is what its maker (or Foundry's support) will want to see.

Plugins in projects

A project saves each plugin's settings, and loads the plugin again from where it was installed. Foundry asks before loading a project's plugins (see Opening projects with plugins). If you move or uninstall a plugin, projects that used it open without it.

Plugins on Linux

↑ Contents

Importing and exporting

Importing

Import… opens the sample browser, where you find, preview and import sounds. You can also drop files onto Foundry's window: each audio file becomes a track of its own.

The sample browser

The sample browser: a folder of samples with one selected, its waveform, and Import

When you choose Load on a drum pad, the browser's button becomes Load onto pad, and the browser closes once the sample is loaded.

The browser only lists folders you chose, and only the audio, MIDI and drum files in them.

What you can import

FileBecomes
Audio: WAV, FLAC, MP3, OGG, M4A, AAC, WebMAn audio track. Foundry then offers beat detection.
MIDI: .mid, .midiMIDI and drum tracks. See MIDI files.
Drum tracks: .reeldrumsA drum track. See Saving and sharing drum tracks.
Projects: .reelOpens the project. See Projects.

Audio at another sample rate is converted to the project's rate as it is imported.

Exporting audio

Export… (Ctrl+E) renders the song to audio files.

The Export dialog: what to export, the format and the loudness

A single file is saved where you choose. Several files (stems) go into one folder you choose; existing files are never overwritten (a number is added to the name instead).

Exports include every plugin and effect, rendered at full quality, along with all automation, sends and routing. The metronome, reference tracks and the transport's Master level are left out. When the export is done, the status bar reports its loudness and peak, and warns if a fixed-point file clipped (lower the track levels, use a loudness target, or put a limiter on the master).

MP3 files can be up to 48 kHz, so a project at a higher rate is exported at 48 or 44.1 kHz. Exporting needs a licence (see The demo).

MIDI files

Samples are not part of MIDI files; use Export drums to share a drum track with its samples.

↑ Contents

MIDI hardware

MIDI devices

The MIDI menu: MIDI Learn, Devices, Mappings and Mappings in own window

Choose MIDI ▾ → Devices… (it opens in a window of its own):

On Linux, MIDI devices are the system's ALSA MIDI ports.

MIDI panic

If a note keeps sounding after you let go (a lost note-off from a controller, or a plugin that got stuck), press Panic in the transport or Shift+Esc. Every plugin instrument, the MIDI Out device and the built-in synth get "all notes off" and "all sound off" on all 16 channels, and the sustain pedal is released. Playback keeps going, and later notes play as usual.

MIDI clock

MIDI Learn

MIDI Learn connects the knobs, faders, pads and keys of a MIDI controller to Foundry's controls.

Assigning controls

  1. Choose MIDI ▾ → MIDI Learn (or Ctrl+L). Controls that can be assigned get a dashed outline.
  2. Click a control in Foundry.
  3. Move a knob or fader, or press a pad or key, on your controller. It is assigned.
  4. Click the next control to keep going. Esc (or the menu again) finishes.

Right-click a control while learning to remove its assignment. MIDI Learn works in every window, including pop-out and effect windows.

What can be assigned: every button and toggle (Play, Stop, Record, Loop, Undo, Save, Export, the editors' tools…), sliders and number boxes (Master, Tempo…), menus (Snap, Time signature, the piano roll's Key and Scale…), each track's volume, pan, mute and solo, every built-in effect setting and effect bypass, and plugin parameter sliders.

Knobs, faders and pitch bend sweep the whole range of what they control; pads and keys press buttons and flip switches. Moves are heard immediately and become one undo step when the control rests. Every MIDI input is listened to, and a message that is assigned to a control does not also play notes or record.

Mappings

MIDI ▾ → Mappings… lists every assignment: the controller (CC or note, channel and device) and what it controls, with options for each. Remove assignments one at a time, or all at once with Clear all. Learn in the list starts MIDI Learn: the list steps aside while you click a control and comes back afterwards. Mappings in own window keeps the list visible in a window of its own, so you can watch assignments appear.

Assignments are saved with the project. New keeps the transport and menu assignments and drops the ones for tracks and effects. Assigning a control that is already assigned replaces the old assignment.

Encoders, range and invert

Feedback to the controller

With Send back on (the default), Foundry sends each assigned setting's value back to the controller whenever it changes, for whatever reason: the mouse, Undo, opening a project. LED rings, button lights and motorised faders then always show the truth. Nothing is echoed while you are moving a control, so motorised faders do not fight your hand. Turn Send back off for a device that would react to the messages itself, such as a keyboard whose own sounds listen to volume messages.

↑ Contents

Settings and help

Audio settings

Audio… chooses the sound card Foundry plays through.

The Audio dialog: driver, output, sample rate and buffer, with the latency and the plugin delay being compensated

Shown on Linux. On Windows the drivers are ASIO, Windows Audio and DirectSound.

The dialog shows the resulting output latency, and the plugin delay that Foundry is compensating. Foundry remembers your choice.

Pop-out windows

⧉ Editor and ⧉ Mixer beside the bottom panel's tabs, and ⧉ Own window in the piano roll's toolbar, move that panel into a window of its own, for example on a second monitor. Everything keeps working there: editing, the playhead, faders, MIDI Learn and the keyboard shortcuts. The main window shows Bring back in its place; closing the window brings the panel back too. With both the editor and the mixer in their own windows, the arrangement takes the whole main window.

Foundry remembers the size and position of each window. MIDI devices, MIDI mappings, effect windows, automation windows, the takes window and the sample browser open in windows of their own as well. All of them close with the main window.

Themes

The Theme menu in the top bar changes Foundry's colours, in every window at once. Foundry remembers your choice on this computer.

Foundry in the Obsidian theme

In Obsidian, each accent colour has its own job:

ColourUsed for
Neon CyanThe playhead, selections, the loop band and active states such as Play and Loop
Electric VioletAutomation curves, highlighted MIDI notes, markers and sends
Vivid CobaltButtons that act (such as Add effect and Export) and the chosen tool
Amber GlowClipping, the top of the level meters, and gain reduction
Crimson FlareMute, solo and recording

Rose gives the same jobs to its own colours: rose pink for the playhead, selections and active states, lavender for automation, highlighted notes, markers and sends, orchid for buttons and the chosen tool, peach for clipping and gain reduction, and ruby for mute, solo and recording.

Foundry in the Rose theme

Studio Grey keeps it quiet: signal orange for the playhead, selections and active states, steel blue for automation, highlighted notes, markers and sends, soft white for buttons and the chosen tool, and classic green-to-yellow-to-red meters, with yellow for clipping and gain reduction and red for mute, solo and recording.

Foundry in the Studio Grey theme

Forest uses moss green for the playhead, selections and active states, gold for automation, highlighted notes, markers and sends, fern for buttons and the chosen tool, amber for clipping and gain reduction, and berry red for mute, solo and recording.

Foundry in the Forest theme

Midnight uses amber for the playhead, selections and active states, ice blue for automation, highlighted notes, markers and sends, cornflower for buttons and the chosen tool, yellow for clipping and gain reduction, and coral red for mute, solo and recording.

Foundry in the Midnight theme

Track colours stay as you set them in every theme. See Colours and icons.

Keyboard shortcuts

The Keyboard shortcuts dialog, where every main command can be given another key

Changing shortcuts

Open ? → Change shortcuts…. Choose Change beside a command and press the new key combination: Esc cancels and Backspace leaves the command without a key. A key that another command used moves to the new one. Reset all goes back to the defaults. Shortcuts are saved on this computer.

The shortcuts below are the defaults.

Transport keys

KeyCommand
SpacePlay / pause (stops recording while recording)
RRecord
LLoop
Ctrl+[Loop start at the playhead
Ctrl+]Loop end at the playhead
(none)Clear the loop markers
(none)Return to start on pause
BReference A/B
CMetronome
GGo to a bar or time
Shift+EscMIDI panic: stop every stuck note
Home / EndStart or end of the song, or of the selection
← / →Move the playhead a little (Shift moves further)

Marker keys

KeyCommand
MAdd a marker at the playhead
,Previous marker
.Next marker

Editing keys

KeyCommand
Ctrl+ZUndo
Ctrl+YRedo
Ctrl+X / C / VCut, copy, paste
DeleteDelete the selection
Ctrl+DDuplicate the selection (arrangement and automation)
Ctrl+ASelect all
SSplit at the playhead or the selection
TTrim to the selection
[ / ]Set the start or end of the waveform selection at the playhead
Alt+← / →Nudge one grid step
Alt+Shift+← / →Nudge one bar
Alt+↑ / ↓Transpose notes (a semitone, or a scale step with Lock on)
Alt+Shift+↑ / ↓Transpose notes an octave
1–5Choose a tool (arrangement or piano roll)
Alt while draggingIgnore the snap grid
Shift while draggingFine steps (clip gain, drum velocity and chance)

Piano roll keys

KeyCommand
QQuantize
HHumanize
KScale lock
FMaximize the piano roll (Esc restores)

Project and view keys

KeyCommand
Ctrl+SSave
Ctrl+Shift+SSave as
Ctrl+OOpen
Ctrl+EExport
Ctrl+FFind tracks
Ctrl+LMIDI Learn
IShow or hide the inspector
?Help
F1User manual
+ / − / 0Zoom in, out, or to fit: the arrangement after you click in it, else the waveform editor
Ctrl+scrollZoom (arrangement, editors, automation)
Shift+scrollScroll left and right

The help (?) lists the main shortcuts too.

The help, listing the main keyboard shortcuts and tips

Tips

Troubleshooting

No sound

Crackles or dropouts

Watch the engine load at the right of the status bar: if it is red or counts dropouts, choose a larger Buffer in Audio…, close other programs, or freeze tracks with heavy plugins. A note that keeps sounding is fixed with MIDI panic.

Recordings land late

Set the Latency fix in the recording settings. See Lining up takes.

A plugin does not load

A plugin stops working

Foundry switched it off to keep the song playing; see Crash-safe plugins. Save, then open the project again to reload the plugin. If it keeps happening, check the plugin crash log, update the plugin, and send the log entry to the plugin's maker.

A plugin window is too small or too large on Linux

Start Foundry with FOUNDRY_PLUGIN_SCALE set; see Plugins on Linux.

Foundry does not start on Linux

Foundry will not save or export

Foundry is running as a demo: enter your licence key in Licence…. If Foundry was licensed before, check the licence there; a refunded order's licence is withdrawn.

The mix clips

The status bar warns when an export clipped. Lower the loudest tracks, put a Limiter last on the master, or export with a loudness target and Keep peaks at or below −1 dBFS ticked. For a clipping audio clip, Clipping — click to normalize in the status bar lowers it.

A project opens without some plugins

The plugins are no longer where they were installed, or you chose Open without plugins. Reinstall or move the plugins back, then open the project again.

A MIDI device does not appear

Check that it is connected and switched on, then look in MIDI ▾ → Devices…; the MIDI ▾ menu shows whether MIDI is available. If it still does not appear, restart Foundry with the device connected. On Linux, MIDI devices are the system's ALSA MIDI ports.

Glossary

TermMeaning
AutomationA setting that changes over the course of the song. See Automation.
BusA track that other tracks play into, so they share its fader and effects. See Routing and buses.
ClipA piece of audio on an audio track. See Audio tracks and clips.
CompThe version of a recording made from the best parts of several takes. See Takes and comping.
Count-inBars of metronome before recording starts.
dB, dBFSDecibels, the unit of level. 0 dBFS is the loudest a digital file can hold; above it, the sound clips.
FreezeRendering a track through its plugins into audio. See Freezing a track.
Gain reductionHow much a compressor, limiter or gate is turning the sound down at the moment.
LatencyThe delay between an action and hearing it, from the sound card or from plugins.
LUFSA measure of how loud a song sounds overall, used by streaming services.
MIDINotes and control messages rather than sound: what a keyboard plays and an instrument turns into sound.
NormalizeRaising or lowering a level so its loudest peak reaches a set point.
PanWhere a sound sits between the left and right speakers.
PlayheadThe line that marks where playback starts and where pastes land.
PluginAn effect or instrument from another maker, in VST3 format. See VST3 plugins.
QuantizeMoving notes onto the grid. See Quantize and humanize.
RegionA block of notes or drum hits that moves as one. See Moving clips and regions.
ReturnA track that receives sends, usually with a reverb or delay on it. Also the transport button that brings the playhead back; see Return.
Sample rateHow many times a second audio is measured: 44.1 kHz or 48 kHz are usual.
SendA share of a track's sound sent to another track. See Sends and returns.
SidechainA compressor or gate listening to another track. See Sidechain.
SnapLocking edits to the grid of bars and beats. See Snap.
SoloHearing only the chosen tracks. See Mute and solo.
StemOne track (or bus) of the song exported as its own file. See Exporting audio.
TakeOne recorded attempt. See Takes and comping.
Tempo mapTempo and time-signature changes later in the song. See The tempo map.
VCAA fader that moves several tracks' levels together. See VCA groups.
VelocityHow hard a note is played, from 1 to 127. See Velocity.

Support: write to Art Le Bel at art@artlebel.com. For a plugin problem, include the entry from the plugin crash log. Your licence key and orders are under My Account → Foundry licence on the Foundry website.

Licence agreement: Foundry is licensed to you under the Foundry End User License Agreement, which the Windows installer shows before installing, and which is in LICENSE.txt in the folder where Foundry is installed. The music you make with Foundry is yours.

Third-party software: the components Foundry is built with, and their licences, are listed in THIRD-PARTY-NOTICES.md in Foundry's folder.

Copyright © 2026 Art Le Bel. All rights reserved. VST and ASIO are trademarks of Steinberg Media Technologies GmbH. Windows is a trademark of Microsoft Corporation. Linux is a trademark of Linus Torvalds. Other names may be trademarks of their owners.