dawtool parses and extracts data from Digital Audio Workstation (DAW) file formats.
It provides a high accuracy implementation of time marker extraction, including support for projects with tempo automation.
Supported formats:
- Ableton Live set (.als) [v8-12]
- FL Studio project (.flp) [v10-11, 20]
- Cue sheet (.cue)
Just browsing? Here are a few points of interest in the codebase.
Time markers allow users to annotate the DAW timeline with text. Certain use cases benefit from the ability to export these annotations, such as timestamping a DJ mix, podcast, or film.
dawtool implements time marker export for DAWs that do not implement it natively, showcasing how DAWs can be extended through project file manipulation.
For more on how dawtool works, see the talk about it at the 2020 Audio Developer Conference.
Time markers are the only officially supported output. However much more of the formats are available through internal APIs, such as tempo automation data.
Simple API (Markers Only)
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)Advanced API (Markers & Other Data)
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 -m my-dj-mix.als
00:00.000 nciku - peaceofmind
02:15.115 comfort - a n g e l _ w i n g s
05:18.654 rose bride rings - femme fatale
06:52.654 ranov - butterfly
08:47.077 scalade - tempura VIP
10:57.423 mirvs - defrosted
dawtool requires Python 3.7 or greater.
pip install git+https://github.com/offlinemark/dawtool
dawtool is production ready. A hosted version has processed 3000+ project files since March 2020.
Both the API and CLI should be considered unstable and subject to change.
Tempo automation is supported for linear automation only. Nonlinear automation may cause inaccuracies.
dawtool's .flp parser is based on work from the LMMS, PyDaw, and FLParser projects.