Repository files navigation

Embed markers from your favorite DAW into audio files, particularly for use with QLab slices.

wavslice can read audio markers from:

Audio files • MIDI files (Pro Tools) • Ableton Sessions • Fruity Loops Sessions
coming soon:Pro Tools Session Data • QLab Timeline • Raw Text

Example Videos:▶️ Ableton Live → QLab

The app is prebuilt for apple siliconhere, but it is currently unsigned. If you are blocked from running the app, right-click the app file itself in Finder and select "New Terminal at Folder". Then run

xattr -dr com.apple.quarantine .

It should now run normally.

You can also use thebuild script, if you'd prefer not to run an unsigned binary.

wavslice is software for embedding markers into audio files.

The primary purpose is for QLab users who wish to use devamps and looping by exporting markers from their DAW of choice into QLab.

1. Add an audio file.

   Click on the folder icon or drag in an audio file. Only.wav files are supported at this time.

2. Add at least one marker source.

   Drag in or select a MIDI or text file that has marker information. If imported correctly, its name will appear in the marker selection box:

   

   Notice that the total number of markers at the bottom doesn't match the number of markers in the MIDI file. This is becausethe total count ignores both duplicate markers and any markers outside the file's length.

3. Select which markers you want.

   Use the checkboxes to choose which marker sources you want to embed in the output audio file. Note that you can also leave in any markers that were already in the original audio file.

4. Click Save.

   You'll be prompted to choose a location to save the file—the default location will cause an overwrite of the original.

The easiest way to get markers from Pro Tools is using a MIDI file.

1. Bounce your audio from the session.

   Your bounced audiomust begin at the very beginning of the session timeline.

2. Create a new blank MIDI track.

   

3. Export the MIDI track.

   Right-click the MIDI track, and selectExport MIDI....

   This will create a file containing all session memory locations.

   

4. Drag both files into wavslice.

   wavslice will create a new audio file with your markers embedded.

wavslice usestimestamps.me to extract markers from Ableton and Fruity Loops session files.

1. Bounce your audio from the session.

   Your bounced audiomust begin at the very beginning of the session timeline.

2. Choose your session file for processing.

   Simply drag your DAW session file (should have.als or.flp extension) into wavslice.

3. Approve the remote processing prompt.

   You will be prompted to approve uploading your file to the timestamps.me server. You must have an active internet connection.

   

4. Create the sliced audio file.

   If you didn't already, drag your bounced audio file into wavslice. Check that the visualization shows your markers, and export the new file.

wavslice supports output fromtimestamps.me, which allows you to export markers from both of these DAWs. See their website for more, but here is the process for Ableton:

1. Bounce your audio from the session.

   Your bounced audiomust begin at the very beginning of the session timeline.

2. Upload your session project file for processing.

   Head to thetimestamps.me site and upload your session file (just the session file itself, not the project folder!)

3. Download the high-precision CSV.

   Click theHigh precision button to download your marker file.

   

4. Drag both files into wavslice.

   wavslice will create a new audio file with your markers embedded.

wavslice will soon allow you to turn a set of QLab cues in a Timeline group into slices on the audio file.

1. Create a timeline group containing the audio file.
2. Add cues in the timeline where you'd like slices to be.
3. Select all cuesinside the timeline group (not the timeline itself), and drag them into a text editor. (Stickies works great for this).
4. Save the text file and drag it into wavslice.

wavslice will create a slice based on each of the cues' pre-wait time.

If you want to build the app yourself, you'll need the following software installed first:

• C/C++ build tools (XCode/Visual Studio)
• cmake
• rust
• node
• pnpm

On macOS, you can do this very easily usinghomebrew:

xcode-select --installbrew install cmake rust node pnpm

If you're on macOS, you can use this console command to download and build the app.Make sure you have all dependencies above installed first (run the two commands directly above.)

The script requires that you have git (usually preinstalled) andhomebrew. Now, run this command:

curl -fsSL https://h-n.me/install_wavslice| bash

The script will download and build the codebase for you. The app will be placed in the folder you ran the command in.

this repository uses submodules for some C++ dependencies. after cloning, run this command to download dependencies:

git submodule update --init

You'll also needlibsndfile andboost, both of which are easiest installed with homebrew on macOS.

build C++ code using:

cd src-cpp# go to c++ directorycmake -Bbuild# create configuration filescmake --build build --config Release# build binaries

The CLI executable will be insrc-tauri/bin/, and can be used directly if you'd like.

setup javascript using:

pnpm install

and run the app:

pnpm tauri dev# start development mode# -- OR --pnpm tauri build# build app executable

you'll find the app in thesrc-tauri/target/ directory.