Skip to content

Add markers from text/MIDI files into a WAV file. Make QLab slices from Pro Tools markers.

Notifications You must be signed in to change notification settings

hingobway/wavslice

Repository files navigation

wavslice

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

wavslice screenshots

Example Videos: ▶️ Ableton Live → QLab


Download App

Note

This software is designed to integrate deeply with Mac-only software like QLab. It may work on other operating systems, but build system changes will most likely be required.

The app is prebuilt for apple silicon here, 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 the build script, if you'd prefer not to run an unsigned binary.

Usage

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.

Basic usage

  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:

    markers midi file

    Notice that the total number of markers at the bottom doesn't match the number of markers in the MIDI file. This is because the 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.

QLab slices from Pro Tools

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

  1. Bounce your audio from the session.

    Your bounced audio must begin at the very beginning of the session timeline.

  2. Create a new blank MIDI track.

    create midi track
  3. Export the MIDI track.

    Right-click the MIDI track, and select Export MIDI....

    This will create a file containing all session memory locations.

    midi track context menu export midi track
  4. Drag both files into wavslice.

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

QLab slices from Ableton Live & FL Studio

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

  1. Bounce your audio from the session.

    Your bounced audio must 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.

    session upload prompt
  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.

Manual Usage

wavslice supports output from timestamps.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 audio must begin at the very beginning of the session timeline.

  2. Upload your session project file for processing.

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

  3. Download the high-precision CSV.

    Click the High precision button to download your marker file.

    export midi track
  4. Drag both files into wavslice.

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

QLab slices from QLab Timeline group (coming soon)

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 cues inside 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.

Building from source

Prerequisites

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

On macOS, you can do this very easily using homebrew:

xcode-select --install
brew install cmake rust node pnpm

Auto build script (macOS)

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) and homebrew. 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.

Manual build instructions

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

git submodule update --init

You'll also need libsndfile and boost, both of which are easiest installed with homebrew on macOS.

build C++ code using:

cd src-cpp                              # go to c++ directory
cmake -Bbuild                           # create configuration files
cmake --build build --config Release    # build binaries

The CLI executable will be in src-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 the src-tauri/target/ directory.

coming soon: text imports

text formatting screenshot

About

Add markers from text/MIDI files into a WAV file. Make QLab slices from Pro Tools markers.

Topics

Resources

Stars

Watchers

Forks