Module xref 

Cross-reference engine: extract plugin references from DAW project files.

Parses 11 DAW formats: Ableton (.als), REAPER (.rpp), Bitwig (.bwproject), Studio One (.song), DAWproject, FL Studio (.flp), Logic Pro (.logicx), Cubase/Nuendo (.cpr), Pro Tools (.ptx/.ptf), and Reason (.reason). Returns deduplicated lists of plugin names, manufacturers, and types.

Structs

PluginRef

Constants

XREF_SUPPORTED_EXTENSIONS 🔒

Extensions implemented in extract_plugins (plugin cross-reference).

Statics

ALS_AU_BLOCK_RE 🔒

ALS_AU_MFG_RE 🔒

ALS_AU_NAME_RE 🔒

ALS_VST2_BLOCK_RE 🔒

ALS_VST2_MFG_RE 🔒

ALS_VST2_NAME_RE 🔒

ALS_VST3_BLOCK_RE 🔒

ALS_VST3_MFG_RE 🔒

ALS_VST3_NAME_RE 🔒

ARCH_SUFFIX_RE 🔒

Regex to strip architecture/platform suffixes from plugin names.

RPP_PLUGIN_RE 🔒

XML_DEVICE_NAME_RE 🔒

XML_PLUGIN_NAME_RE 🔒

XML_PLUG_NAME_RE 🔒

Functions

extract_au_identifiers 🔒

Extract Audio Unit identifiers from binary data. Logic stores AU plugins as 4-char codes like “aufx”, “aumu”, “aumf” followed by subtype and manufacturer.

extract_logic_plugin_names 🔒

Extract Logic Pro plugin names from binary data. Logic stores plugin names as standalone readable strings in the ProjectData binary.

extract_named_plugins 🔒

Extract plugin names that follow a marker string in binary data. Used by Cubase (.cpr) where plugins appear as “Plugin Name” followed by the name.

extract_plugin_from_string 🔒

Try to extract a plugin reference from a single string (path or name). Handles both exact suffix match and embedded paths (e.g. “Serum.dll8” in FLP chunks).

extract_plugins

Extract plugin references from a DAW project file. Returns an empty vec for unsupported formats.

extract_plugins_from_binary 🔒

Extract plugin references from a binary file via string scanning. Looks for paths ending in .dll, .vst3, .component, .clap, .aaxplugin

extract_plugins_from_dir 🔒

Extract plugins from all files in a directory (for .logicx packages).

extract_plugins_from_plist 🔒

Extract plugin names from a Logic Pro plist structure.

extract_plugins_from_xml 🔒

Extract plugin names from XML using pre-compiled regex patterns.

extract_plugins_utf16le 🔒

Extract plugin references from UTF-16LE encoded strings in binary data. FL Studio and some other DAWs use UTF-16LE for internal strings.

normalize_plugin_name

Normalize a plugin name for matching: lowercase, strip arch suffixes, collapse whitespace, trim.

parse_ableton 🔒

Parse Ableton Live .als file (gzip-compressed XML).

parse_bitwig 🔒

Parse Bitwig .bwproject file (binary — reuses shared string extraction).

parse_cubase 🔒

Parse Cubase/Nuendo .cpr file (binary — string extraction + Plugin Name markers).

parse_dawproject 🔒

Parse .dawproject file (ZIP containing project.xml — open standard).

parse_flp 🔒

Parse FL Studio .flp file (binary chunk format). Uses binary string extraction + UTF-16LE scanning for plugin paths.

parse_logic 🔒

Parse Logic Pro .logicx package (contains binary plists with plugin info).

parse_protools 🔒

Parse Pro Tools .ptx/.ptf file. Note: .ptf files (Pro Tools 7-10) are XOR-encrypted and require decryption. .ptx files (Pro Tools 10+) use a different format. Both are attempted via string extraction; encrypted files will yield 0 results.

parse_reaper 🔒

Parse REAPER .rpp file (plaintext).

parse_reason 🔒

Parse Reason .reason file (binary — string extraction).

parse_studio_one 🔒

Parse Bitwig Studio .bwproject file (binary with embedded strings).