Skip to main content

Convert between Ardour XML and binary FXP VST preset files.

Project description

Convert between Ardour XML and binary FXP VST preset files.

Latest version Status MIT License Python versions Distribution formats Wheel available

Overview

The Open Source DAW Ardour saves user presets for VST plugins as XML documents in the directory ~/.config/ardour5/presets, with file names like vst-1094861636, where 1094861636 is the VST plugin indentifier as an integer. Unfortunately, most proprietary DAWs expect presets for VST2 plugins as FXP files (extension .fxp) or banks of presets as FXB files (extension .fxb). This makes it very hard to share presets for VST2 plugins between users of Ardour and those propietary DAWs.

The ardour2fxp script converts Ardour VST preset XML files to FXP preset files, so the presets can be imported when using the plug-in in another DAW.

The fxp2ardour script converts FXP preset files to Ardour VST preset XML files. FXB preset bank files are currently not supported.

Getting Started

Requirements

  • Python 3.4+

Installation

Install ardour2fxp with pip:

$ pip install ardour2fxp

or directly from the source code:

$ git clone https://github.com/SpotlightKid/ardour2fxp.git
$ cd ardour2fxp
$ pip install .

Usage

ardour2fxp

The ardour2fxp script can be used like this:

$ ardour2fxp -o my-vst-presets ~/.config/ardour5/presets/vst-1094861636

This will create an FXP (extension .fxp) file for every preset in the Ardour preset file(s) given on the command line (vst-1094861636 in the example above). FXP files will be put into sub-directories of the output directory given with the -o command line option (my-vst-presets in the example). The FXP files will be named after the preset label (with spaces replaced with underscores) and the sub-directories will be named after the plug-in identifier (1094861636 -> "ABCD" in the example). Existing files will not be overwritten (unless the -f / --force command line option is given).

fxp2ardour

The fxp2ardour script can be used like this:

$ fxp2ardour2 -o ardour-presets my-vst-presets/*.fxp

This will create Ardour VST preset XML files for all presets in the FXP file(s) given on the command line. The Ardour preset files will be placed in the output directory given with the -o command line option (ardour-presets in the example above, defaults to the current directory). One Ardour preset file will be created per plugin and will be named "vst-" plus the plugin identifier interpreted as a signed integer (e.g. vst-1094861636 when the plugin identifier is "ABCD"). Existing files will not be overwritten (unless the -f / --force command line option is given).

The output files can be copied to the user’s Ardour preset directory, which is normally located at ~/.config/ardour5/presets (assuming Ardour version 5.x on a Linux system). Care must be taken not to overwrite existing user preset files. Appending to existing user preset files is currently not supported.

Contributing

Please submit an issue or pull request to the project on GitHub.

Authors

License

This project is licensed under the MIT License - see the file LICENSE.txt about copyright and usage terms.

Acknowledgments

The following ressources were used to implement this script:

  • Ardour sources (vst_plugin.cc)

  • VST SDK headers (pluginterfaces/vst2.x/vstfxstore.h)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ardour2fxp-0.1.0b1.tar.gz (9.7 kB view details)

Uploaded Source

Built Distribution

ardour2fxp-0.1.0b1-py3-none-any.whl (8.0 kB view details)

Uploaded Python 3

File details

Details for the file ardour2fxp-0.1.0b1.tar.gz.

File metadata

  • Download URL: ardour2fxp-0.1.0b1.tar.gz
  • Upload date:
  • Size: 9.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/40.4.3 requests-toolbelt/0.8.0 tqdm/4.27.0 CPython/3.7.0

File hashes

Hashes for ardour2fxp-0.1.0b1.tar.gz
Algorithm Hash digest
SHA256 dc49e91eb8ad7970de3c9413f2fdf743bfc331057fedede3a0465d269d55fba2
MD5 51ced316865c9780737ecf28c5f7cea3
BLAKE2b-256 c6846196863b6e351d8cd49593bd84048d295efd7c687db3cd8ba7aac40350d5

See more details on using hashes here.

File details

Details for the file ardour2fxp-0.1.0b1-py3-none-any.whl.

File metadata

  • Download URL: ardour2fxp-0.1.0b1-py3-none-any.whl
  • Upload date:
  • Size: 8.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.19.1 setuptools/40.4.3 requests-toolbelt/0.8.0 tqdm/4.27.0 CPython/3.7.0

File hashes

Hashes for ardour2fxp-0.1.0b1-py3-none-any.whl
Algorithm Hash digest
SHA256 98137da452532455d02075bf98b2fce50f6e94005df31340bd218b1713cf3bb6
MD5 9fbec0beab8163fc8f7806daf1312864
BLAKE2b-256 c4f6daa3b4139fd11dc6723d86bbc44d22e729415e2eb8393f3573c99c0946c1

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page