Skip to content

Projects & Export

eSPi Essentials eSPi Studio

One file holds the whole machine, sounds and all. This chapter covers saving and opening projects, what eSPi does to keep your work safe, and how to get your beat out as audio.

What a project stores

An eSPi project is a single .espi file. It holds the whole machine: every pad and its settings, segments and songs, the mixer, effects, hosted plugins and their settings, Multi-Mode and your saved mixes. It also holds the audio of every loaded pad, stored inside the file as 24-bit WAV.

Because the samples always travel inside the project, a .espi file opens on another computer with every sound in place. There is nothing to collect or consolidate first, and moving your sample folders around never breaks a project. Your Engine settings are saved with the project too, and come back when you reopen it.

Where projects live

PlatformProjects folder
MacOS, Linux~/Documents/eSPi/Projects
WindowsDocuments\eSPi\Projects
iPad / iPhoneFiles › On My iPad (or iPhone) › eSPi › Projects
AndroidAndroid/data/<app>/files/Projects

On a computer you can move the eSPi folder, for example to another drive, in Settings › Files.

The window title shows the project name, with an asterisk when something has changed since you last saved: My Beat* - eSPi, or Untitled - eSPi for a new project. Selecting pads, changing banks or opening editors does not count as a change.

Save a project

The quickest way is Cmd/Ctrl + S. The first save of an untitled project asks for a name; after that it saves in place. It works while the Waveform Editor is open too.

From the machine: Disk 1

  1. Press Disk (W), then 1. Or browse with ◄ ► to 1. Save Project and press Enter.
  2. Press 9 (Yes) or Enter to confirm. 0 or 7 leaves without saving. In a plugin the screen is a choice instead; see Projects in a DAW.
  3. If the project has no name yet, a Save Project box asks for one. Type it and press Enter. A named project saves in place straight away.

Disk 1. Press 9 to save.

A long save shows Saving... with a progress bar, then Saved My Beat, plus the folder if you saved outside the Projects folder. If you pick a name that is already taken, eSPi asks first:

If something goes wrong, the LCD shows Save failed and the reason, such as Name required.

iPad Android Disk 1 always asks for a name, pre-filled with the current one, so you can keep the name or save a copy under a new one.

From the File menu

Save Project / Save "My Beat"
Cmd/Ctrl + S. On an untitled project it behaves like Save As.
Save Project As...
Cmd/Ctrl + Shift + S. Opens a file chooser in the Projects folder and warns before overwriting.

Saving on eSPi Essentials

On eSPi Essentials a project can still hold eSPi Studio parts, such as mixer settings, group effects, hosted plugins or turntable settings from a project made on eSPi Studio. They are kept, but not played. When you save such a project in the standalone app (Disk 1, Save Project, Save Project As..., Cmd/Ctrl + S, or Save in the unsaved-changes box), eSPi first shows a Save on eSPi Essentials box that lists them, with three choices:

Save as a copy
The default: press Return. Saves the whole project, eSPi Studio parts included, as a new file. The project you have open stays exactly as it is.
Save anyway
Removes the listed parts from the open project, then saves it. Undo starts empty afterwards. eSPi first keeps a Before Save anyway checkpoint, so you can restore the parts later on eSPi Studio.
Cancel
Esc, or click outside the box. Nothing is saved, and a quit, new project or open that was waiting for the save is called off.

eSPi Studio built-in effects on pads and on the master chain are never removed and never bring up the box. Autosave, your DAW session and saves made inside the plugin always keep every part, untouched, so a project saved on eSPi Essentials opens on eSPi Studio exactly as it was.

While a project holds eSPi Studio parts, a eSPi Studio parts kept note with a lock sits in the header, left of the gear. Point at it to see which parts it means, and click it to open the licence panel. It never pops up anything by itself.

Naming rules

Names can be up to 40 characters of plain ASCII text. eSPi removes the characters / \ : * ? " < > |, trims leading dots and trailing dots or spaces, and adds an underscore to names Windows reserves (so CON becomes CON_).

Open a project

From the machine: Disk 2

  1. Press Disk (W), then 2. Your projects are listed newest first, with a position counter on the top line.
  2. Move the > cursor with ◄ ► (or the arrow keys).
  3. Press 9 or Enter to load it. 0 or Tempo leaves.
  4. If the current project has unsaved changes, eSPi asks Discard changes?. Press 9 to go ahead or 7 to back out.

Disk 2. On a computer, in the standalone app and in a plugin, From Disk opens a file picker so you can load a project from anywhere.

While it loads the LCD shows Loading, then Loaded My Beat. An extra line may follow: N values fixed means some out-of-range values were corrected, and a note such as Newer format kept means the file came from a newer eSPi (see below). If there is nothing to list, the screen says No saved projects.

When a load fails you see Load failed and a reason, such as Not an eSPi project or Saved by newer eSPi.

A load window also opens over the machine. While a project loads it shows the name and the step, Reading project, Loading sounds 5/20 and Rebuilding, with a bar that fills as each sound comes in. Importing an SP-1200 disk or a web eSPi project shows Loading sequences, then Loading sounds. When it is done the window turns into a report: the file name (for an import, the imported project's name), how many sounds, segments and songs loaded (only segments and songs with something in them count), and anything worth knowing, such as missing sounds, Updated from v1, Newer format kept or N values fixed. A failed load shows Load failed (or Import failed) and the reason. The report stays until you press OK, Enter or Esc. Restoring your DAW session or a checkpoint never opens it.

From the File menu and the desktop

Whenever you create, open, import or quit with unsaved changes, a box asks whether to save first: Save, Don't Save or Cancel.

Start fresh: new projects and clearing

File › New Project (Cmd/Ctrl + N) starts an empty project. If Stock Samples is on, the stock kit fills the empty pads. Disk menu 11. New Project does the same from the faceplate.

File › New SP1200 Project (Original) and File › New SP1200 Project (Reissue) start an empty project with SP-1200 Mode already on in that flavour. There is no stock kit, and the 32 pads alternate between channels 7 and 8 (A1 on 7, A2 on 8, A3 on 7, and so on).

To clear only part of the machine, use the Disk menu. Each asks for confirmation (9 = Yes), and each can be undone with Cmd/Ctrl + Z.

Disk itemClearsResult
6. Clear BankThe 8 pads of the current bank. The prompt names it, for example Clear Bank A?Bank A cleared
7. Clear All BanksAll 32 pads. Mixer groups are kept.All banks cleared
8. Clear Seg/SongsEvery segment and song. Pad mute/solo and metronome settings stay.Seg+Songs cleared

None of these run while you are recording; the LCD says Stop recording first.

Reopen, autosave and crash recovery

eSPi works hard so a crash or a forgotten save never costs you a beat.

Reopen last project
Desktop When you start the standalone app, it offers Reopen "My Beat"? with Yes and No. It does not ask when you launched eSPi by opening a file.
Autosave
Every 2 minutes while there are unsaved changes, eSPi quietly writes a recovery copy to a private folder. It never overwrites your .espi file and does not clear the asterisk in the title. Autosave is always on; there is no setting for it.
Crash recovery
If eSPi closed unexpectedly, the next launch asks Recover unsaved project "My Beat"? before anything else, with three choices.

Recovery works for untitled projects too. Saving normally removes the recovery copy, and quitting during a save waits for the save to finish. In a DAW, the offer appears when you open eSPi's window after the host has crashed.

Projects in a DAW

When eSPi runs as a plugin, the whole project, audio included, is stored in your DAW session automatically. Saving the session is all you need to do. More in eSPi in Your DAW.

Import a web-eSPi project

Projects from the earlier web version of eSPi open in this one. Choose File › Import Legacy Project... and pick the old .espi file. You can also simply open it through Disk 2, Open or a double-click; eSPi recognises it and imports it the same way.

The old project becomes a new untitled project, and the original file is never overwritten. The LCD shows Imported Old Beat, plus N items converted if anything could not be carried over exactly.

Disk items 10 to 15 are reached by browsing with ◄ ► and pressing Enter.

Undo History (Disk 15)

eSPi keeps checkpoints of your work with the project. Browse the Disk menu to 15. Undo History and press Enter to see the list. Pick a checkpoint, confirm Restore?, and the LCD reports Restored.

Export audio

When the beat is done, take it out of the box. eSPi exports a stereo mixdown, separate stems, or the sample on a single pad. Files go to the Exports folder next to Projects (~/Documents/eSPi/Exports on desktop, Files › On My iPad › eSPi › Exports on iOS, Android/data/<app>/files/Exports on Android). Each kind of export has its own sub-folder: Beats for Record Beat, Stems, Pads, and SP-1200/SP12 and SP-1200/HFE for disk images.

Exports never overwrite silently: automatically named files get -2, -3 and so on, and the file chooser warns before replacing anything. While a save or another export is running, the export items are unavailable.

Export settings

Under Export in Settings › Engine:

Export Sample Rate
44.1 kHz (default) or 48 kHz.
Export Bit Depth
16-bit or 24-bit (default).
Real-time Capture (Record Beat)
On by default. Decides whether Record Beat captures you playing live or renders offline.
Stems Export
Per Group (default) or Per Pad. Decides whether Export Stems writes one file per mixer group or one per pad.

Record Beat: a stereo mixdown

Use Disk 4. Record Beat, File › Export Mixdown..., or Export › Master Mixdown in the Mixer header.

  1. Press Disk (W), then 4. The LCD shows what will be recorded, the current segment or song.
  2. Press 9 or Enter. 7, 0 or Tempo cancels.
  3. On desktop, choose where to save. The chooser suggests Exports/Beats/My Beat.wav.
  4. What happens next depends on Real-time Capture, below.
Real-time Capture on
The LCD says Press Play. Press Run/Stop and perform: play pads, ride the faders, switch mixes. The LCD counts REC 00:42. Press Run/Stop again; the LCD shows Finishing.... The file is exactly what you heard. The metronome stays audible but is not recorded.
Real-time Capture off
The segment or song renders offline with a progress bar, and the output is silent while it works. A segment is rendered to its exact loop length; a song runs to its end plus up to 10 seconds of tail so reverbs and long sounds can ring out.

When it finishes, the LCD shows Exported My Beat and a note if there is something to know: Clipped! if the mix went over full scale, N grp not in mix, or Deck not exported (the turntable is never part of an export).

Press 0 or Tempo during an export to cancel. The LCD says Export cancelled and no file is left behind. If eSPi can't start, it shows Export failed and why: Stop recording first, Stop sampling first, Stop playback first, Nothing to export or Audio not ready.

Export Stems

Stems give you one file per mixer group, or one per pad, ready to mix in your DAW. Use Disk 5. Export Stems, File › Export Stems..., or Export › Stems in the Mixer header.

  1. Confirm the segment or song with 9.
  2. On desktop, choose where to save the .zip. The default is Exports/Stems/My Beat-stems.zip.
  3. The LCD finishes with the number of stems written.

The zip holds master.wav plus one file per mixer group that actually plays in that segment or song, named like 01-Drums.wav. Every file is the same length and starts at bar 1, so they line up when you drop them into a DAW. Stems are taken before the master strip and master effects. Stems are always rendered offline.

With Stems Export set to Per Pad in Settings › Engine, the zip instead holds master.wav plus one file per pad that plays, named by pad number, pad and pad name, like 01-A1-Kick.wav. A pad stem is taken after the pad's own EQ, compressor, effects and fader, so it does not include its group's processing or fader.

Export Pad

To save a single sound, use Disk 3. Export Pad or File › Export Pad.... eSPi exports the whole sample on the selected pad (A1 if none is selected) as a WAV named after the pad. An empty pad gives No sample on pad.

Exporting on iPad, iPhone and Android

iPad Android There is no file chooser on mobile. Exports go straight to their sub-folder of Exports, and a moment after Exported ... appears, the system share sheet opens so you can AirDrop, message or save the file.

The Export button in the Mixer header works differently: when the export finishes, a save picker opens instead of the share sheet, so you choose where the mixdown or stems go on your device. Cancel it and the file is still in Exports.

Dismissing the share sheet is fine: the file is already saved. On iOS the standalone's exports appear in the Files app under On My iPad › eSPi › Exports, for example On My iPad › eSPi › Exports › Pads. In the AUv3 plugin, use the share sheet to get the file out.