Foundry 1.0.17 · Windows, macOS and Linux
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 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.
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).
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.
| System | File | Install |
|---|---|---|
| Windows | Foundry-Setup-1.0.17.exe | Windows installer |
| Windows, no installation | Foundry-1.0.17-win-x64-portable.zip | Windows portable |
| Ubuntu, Debian, Mint, Pop!_OS | foundry_1.0.17_amd64.deb | Ubuntu and Debian |
| Fedora, RHEL, openSUSE | foundry-1.0.17-1.x86_64.rpm | Fedora and openSUSE |
| Any Linux, no installation | Foundry-1.0.17-x86_64.AppImage | AppImage |
| Linux with snapd | foundry_1.0.17_amd64.snap | Snap package |
| Linux with Flatpak | Foundry-1.0.17-x86_64.flatpak | Flatpak |
| macOS (Apple silicon and Intel) | Foundry-1.0.17-mac.dmg | macOS |
After installing, start Foundry and activate your licence. Until you do, Foundry runs as a demo.
Foundry-Setup-1.0.17.exe.%LOCALAPPDATA%\Programs\Foundry, or choose another, then choose Install.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).
The portable version needs no installation and leaves nothing behind on the computer.
Foundry-1.0.17-win-x64-portable.zip anywhere: your documents, another drive, or a USB stick.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.
In a terminal, in the folder where you downloaded the file:
sudo apt install ./foundry_1.0.17_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.
sudo dnf install ./foundry-1.0.17-1.x86_64.rpm
On openSUSE, use sudo zypper install ./foundry-1.0.17-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).
The AppImage is one file that runs on almost any Linux without installing:
chmod +x Foundry-1.0.17-x86_64.AppImage
./Foundry-1.0.17-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.
sudo snap install --dangerous --classic foundry_1.0.17_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.
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.17-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.
Foundry-1.0.17-mac.dmg and drag Foundry onto Applications.xattr -dr com.apple.quarantine /Applications/Foundry.app.) After that it opens as usual.VST3 plugins are in /Library/Audio/Plug-Ins/VST3 or ~/Library/Audio/Plug-Ins/VST3, and the plugin picker starts there. While a plugin's window is open, a second Dock icon (the Foundry engine) appears. Foundry's keys use Cmd where this manual says Ctrl.
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 Preferences… → Updates and untick Check for a new version when Foundry starts; ticking it again checks straight away, and Check now checks at any time. Preferences… → Updates also shows which version you have.
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.
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.
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 Licence ● tab in Preferences 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 Preferences → Licence → Buy Foundry to open the store.
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.
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.
For a studio computer that is never online:
Foundry.foundrylicence.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. Preferences → 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.
Foundry's browser version (a single web page) takes the same key and the same licence file: choose Preferences → Licence, then enter your key and Activate, or Import licence file…. The licence is kept in that browser, so each browser you use, and each private window, needs it entered once. Clearing the browser's site data removes it; enter the key again. Without a licence the browser version is the demo too: saving a project and every export are off.
From left to right:
Foundry reopens at the size and position you left it in, maximised if it was. If that screen is no longer connected, it opens on one that is.
The arrangement fills the middle of the window while its tab is chosen: 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 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.
⧉ at the top of the inspector moves it into a window of its own, where it still follows the selected track; the arrangement takes its column meanwhile. To keep one track's settings in view while you work on others, Ctrl+right-click that track: see Inspector windows.
Below the transport, three tabs choose what fills the window beside the inspector:
The buttons beside the tabs:
Foundry remembers the tab you were on.
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.
When Foundry opens, the Start screen offers a way in:
.reel file; Recent projects lists the last ones you saved or opened.Untick Show this when Foundry starts to start on an empty project instead. Foundry skips the Start screen when it opens a project by itself: a file you double-clicked, or work it recovered. To bring it back, choose Preferences… → Files → Show it now, or type Start screen in the command palette.
This walkthrough makes a short song from scratch and touches each main part of Foundry. Each step links to the full explanation.
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 the selected track. Copy the file and you have copied the song.
Opening a project (or starting a new one) stops playback first, and the song opens stopped with the cursor at its beginning. Foundry lets go of everything it was keeping for the song before, so a long session of opening one song after another does not keep filling memory. Once a project is open, Foundry prepares its mix straight away and keeps it ready as you edit, so Play starts without waiting.
.reel file onto the window, or double-click it in your file manager if you chose that when installing.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.
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.
While a project has unsaved changes, Foundry saves a recovery copy every minute (for projects with less than 1 GB of audio). Preferences… → Files → Autosave makes that every 2 or 5 minutes, or never. 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 (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.
Undo history… in the project menu (Ctrl+Alt+Z) lists every step, newest first, each named as Foundry reported it ("Added a MIDI track", "Deleted 2 bars from bar 5"). Click one to go back to just after it, as many steps as it takes, in one go. The steps you went back over stay above it, dimmed, and a click brings them back, until you make a new edit. Start goes back to before the first edit.
A template is a starting point for new songs: your usual tracks, routing, sends, effects, plugins with their settings, instruments and drum kits.
Saving a template needs a licence (see The demo).
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:
| Foundry | Settings folder |
|---|---|
| Windows (installed) | %APPDATA%\Foundry |
| Windows portable | the data folder beside Foundry.exe |
| Linux (.deb, .rpm, AppImage, snap) | ~/.config/Foundry |
| Linux Flatpak | ~/.var/app/io.github.artofscripting.Foundry/config/Foundry |
Preferences… → Files → Open the settings folder opens it in Explorer or your file manager. 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.
| Track | Holds | Edited in |
|---|---|---|
| Audio (∿) | Audio clips: recordings, samples, frozen plugins | The waveform editor |
| MIDI (♪) | Notes and controller lanes, played by an instrument | The piano roll |
| Drums (◎) | A step pattern played by pads | The drum machine |
| Folder (▤) | Other tracks, mixed together | Folders |
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.
The arrangement toolbar adds tracks below the others:
Importing files and recording also add tracks.
A track preset is a track's set-up saved by name, for new tracks that start the same way: its instrument and sounds (synth settings, SoundFont, samples, drum pads and kit), MIDI effects, built-in effects with their settings, level, pan, colour, icon, output and sends. It does not keep the clips, notes, drum hits or automation, and plugins are left out (a plugin's own presets keep its settings).
Each track's header has two lines. Right-click anywhere on a header for the track's menu: Rename, Duplicate, Move up and Move down (Ctrl+Shift+↑ / ↓; a folder moves with everything in it, a track stays in its folder), Colour and icon…, Mute, Solo, Automation…, Takes… (audio tracks with takes), Freeze with its effects… (the desktop app, tracks with effects or plugins), Fold or Put in a new folder, Add audio / MIDI / drum track below (new tracks otherwise go to the bottom), and Remove track.
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.
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.
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.
A folder groups tracks so they play through one fader and one set of effects, and so you can fold them away.
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.
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 ruler above the tracks shows the bars, and:
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.
Choose a tool in the arrangement toolbar, or press 1 to 5 after clicking in the arrangement:
| Tool | Key | What it does |
|---|---|---|
| Select | 1 | Click 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. Drag a clip's or region's start or end to trim or extend it (see Clip edges). |
| Edit | 2 | Drag anywhere, over clips too, to select a time range. Drag a clip's start or end to trim or extend it, as with Select. The top edge of a clip has its fade handles and gain. See Clip gain and fades. |
| Split | 3 | Click a clip, or MIDI notes, to cut them in two at that point. |
| Erase | 4 | Click or sweep over clips, notes and drum hits to delete them. |
| Paint | 5 | Drag across a drum track to paint its pattern into each bar you pass over; right-drag clears them. See Painting drums in the arrangement. |
Esc or a click elsewhere closes a menu; the arrow keys move through it.
With Select or Edit, the pointer turns into ↔ at the start and end of a clip, or of a MIDI or drum region. Drag there:
Each repeat of an audio clip is a clip of its own, so you can move, trim or fade any of them. On MIDI and drum tracks the notes or hits are copied. A clip or region that grows over another replaces what it covers. The edges follow the snap grid; hold Alt to place them freely. Each drag is one undo step.
Double-click a clip to open it in the Editor tab, showing only that clip:
Whole track, in the editor's toolbar, shows the whole track again.
Ctrl+double-click a clip to open it in an editor window of its own instead, which stays on that clip while the Editor tab follows whatever you select.
These work on the selected clips, or on a time range you selected across tracks, while the arrangement was the last thing you clicked:
| Button | Key | |
|---|---|---|
| Cut | Ctrl+X | Removes the selection, leaving a gap, and keeps it to paste. |
| Copy | Ctrl+C | Keeps a copy to paste. |
| Paste | Ctrl+V | Pastes at the playhead, on the selected track (and the tracks below it, for a copy of several tracks). |
| Delete | Delete | Removes the selection, leaving a gap. |
| Duplicate | Ctrl+D | Copies the selection to right after itself. |
Every edit is one undo step. When the arrangement is not the last thing you clicked (or the Editor tab is showing), these keys go to the editor instead.
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.
Regions have the same menu as clips (see Clip names, colours and mutes): right-click one, or press F2 with the playhead on it, to name it, colour it or mute it. A muted region's notes or hits stay in place (faded in the piano roll) but are not played, sent to MIDI Out or exported. Alt+M mutes or unmutes the region at the playhead, or every region in the selection. A region's name shows in the piano roll's corner while that region is open there, and the clip launcher names its cells after their clips and regions.
Shift+drag moves the whole track, everything on it together.
With the Edit tool, the top edge of every audio clip has two small square handles:
Each drag is one undo step.
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.
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.
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.
Insert bars… and Delete bars… change the length of the song anywhere, on every track at once. Each is one undo step.
A drum track's pattern is written out (as long as it plays) so its hits can move. A pattern too long to write out, or one that loops a part of itself, stays as it is, and Foundry says so.
Ripple (arrangement toolbar) changes Delete and Cut in the arrangement: instead of leaving a gap, what follows on the selected tracks moves back to close it. Other tracks, markers and tempo changes stay. Ripple is remembered on this computer.
Markers name places in the song: Intro, Verse, Chorus.
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.
In the Markers dialog, choose a format and click Export:
1:23 Chorus, ready to paste into a video description. Video chapters must start at 0:00, so if your first marker is later, a Start chapter is added at 0:00.The file is named after the project, for example My song markers.txt. Like other exports, this is turned off in the demo.
Loop (L) makes playback repeat. What it repeats:
If the playhead is outside the loop when you press Play, playback starts at the loop's start.
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.
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.
| Control | Key | What it does |
|---|---|---|
| Play | Space | Plays from the playhead; pressing it again pauses. |
| ■ | Stops and goes back to the start. | |
| Record | R | Records; Space or Record stops. See Recording audio. |
| Home / End | Goes 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.
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 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.
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.
Tempo map… lists tempo and time-signature changes later in the song.
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.
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.
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.
Right-click a clip (or press F2 with the playhead on it) for its menu:
Names, colours and mutes stay with a clip through splits, moves and copies, and are saved with the project.
Select an audio track and the Editor tab shows its waveform, left channel above right, with the bars along the bottom and clip boundaries marked in teal.
With Snap on (see Snap), selections lock to the grid; hold Alt to select freely.
| Button | Key | What it does |
|---|---|---|
| Cut | Ctrl+X | Removes the selection and closes the gap; keeps it to paste. |
| Copy | Ctrl+C | Keeps a copy of the selection. |
| Paste | Ctrl+V | Inserts at the playhead, or replaces the selection. Later audio moves along. |
| Delete | Delete | Removes the selection and closes the gap. |
| Trim | T | Keeps only the selection. |
| Split | S | Cuts the clip in two at the playhead, or at both edges of the selection, so the parts can be moved on their own. |
| Detect beat | Finds 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.
These work on the selection, or on the whole clip when nothing is selected:
Stretch… time-stretches and pitch-shifts the selection, or the whole track.
The result replaces the audio, later audio on the track moves to follow, and Undo brings the original back.
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).
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.
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.
| Tool | Key | What it does |
|---|---|---|
| Select | 1 | Click or drag a box to select notes; drag them to move, drag an edge to resize. |
| Edit | 2 | Draw notes. Right-click a note, or right-drag across several, to delete. Shift+drag selects with a box. |
| Erase | 3 | Click or sweep over notes to delete them. |
| Velocity | 4 | Drag notes up or down to change how hard they play, or draw across the velocity lane at the bottom. See Velocity. |
| Slice | 5 | Click 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.
With the Edit tool:
You hear each note as you draw it.
New chooses what a click draws:
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.
Ghosts shows the other MIDI tracks' notes faintly behind the track you are editing, each in its track's colour, so you can write a bass line under the chords or a harmony above the melody. Ghost notes cannot be clicked or changed here.
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 (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 is how hard a note is played, from 1 to 127; notes are drawn brighter the harder they play. With the Velocity tool:
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.
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.
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.
Plays the notes you hold one at a time, on a beat grid.
Adds a chord above every note.
A note outside the key plays as written, with the chord of the nearest scale note added.
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.
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).
Every MIDI track plays one of Foundry's instruments, unless the first slot of its plugin chain is a plugin instrument. They work everywhere Foundry runs, including the browser version, and sound the same live, in the desktop engine and in exports.
Select a MIDI track: the Instrument section at the top of the inspector chooses its instrument (so does Instrument in the piano roll's toolbar), with Preset… for a starting point and every setting below, in groups you can open and close. ▶ plays middle C while you hold it. Each change is one undo step; switching instruments keeps each one's settings, so you can switch back. Inspector windows show the same section.
‹ and › beside a preset menu step to the previous or next preset and play it at once, to run through the sounds quickly; the menu remembers the last one you chose.
Your own presets. On the analog synth, the FM synth, the plucked string and the organ, Save preset… keeps the current settings under a name: type it and press Enter. Your presets head the Preset… menu, under Yours, above Foundry's. Saving with the name of one of yours replaces it, and Delete removes the one named. They are kept on this computer (in the browser version, in this browser), for every project.
| Instrument | Sounds |
|---|---|
| Analog synth | Basses, leads, pads, plucks, brass and strings: the classic subtractive synth. 26 presets. |
| SoundFont player | Realistic sampled instruments from a .sf2 SoundFont file: pianos, strings, guitars, whole General MIDI sets. |
| FM synth | Electric pianos, bells, mallets, clavs and punchy basses. 15 presets. |
| Plucked string | Guitars, harp, koto, dulcimer and plucked bass, from a model of a vibrating string. 8 presets. |
| Organ | A tonewheel organ with nine drawbars, percussion, key click, vibrato/chorus and a rotary speaker. 10 presets. |
| Multi-sampler | Several recordings mapped across the keys: your own, or the glockenspiel, marimba, vibraphone, xylophone and kalimba included with Foundry. |
| Sampler | One recording played across the keys. See The sampler. |
| Triangle, Sine, Square, Saw | Plain waveforms, as in earlier versions of Foundry. |
Each note is computed once and remembered, so repeated notes cost nothing extra; a long song with many different notes takes longer to start playing the first time.
A note you play on a MIDI keyboard (with Thru), draw in the piano roll, or click on its keys, and the instrument's ▶, sound as the track plays them: through its MIDI effects, its instrument, its effects and plugins (VST3 too), its fader and pan, and the master chain, so a note sounds the same when placed as when the song plays it. In the desktop app this runs in the audio engine, even while the song is stopped, and the track's meter shows it; a plugin instrument gets the notes as live MIDI. A muted track, or one silenced by another's solo, stays silent. MIDI effects that spread a note over time (the arpeggiator) play their first step while you hold a key.
Two oscillators (Saw, Square with a Pulse width, Triangle or Sine), the second tuned in semitones and cents against the first, and Noise. Unison plays up to seven slightly detuned copies spread across the stereo field, for big leads and pads. Then a Filter (low-pass, high-pass or band-pass, with Resonance), which Key tracking opens for higher notes and its own envelope sweeps (Filter envelope, in octaves, up or down); the Amp envelope shapes the volume. The LFO moves the pitch (vibrato), the filter (wah, wobble) or the volume (tremolo). Glide slides each note from the one before it.
.sf2 file of your own instead.The player follows the file's own sample mapping, loops, envelopes, levels, pans and filters. Transpose, Attack and Release (as multiples of the file's own times) and Level adjust it. A file you load is saved inside the project (once, however many tracks use it), so the song plays the same on another computer; SoundFonts can be large, up to 1 GB. Many free SoundFonts exist; check the licence of any you share.
GeneralUser GS is not copied into the project: the project only names it, and Foundry finds it again in its own sound library when the project opens, so a song using it stays small. Projects that use it open in Foundry 1.0.11 or later.
Four sine-wave operators. Each has a frequency ratio to the note, detune, a level and its own envelope. The Algorithm decides which operators modulate which and which are heard: a modulating operator adds brightness and metallic or bell-like overtones, more of them the higher its level, and its envelope makes the tone change as the note sounds. Feedback makes operator 4 brighter and buzzier. Velocity to brightness makes harder notes brighter, as on an electric piano.
Sustain sets how long a note rings, Brightness how bright it starts and stays, Pick position where it is plucked (near the end is brighter and thinner), and Pluck with a pick, a finger or a mallet. Body and Body resonance colour it like an instrument's body. When a note ends, the string is damped over Release.
Nine drawbars, from 16′ (an octave below) to 1′ (three octaves above): pull them out (0–8) to mix the tones, as on a tonewheel organ. The presets are named after their drawbar settings. Percussion adds a decaying 2nd or 3rd harmonic to each note, Key click the contact click, Vibrato / chorus the scanner vibrato (V1–V3) or chorus (C1–C3), and Rotary speaker the swirl of a rotating speaker (Slow or Fast).
Spread across the keys shares out the keys again after you change roots. Attack, Decay, Sustain, Release, Transpose, Velocity and Level shape every note. The recordings are saved in the project.
The Sampler instrument plays an audio sample across the keyboard.
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.
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.
Select a drum track and the Editor tab shows its step sequencer: one row per pad, one column per sixteenth note.
Each pad has, from left to right:
Add pad adds another pad.
A new drum machine starts on the Foundry 808 kit. Kit names the kit the pads are on. Choose another kit there to hear it: it plays your pattern (a rock beat if the pattern is empty) without changing the pads, and ▶ plays it again. Use kit then puts the whole kit on the pads at once, in order: your steps, levels, pans and mutes stay where they are, and only the sounds change (and the pads' names, pitch and decay). Pads beyond the kit's are kept if they have steps, and removed if they are empty. Undo brings the old sounds back.
A kit's sounds are saved inside the project, like any pad sample. All the kits are also in the Foundry library in the sample browser, one file per sound, to load onto single pads or import as tracks.
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 (50 % to 75 %) delays every second sixteenth: 50 % is straight, 66 % a triplet shuffle.
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.
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.
.reeldrums file: the pattern with its velocities and chances, steps, repeats, swing, and every pad with its settings and sample. Exporting needs a licence..reeldrums file onto Foundry adds it as a new drum track.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.
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.
The recording settings are in Preferences → Recording; ⚙ beside Record opens them.
Echo cancellation, noise suppression and automatic gain are always off, so you record exactly what comes in.
Tuner…, in the project menu or in Recording settings, opens a small window that listens to the recording input. Play one note (one string at a time): it shows the nearest note and its octave, the needle shows how many cents sharp or flat it is (green within 5 cents), and below are the frequency and cents. It finds notes from a bass's low E up. A4 sets the reference pitch (415 to 466 Hz, 440 by default), kept on this computer.
To re-record only part of a take:
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.
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.
Foundry lines up every take with the song as it records, and removes the delay of your input and output that it knows about. Some audio interfaces report their delay wrongly, so a take can still land slightly late (or early). Fix it with the Rec knob in the transport (or Offset in the recording settings): turn it left if takes land late, right if they land early, up to 500 ms either way.
Right after a take, turning Rec moves that take too, so you can line it up by ear while it plays: record a click or a clap along with the metronome, play it back, and turn until it sits on the beat. Every later take then lands the same way. The take moves until you make another edit (each move is one undo step, and Undo removes the take as before); the knob keeps its setting on this computer. Drag it up or down (Shift for fine steps) or use the mouse wheel; double right-click puts it back to 0; you can turn it from a MIDI controller with MIDI Learn.
Controllers you move while recording (modulation, sustain, pitch bend and others) are recorded into the track's controller lanes.
Choose the Mixer tab (Alt+3), or open it in a window of its own with ⧉ while it shows. Every track has a channel strip, followed by the VCA groups and the Master strip.
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.
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.
These work in the track headers and on the mixer strips, and each is one undo step.
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.
The master strip also shows the loudness of the mix in LUFS, measured as the export's loudness targets measure it (ITU-R BS.1770): M, momentary (the last 400 ms), S, short-term (the last 3 seconds), and I, integrated (the whole time since Play, with the standard gating). It measures the mix as exported, before the transport's Master listening level. Click it to start the integrated loudness again from that point. For a streaming release, play the whole song and compare I with your target (−14 LUFS, for example).
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.
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, Out in an inspector window, or for every track at once in the routing 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.
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.
Routing (beside Editor and Mixer) opens a window of its own that shows how the whole mix is put together, and lets you change it in one place. Every track is a row:
The Master row shows the master's effects and what reaches it, and + New bus adds an empty track (Bus 1, Bus 2…) to route tracks into, for a submix such as a drum bus. Click a track's name to select it. Below the table, Signal flow draws the mix as a tree: Main, what plays into it, what plays into those, and the sends along the way.
Every change is one undo step, as in the mixer and the inspector. The window stays open beside your work, and since it is a window of its own, MIDI Learn reaches its controls: assign a controller's buttons to effect bypasses (⏻) and its faders or knobs to send levels, to play the mix by hand. Its Close button puts it away. For MIDI devices, see The MIDI routing window.
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.
Every track, and the master, has an effect chain. Sound flows through it from top to bottom.
On each effect:
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.
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.
An inspector window shows one track's settings in a window of its own: where it starts, Reference, its output and sends, its MIDI effects (on a MIDI track), and its effects and plugins. Open as many as you like, for example one per track on a second monitor:
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). Switch between them in the window; new windows use the mode you used last. In a window you can do everything the inspector does for that track except load new VST3 plugins (use the inspector's Desktop VST3 panel for that), and use MIDI Learn and Undo. Inspector windows close with the main window.
To move the inspector itself into a window, use ⧉ at the top of the inspector: see The inspector.
| Effect | What it does and its main settings |
|---|---|
| EQ | Shapes 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. |
| Compressor | Evens out the level: threshold, ratio, attack, release, knee, makeup, mix, and a sidechain key with its own filters. |
| Limiter | Keeps peaks below a ceiling, without ever going over it: input gain, ceiling, release. |
| Gate | Silences the sound below a threshold, for noisy recordings or tight drums: threshold, range, attack, hold, release, sidechain key. |
| Delay | Echoes: 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. |
| Reverb | Room and hall ambience: size, damping, width, mix, pre-delay. |
| Chorus | Thickens and widens: rate, depth, delay, mix. |
| Flanger | A sweeping, jet-like comb: rate, depth, delay, feedback, mix. |
| Phaser | A swirling sweep: rate, depth, feedback, mix. |
| Distortion | Drive and grit: drive, shape (soft, hard clip, wavefold), tone, mix, output. |
| Bitcrusher | Lo-fi digital crunch: bits, downsampling, mix. |
| Filter | Low-pass, high-pass, band-pass or notch, with resonance and an LFO to sweep it. |
| Tremolo / Auto-pan | Pulses the volume, or moves the sound from side to side: rate, depth, sine or square. |
| Stereo utility | Width (mono to extra wide), gain, mono, and polarity invert. |
| Tape saturation | Warm tape-style drive with gentle even harmonics: drive, asymmetry, tone, mix, output. |
| De-esser | Tames harsh "s" sounds in vocals: frequency, threshold, maximum reduction. |
| Multiband compressor | Compresses low, mid and high bands separately: two crossovers, per-band threshold and gain. |
| Transient shaper | Makes attacks punchier or softer, and sustain longer or shorter. |
| Auto-wah | A filter that follows how loud you play: frequency, range, sensitivity, resonance, attack, release, mix. |
| Ring modulator | Metallic, bell-like tones: carrier frequency, mix. |
| Vibrato | Wobbles the pitch: rate, depth, mix. |
| Exciter | Adds sparkle by saturating the highs: frequency, drive, amount. |
| Clipper | Shaves off peaks, hard or rounded: input gain, ceiling, softness, output. |
| Graphic EQ | Ten octave bands from 31 Hz to 16 kHz (±12 dB each). Shows the spectrum while playing. |
| Haas widener | Widens a sound by delaying one side slightly (1 to 40 ms). |
| Tape echo | A vintage tape delay with wow, tone and drive in its repeats. |
| Resonator | A tuned ring, like a string sympathetically resonating: frequency, feedback, damping, mix. |
| Pitch shifter | Shifts the pitch up or down 12 semitones, plus fine tuning in cents. |
| Lo-fi radio | The sound of a small radio: low and high cut, drive, hiss, mix. |
| Expander | Makes quiet parts quieter, to reduce background noise: threshold, ratio, range, attack, release, sidechain key. |
| Mid/side EQ | Changes the centre and the sides separately: mid and side levels, a low cut and an air shelf for the sides. |
| Pitch correction | Pulls 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 gate | Chops 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. |
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 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 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.
The visualizer is a window of moving pictures that follow the music while it plays. Open it with Visualizer in the project menu, or ✺ on the master strip. ⛶, or double-clicking the picture, fills the screen; Esc leaves full screen. ☰ Layers shows or hides the layers and their settings, and Quality draws MilkDrop smaller on a slower computer.
The visualizer's layers and pictures are saved with the project. Changing them marks the project as changed, but Undo does not undo them.
The picture is a stack of up to eight layers. Each layer draws one kind of picture and follows one source: the master (the whole song), or any track. A track is heard after its effects, so a kick drum can drive one layer while the vocal drives another.
The layer kinds are:
A MilkDrop layer shows one of about 400 presets from four packs. Type in the search box to find one, or step through them with ◀ and ▶ (or the ← and → keys). Random (or R) picks one at random.
Import presets… adds MilkDrop preset files (.milk), or presets in Butterchurn's format (.json), to this computer's library; they are listed under Imported. Foundry converts each file and checks that its equations contain only MilkDrop's own arithmetic before it runs any of them. A file that fails the check is not imported. A project that uses an imported preset keeps a copy of it, so it opens with the preset on another computer. Remove from library removes an imported preset.
An Image layer's Add picture… adds a PNG, JPEG, WebP or GIF picture (up to 8 MB, 32 per project) to the project. MilkDrop presets can use the project's pictures too, under the name shown below the picture: a preset that samples sampler_logo shows a picture named "Logo.png".
● Video… draws the layers over the song and saves a music video (a WebM file, with VP9 video and Opus sound).
Foundry renders the song as Export does (plugin chains included), and renders each track a layer follows on its own. It then draws the video frame by frame, so the picture keeps time with the sound however fast your computer is. This can take a while. Cancel stops it. Exporting videos needs a licence, as exporting audio does.
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 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.
Each lane shows the track's audio, notes or drum hits faintly behind the curve, so you can see where things happen.
A track with automation also shows ▾ next to A on its header. It opens the track's lanes right under the track, on the arrangement's own timeline, so a curve can be shaped beside the clips it belongs to; ▴ hides them again, and Shift+click shows or hides the lanes of every track at once. On a lane there:
The value shown beside the name is the lane's value at the playhead, or under the pointer.
| Tool | Key | |
|---|---|---|
| Points | 1 | Click to add a point; drag points to move them. |
| Range | 2 | Drag across one or more lanes to select a stretch of time; clicking moves the playhead. |
| ✎ Draw | 3 | Draw 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.
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.
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.
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.
.vst3 file in C:\Program Files\Common Files\VST3; some are folders), then pick it.~/.vst3, /usr/lib/vst3, /usr/local/lib/vst3), then opens the folder picker there. See Plugins on Linux.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.
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.
Every parameter of a plugin is also listed in Foundry, however many it has, in an inspector window: click the plugin's slot there (or Ctrl+right-click the track). Each is a slider from 0 to 1.
#number. Enter jumps to the first result and Esc clears it.Parameter sliders can be automated and mapped to a MIDI controller.
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 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.
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.
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.
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.
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.
.vst3./run/host; Foundry's plugin picker offers them under their usual names. A system plugin that needs libraries the Flatpak does not have may not load there; the .deb or .rpm avoids that.FOUNDRY_PLUGIN_SCALE=1.5 foundry (any value from 0.5 to 4).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.
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.
| File | Becomes |
|---|---|
| Audio: WAV, FLAC, MP3, OGG, M4A, AAC, WebM | An audio track. Foundry then offers beat detection. |
MIDI: .mid, .midi | MIDI and drum tracks. See MIDI files. |
Drum tracks: .reeldrums | A drum track. See Saving and sharing drum tracks. |
Projects: .reel | Opens the project. See Projects. |
Audio at another sample rate is converted to the project's rate as it is imported.
Export… (Ctrl+E) renders the song to audio files.
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, Mono and Dim 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).
Run the session from a phone, tablet or another computer on the same network (desktop app): the transport, markers, tempo and the mixer from the vocal booth or the couch, a keyboard and drum pads to play your tracks from the phone, and the drum machine's steps to build a beat on a tablet.
http://192.168.1.20:1808/; with several networks, any address in the list works, and clicking one opens it on this computer to try) in its browser, and type the six-digit pairing code shown in Foundry. The device is remembered, so next time it connects at once; the code changes after each pairing, and after five wrong tries.Foundry remembers whether the remote is on. Forget paired devices makes every device pair again. The remote works on your own network only, over plain HTTP: use it on a home or studio network you trust, not on public Wi-Fi.
The tabs switch between five pages: along the bottom, or down the left side when a phone is held sideways, so the page keeps its height. At the top of every page are Panic (stops every stuck note), Undo and Redo; a tablet also has Save (a dot on it means there are unsaved changes).
The remote fits what it shows to the screen, so a phone is never crowded:
.mid file) adds the file's parts as tracks and takes its tempo, time signature and tempo changes. Drum parts on channel 10 become drum tracks when they repeat in a loop, with one pad per drum sound; other parts become MIDI tracks.Samples are not part of MIDI files; use Export drums to share a drum track with its samples.
The MIDI devices are in Preferences → MIDI. MIDI ▾ → Devices… opens the same panel in a window of its own, where MIDI Learn reaches it; ⧉ Own window in Preferences does that too, and closing the window puts it back.
On Linux, MIDI devices are the system's ALSA MIDI ports.
Each MIDI track can listen to a MIDI device of its own, so a keyboard and a drum machine can play two tracks at the same time. Select the track: under the instrument at the top of the inspector, MIDI In chooses where its notes come from and Channel which channel it listens to (Any, or 1–16).
When you record MIDI, every track that MIDI reaches records it, each its own take: the selected track from the main MIDI In, and every track with a device of its own from that device. The takes are one undo step together. A channel set here filters what the track hears, so a drum machine on channel 10 can play one track while its other channels go elsewhere. Drum tracks take no MIDI In.
MIDI ▾ → Routing… (or MIDI routing… in Preferences → MIDI) opens a window of its own with every MIDI and drum track in the project with its MIDI In and MIDI Out (device and channel) in one table, to set them all in one place; click a track's name to select it. Above the table are the MIDI In and MIDI Out that tracks set to Selected track and Main use, with Send out; below it, every MIDI device with the tracks that use it, and devices the project names that are not plugged in. It stays open beside your work. The routing is saved with the project.
Each MIDI track and drum track can play on external gear of its own. Select the track: at the top of the inspector (under the instrument, on a MIDI track; see Choosing an instrument), MIDI Out chooses where it goes and Channel which MIDI channel (1–16) it goes out on.
A MIDI track sends its notes and controllers. A drum track sends each hit as its pad's General MIDI drum note (kick 36, snare 38, clap 39, closed hi-hat 42, open hi-hat 46…), on channel 10 unless you choose another, with swing and chance exactly as you hear them; muted pads are not sent, and a soloed pad plays alone. So one project can play a bass line on a hardware synth on channel 2 and its beat on a drum machine on channel 10.
Muted tracks are not sent, and a soloed track plays alone. The track's own sound still plays as well; to hear only the external gear, turn the track's fader all the way down, which leaves its MIDI as it is. Changing a track's MIDI Out while playing takes effect from that moment. Each change is one undo step, it is saved with the project, and a duplicated track keeps it. Stopping and Panic silence every device the tracks use.
Foundry's sound reaches your speakers a little after it plays: the sound card's delay (shown in Audio settings as output latency) and, with some plugins, their delay too. Foundry sends MIDI Out and MIDI clock that much later, so external gear plays with what you hear; MIDI devices shows how much it adds (+ 20 ms audio delay, added automatically).
If your gear still sounds early or late, turn the MIDI knob in the transport (or set MIDI Out offset in MIDI devices), in milliseconds: right sends MIDI later, left earlier, up to 500 ms either way. Drag it up or down (Shift for fine steps) or use the mouse wheel; double right-click puts it back to 0, and MIDI Learn can put it on a knob of your controller, to adjust it while the music plays. A synth that is slow to respond needs a negative offset; if you listen to the synth through Foundry (its audio coming back into an input), it arrives later still, so try a negative offset of about your input latency. The offset is kept on this computer, for every project, since it depends on your gear.
To set it by ear: put a short, sharp sound on a MIDI track (a clave or a click) playing quarter notes with the metronome on, send it to the synth, and adjust the offset until the two sound as one.
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 Learn connects the knobs, faders, pads and keys of a MIDI controller to Foundry's controls.
Right-click a control while learning to remove its assignment. MIDI Learn works in every window, including pop-out, editor and inspector 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 (the master's too), each send's level and Pre/Post, the transport's MIDI and Rec knobs, and plugin parameter sliders. Controls in dialogs cannot be assigned; the routing window opens in a window of its own, so its effect bypasses (⏻), send levels, Pre/Post and + New bus can.
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.
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.
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.
Preferences… in the top bar (Ctrl+,) holds the settings that belong to this computer rather than to a song. Its sections are down the left (↑ and ↓ move between them), and it opens on the one you used last:
Every change applies at once and is kept on this computer. Close (or Esc, or a click outside) puts Preferences away. In the browser version, the sections about the audio driver, files and updates say what the browser does instead.
Preferences → Audio chooses the sound card Foundry plays through.
Shown on Linux. On Windows the drivers are ASIO, Windows Audio and DirectSound.
Below them are the resulting output latency, and the plugin delay that Foundry is compensating. Foundry remembers your choice.
⧉ beside the view tabs moves the editor or the mixer (whichever shows; the editor from the Arrangement tab) into a window of its own, for example on a second monitor; ⧉ at the top of the inspector does the same for the inspector, and ⧉ Own window in the piano roll's toolbar for the piano roll alone. Everything keeps working there: editing, the playhead, faders, MIDI Learn and the keyboard shortcuts, and the editor and the inspector still follow the selected track. Press ⧉ Bring back (or close the window) to return the panel. 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, editor windows, inspector 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.
The Editor tab (or its ⧉ window) always shows the selected track. To keep a clip in view while you work on others, open it in an editor window, which stays on it:
Open as many as you like. Each has its own zoom, scroll, selection and tool, and everything in the editor works there: drawing and editing, the toolbar, the keyboard shortcuts (for that window's track, while the window is in front) and Undo, which keeps the main window's selection as it was. Stays on at the top changes the window's track, and Select in project selects it in the main window too. Stretch…, Detect beat and Sampler… select the window's track in the main window and open there.
Colour theme in Preferences → Appearance changes Foundry's colours, in every window at once. Foundry remembers your choice on this computer.
In Obsidian, each accent colour has its own job:
| Colour | Used for |
|---|---|
| Neon Cyan | The playhead, selections, the loop band and active states such as Play and Loop |
| Electric Violet | Automation curves, highlighted MIDI notes, markers and sends |
| Vivid Cobalt | Buttons that act (such as Add effect and Export) and the chosen tool |
| Amber Glow | Clipping, the top of the level meters, and gain reduction |
| Crimson Flare | Mute, 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.
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.
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.
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.
Track colours stay as you set them in every theme. See Colours and icons.
Press ? (or ? in the top bar) for every key as it is set now, grouped like the list below, then the fixed keys and mouse moves. Type in its box to find a key.
Ctrl+K opens the command palette: type a few letters of anything you want to do and press Enter. It finds every command (with its key, if it has one), the menu items and buttons of the window, your tracks (to select one) and your markers (to jump to one). ↑ and ↓ choose, and Esc closes it. What you ran recently comes first.
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.
| Key | Command |
|---|---|
| Space | Play / pause (stops recording while recording) |
| R | Record |
| L | Loop |
| Ctrl+[ | Loop start at the playhead |
| Ctrl+] | Loop end at the playhead |
| (none) | Clear the loop markers |
| (none) | Return to start on pause |
| B | Reference A/B |
| C | Metronome |
| G | Go to a bar or time |
| Shift+Esc | MIDI panic: stop every stuck note |
| Home / End | Start or end of the song, or of the selection |
| ← / → | Move the playhead a little (Shift moves further) |
| Key | Command |
|---|---|
| M | Add a marker at the playhead |
| , | Previous marker |
| . | Next marker |
| Key | Command |
|---|---|
| ↑ / ↓ | Select the previous or next track |
| Ctrl+T | Add an audio track |
| Ctrl+Shift+T | Add a MIDI track |
| Ctrl+D | Duplicate the selected track (the arrangement selection, when there is one) |
| Shift+M | Mute the selected track |
| Shift+S | Solo the selected track |
| Ctrl+Shift+↑ / ↓ | Move the selected track up or down |
| Key | Command |
|---|---|
| Ctrl+Z | Undo |
| Ctrl+Y | Redo |
| Ctrl+X / C / V | Cut, copy, paste |
| Delete | Delete the selection |
| Ctrl+D | Duplicate the selection (arrangement and automation) |
| Ctrl+A | Select all |
| S | Split at the playhead: the arrangement's selected tracks (clips and regions) when it was clicked last, else the editor's selection |
| T | Trim 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–5 | Choose a tool (arrangement or piano roll) |
| Alt+M | Mute or unmute the clip or region at the playhead (or those in the arrangement selection) |
| F2 | The clip or region at the playhead: name, colour, mute |
| Alt while dragging | Ignore the snap grid |
| Shift while dragging | Fine steps (clip gain, drum velocity and chance) |
| Key | Command |
|---|---|
| Q | Quantize |
| H | Humanize |
| K | Scale lock |
| F | Maximize the piano roll (Esc restores) |
| Key | Command |
|---|---|
| Ctrl+S | Save |
| Ctrl+Shift+S | Save as |
| Ctrl+Alt+S | Save new version |
| Ctrl+O | Open |
| Ctrl+E | Export |
| Ctrl+Alt+Z | Undo history |
| Ctrl+K | Command palette |
| Ctrl+, | Preferences |
| Ctrl+F | Find tracks |
| Ctrl+L | MIDI Learn |
| Alt+1 / 2 / 3 | Arrangement, Editor or Mixer tab |
| I | Show or hide the inspector |
| Shift+F | Follow the playhead on or off |
| Z | Zoom the arrangement to the selection |
| ? | Help |
| F1 | User manual |
| + / − / 0 | Zoom in, out, or to fit: the arrangement after you click in it, else the waveform editor |
| Ctrl+scroll | Zoom (arrangement, editors, automation) |
| Shift+scroll | Scroll left and right |
The help (?) lists every key as it is set now, with a box to find one.
Watch the engine load at the right of the status bar: if it is red or counts dropouts, choose a larger Buffer in Preferences → Audio, close other programs, or freeze tracks with heavy plugins. A note that keeps sounding is fixed with MIDI panic.
Turn the Rec knob in the transport left (it moves the take you just recorded too). See Lining up takes.
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.
Start Foundry with FOUNDRY_PLUGIN_SCALE set; see Plugins on Linux.
chmod +x), and install fuse3 if your system lacks FUSE..deb is the most reliable choice: it installs the security profile Foundry's window needs.Foundry is running as a demo: enter your licence key in Preferences → Licence. If Foundry was licensed before, check the licence there; a refunded order's licence is withdrawn.
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.
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.
Check that it is connected and switched on, then look in Preferences → MIDI (or 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.
| Term | Meaning |
|---|---|
| Automation | A setting that changes over the course of the song. See Automation. |
| Bus | A track that other tracks play into, so they share its fader and effects. See Routing and buses. |
| Clip | A piece of audio on an audio track. See Audio tracks and clips. |
| Comp | The version of a recording made from the best parts of several takes. See Takes and comping. |
| Count-in | Bars of metronome before recording starts. |
| dB, dBFS | Decibels, the unit of level. 0 dBFS is the loudest a digital file can hold; above it, the sound clips. |
| Freeze | Rendering a track through its plugins into audio. See Freezing a track. |
| Gain reduction | How much a compressor, limiter or gate is turning the sound down at the moment. |
| Latency | The delay between an action and hearing it, from the sound card or from plugins. |
| LUFS | A measure of how loud a song sounds overall, used by streaming services. |
| MIDI | Notes and control messages rather than sound: what a keyboard plays and an instrument turns into sound. |
| Normalize | Raising or lowering a level so its loudest peak reaches a set point. |
| Pan | Where a sound sits between the left and right speakers. |
| Playhead | The line that marks where playback starts and where pastes land. |
| Plugin | An effect or instrument from another maker, in VST3 format. See VST3 plugins. |
| Quantize | Moving notes onto the grid. See Quantize and humanize. |
| Region | A block of notes or drum hits that moves as one. See Moving clips and regions. |
| Return | A track that receives sends, usually with a reverb or delay on it. Also the transport button that brings the playhead back; see Return. |
| Sample rate | How many times a second audio is measured: 44.1 kHz or 48 kHz are usual. |
| Send | A share of a track's sound sent to another track. See Sends and returns. |
| Sidechain | A compressor or gate listening to another track. See Sidechain. |
| Snap | Locking edits to the grid of bars and beats. See Snap. |
| Solo | Hearing only the chosen tracks. See Mute and solo. |
| Stem | One track (or bus) of the song exported as its own file. See Exporting audio. |
| Take | One recorded attempt. See Takes and comping. |
| Tempo map | Tempo and time-signature changes later in the song. See The tempo map. |
| VCA | A fader that moves several tracks' levels together. See VCA groups. |
| Velocity | How 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.