dawtool

Install dawtool directly from the GitHub repository using pip. This requires Python 3.7 or greater.

pip install git+https://github.com/offlinemark/dawtool

If you only need to extract time markers, use the dawtool.extract_markers(filename, file_handle) function. You must provide the filename and a file handle opened in binary read mode ('rb'). The function returns a list of marker objects, each containing .time and .text attributes.

import sys
import dawtool

filename = sys.argv[1]
with open(filename, 'rb') as f:
    markers = dawtool.extract_markers(filename, f)
    for marker in markers:
        print(marker.time, marker.text)

For access to more data (such as tempo automation), use the advanced workflow:

1. Load the project using dawtool.load_project(filename, file_handle).
2. Call proj.parse() to parse the project and recompute time markers.
3. Access data via the project object (e.g., proj.markers).

import sys
import dawtool

filename = sys.argv[1]
with open(filename, 'rb') as f:
    # Load project based on file extension
    proj = dawtool.load_project(filename, f)
    # Parse project, recompute time markers
    proj.parse()
    # Access project data
    for marker in proj.markers:
        print(marker.time, marker.text)

dawtool supports the following file formats:

• Ableton Live set (.als) [v8-12]
• FL Studio project (.flp) [v10-11, v20]
• Cue sheet (.cue)

Use the dawtool command with the -m flag to print time markers from a DAW project file to the console.

$ dawtool -m my-dj-mix.als