You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

2.6KB

VCV community repository

The VCV community members are responsible for curating Rack plugins into a centralized database. Anyone is welcome to join.

All Rack plugins are welcome assuming they

  • are not malware (i.e. harm your computer or your privacy)
  • do not misuse intellectual property (legally or morally).

For plugin developers: Adding/updating your plugin

To add your plugin(s) to the Plugin Manager, update its information, or inform us of new builds, create an issue with the title equal to your plugin slug (or slugs, comma-separated). If you already have an existing issue for your plugin, reuse it for additional requests. Give us each plugin name, your desired author name, license information, relevant URLs, and anything else under the Manifest section below. A Library Team member will handle your request.

Manifest files

The filename of each manifest should be YourSlug.json. See Fundamental.json for an example.

All properties are optional. URLs should not be redundant across different keys, meaning you must choose the most relevant key for a particular URL.

  • name: Human-readable display name for your plugin. You can change this on a whim, unlike slugs.
  • author: Your name, company, alias, or GitHub username.
  • license: The license type of your plugin. Use “proprietary” if all rights are reserved. If your license is in the SPDX license list, use its abbreviation in the “Identifier” column.
  • authorEmail: Your email address for support inquiries.
  • pluginUrl: Homepage featuring the plugin itself.
  • authorUrl: Homepage of the author.
  • manualUrl: The manual of your plugin. HTML, PDF, or GitHub readme/wiki are fine.
  • sourceUrl: The source code homepage. E.g. GitHub repo.
  • donateUrl: Link to donation page for users who wish to donate. E.g. PayPal URL.
  • latestVersion: Your plugin's latest version, using the guidelines at https://github.com/VCVRack/Rack/issues/266. Do not include the “v” prefix.
  • productId: ID for plugins sold through the VCV Store.
  • status: TODO

Building repos

Clone all repos with git submodule update --init --recursive

Then build all repos with RACK_DIR=<path to Rack directory> make dist_all

Adding a repo

The folder name should match the slug, even if it is not the repository name. Be sure to check out the correct branch.

cd repos
git submodule add -b master https://github.com/VCVRack/Fundamental.git Fundamental