A command line tool to install and uninstall plugins for use with Apache Cordova projects.
This document defines tool usage.
The original desktop Evolver is a compact monophonic synthesizer that packs an. Mono (qausi-4), 4 (Poly Editions). And Max-For Live Plugin - Add automation and MIDI interface functionality to DSI Evolver Keyboard. Brendan clarke, 876. I'm looking for a reverb plugin who has a freeze button. 3 - Waldorf Pulse - JP-8080 - Moog LP - Poly Evolver - SPL Mixdream XP + RackPack.
Requirements
You must have
git
on your PATH to be able to install plugins directly from remote git URLs.Plugin Specification
--> Available on docs.cordova.io <--
Quickstart
Design Goals
- Facilitate programmatic installation and manipulation of plugins
- Detail the dependencies and components of individual plugins
- Allow code reuse between different target platforms
Supported Platforms
- iOS
- Amazon Fire OS
- Android
- BlackBerry 10
- Tizen
- Windows Phone (7+8)
- Windows 8
Command Line Usage
- Displays all available plugman commandsplugman install --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project --plugin <name|url|path> [--plugins_dir ] [--www ] [--variable = [--variable = ...]]plugman uninstall --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project --plugin [--www ] [--plugins_dir ]
- Using minimum parameters, installs a plugin into a cordova project. You must specify a platform and cordova project location for that platform. You also must specify a plugin, with the different
--plugin
parameter forms being:name
: The directory name where the plugin contents exist. This must be an existing directory under the--plugins_dir
path (see below for more info) or a plugin in the Cordova registry.url
: A URL starting with https:// or git://, pointing to a valid git repository that is clonable and contains aplugin.xml
file. The contents of this repository would be copied into the--plugins_dir
.path
: A path to a directory containing a valid plugin which includes aplugin.xml
file. This path's contents will be copied into the--plugins_dir
.
--uninstall
: Uninstalls an already---install
'ed plugin from a cordova project. Specify the plugin ID.
Other parameters:
--plugins_dir
defaults to<project>/cordova/plugins
, but can be any directory containing a subdirectory for each fetched plugin.--www
defaults to the project'swww
folder location, but can be any directory that is to be used as cordova project application web assets.--variable
allows to specify certain variables at install time, necessary for certain plugins requiring API keys or other custom, user-defined parameters. Please see the plugin specification for more information.plugman search- Search the Plugin registry for plugin id's that match the given space separated list of keywords.plugman config set registry plugman config get registry
- Get or set the URL of the current plugin registry that plugman is using. Generally you should leave this set at http://registry.cordova.io unless you want to use a third party plugin registry.
Node Module Usage
This section details how to consume Plugman as a node module and is only for Cordova tool authors and other hackers. You should not need to read this section if you are just using Plugman to manage a Cordova project.
install
method
Installs a plugin into a specified cordova project of a specified platform.
platform
: one ofamazon-fireos
,android
,ios
,blackberry10
,wp7
orwp8
project_dir
: path to an instance of the above specified platform's cordova projectid
: a string representing theid
of the plugin, a path to a cordova plugin with a validplugin.xml
file, or anhttps://
orgit://
url to a git repository of a valid cordova plugin or a plugin published to the Cordova registryplugins_dir
: path to directory where plugins will be stored, defaults to<project_dir>/cordova/plugins
subdir
: subdirectory within the plugin directory to consider as plugin directory root, defaults to.
cli_variables
: an object mapping cordova plugin specification variable names (see plugin specification) to valueswww_dir
: path to directory where web assets are to be copied to, defaults to the specified project directory'swww
dir (dependent on platform)callback
: callback to invoke once complete. If specified, will pass in an error object as a first parameter if the action failed. If not and an error occurs,plugman
will throw the error
![Editor Editor](/uploads/1/2/3/7/123759559/685976228.jpg)
uninstall
method
Uninstalls a previously-installed cordova plugin from a specified cordova project of a specified platform.
platform
: one ofamazon-fireos
,android
,ios
,blackberry10
,wp7
orwp8
project_dir
: path to an instance of the above specified platform's cordova projectid
: a string representing theid
of the pluginplugins_dir
: path to directory where plugins are stored, defaults to<project_dir>/cordova/plugins
subdir
: subdirectory within the plugin directory to consider as plugin directory root, defaults to.
cli_variables
: an object mapping cordova plugin specification variable names (see plugin specification) to valueswww_dir
: path to directory where web assets are to be copied to, defaults to the specified project directory'swww
dir (dependent on platform)callback
: callback to invoke once complete. If specified, will pass in an error object as a first parameter if the action failed. If not and an error occurs,plugman
will throw the error
fetch
method
![Manual Manual](https://thumbs.worthpoint.com/zoom/images2/1/0117/10/dave-smith-instruments-evolver_1_ac176f50db5bda2046045b7da83b103f.jpg)
Copies a cordova plugin into a single location that plugman uses to track which plugins are installed into a project.
plugin_dir
: path, URL to a plugin directory/repository or name of a plugin published to the Cordova registry.plugins_dir
: path housing all plugins used in this projectlink
: ifplugin_dir
points to a local path, will create a symbolic link to that folder instead of copying intoplugins_dir
, defaults tofalse
subdir
: subdirectory within the plugin directory to consider as plugin directory root, defaults to.
gitref
: ifplugin_dir
points to a URL, this value will be used to pass intogit checkout
after the repository is cloned, defaults toHEAD
callback
: callback to invoke once complete. If specified, will pass in an error object as a first parameter if the action failed. If not and an error occurs,plugman
will throw the error
prepare
method
Finalizes plugin installation by making configuration file changes and setting up a JavaScript loader for js-module support.
project_dir
: path to an instance of the above specified platform's cordova projectplatform
: one ofamazon-fireos
,android
,ios
,blackberry10
,wp7
orwp8
plugins_dir
: path housing all plugins used in this project
Registry related actions
adduser
method
Adds a user account to the registry. Function takes no arguments other than a an optional callback
publish
method
Publishes plugins to the registry.
plugin_paths
is an array of plugin paths to publish to the registry.unpublish
method
unpublishes plugins from the registry. Can unpublish a version by specifying
plugin@version
or the whole plugin by just specifying plugin
. plugins
is an array of plugin[@version]
elements.search
method
Searches plugins in the registry.
search_opts
is an array of keywordsconfig
method
Configures registry settings.
params
is an array that describes the action/** var params = ['get', 'registry'];* var params = ['set', 'registry', 'http://registry.cordova.io'];* module.exports = function(params, callback) {*/Create plugin related actions
create
method
Creates basic scaffolding for a new plugin
module.exports = function create( name, id, version, pluginPath, options, callback ) {...}
name
: a name for the pluginid
: an id for the pluginversion
: a version for the pluginpluginPath
: a path to create the plugin inoptions
: an array of optionscallback
: callback to invoke once complete. If specified, will pass in an error object as a first parameter if the action failed. If not and an error occurs,plugman
will throw the error
platform
method
Add/Remove a platform from a newly created plugin
module.exports = function platform( { operation: operation, platform_name: cli_opts.platform_name } );
operation
: 'add or remove'platform_name
: ios, android
Example Plugins
- Google has a bunch of plugins which are maintained actively by a contributor to plugman
- Adobe maintains plugins for its Build cloud service, which are open sourced and available on GitHub
- BlackBerry has a bunch of plugins offering deep platform integration
- Core and 3rd party plugins can be found on the Cordova Registry.
Development
Basic installation:
Linking the global executable to the git repo:
Running Tests
Plugin Directory Structure
A plugin is typically a combination of some web/www code, and some native code.However, plugins may have only one of these things - a plugin could be a singleJavaScript file, or some native code with no corresponding JavaScript.
Here is a sample plugin named foo with android and ios platforms support, and 2 www assets.
This structure is suggested, but not required.
Contributors
See the package.json file for attribution notes.
License
Apache License 2.0
A Dream Synth for Players and Sound Designers !
There's a world of sounds waiting for you to discover them in the new Poly Evolver keyboard synth! This amazing instrument comes from the mind and hands of Dave Smith, the creator of the legendary Prophet 5, the Wavestation, the first soft-synth in the world, and one of the driving forces behind MIDI. The Poly Evolver is a delight for keyboard players and sound designers alike!
Dave Smith Instruments Poly Evolver Keyboard Synth at a Glance:- Four complete Evolver synths in one case, with a unique personality
- Unlimited expressive control with 5-octave keyboard plus knobs and switches
- A real analog synth with DSP control
- Wave sequencing and more with four independent analog sequencers
- Stereo audio inputs for processing external signals
Four Evolver synths, with a unique personality
Fans of the Dave Smith Evolver have been asking for a polyphonic version, and the 4-voice Polyphonic Evolver responds to those requests in a big way. Each of the 4 voices are a complete Evolver synthesizer, which not only provides backwards compatability with a monophonic Evolver, but also allows a number of cool features to play with. Overall, the Poly Evolver, while retaining all of Evolver's wild capabilities, has emerged with its own personality. Many sounds that sounded great on the monophonic Evolver really shine when played polyphonically - this is a real pad-monster machine!
Fans of the Dave Smith Evolver have been asking for a polyphonic version, and the 4-voice Polyphonic Evolver responds to those requests in a big way. Each of the 4 voices are a complete Evolver synthesizer, which not only provides backwards compatability with a monophonic Evolver, but also allows a number of cool features to play with. Overall, the Poly Evolver, while retaining all of Evolver's wild capabilities, has emerged with its own personality. Many sounds that sounded great on the monophonic Evolver really shine when played polyphonically - this is a real pad-monster machine!
5-octave keyboard plus knobs and switches
The Poly Evolver Keyboard is a player's dream! Its 5-octave keyboard is semi-weighted for playing ease and has velocity and mono aftertouch sensitivity. And with 77 endless-turn knobs and 59 switches, you have virtually unlimited control over filters, resonance, pitch… any parameter! The Poly Evolver also responds to MIDI control messages. Plus, you can chain up to five Polys together for up to 20 voices of polyphony.
The Poly Evolver Keyboard is a player's dream! Its 5-octave keyboard is semi-weighted for playing ease and has velocity and mono aftertouch sensitivity. And with 77 endless-turn knobs and 59 switches, you have virtually unlimited control over filters, resonance, pitch… any parameter! The Poly Evolver also responds to MIDI control messages. Plus, you can chain up to five Polys together for up to 20 voices of polyphony.
A true analog synth…
The Poly Evolver offers everything you'd expect from an analog synth and more! Sure, you can use it to recreate legendary sounds from the past. But you can also use the Poly Evolver to generate never-before-heard sounds and patterns. The analog electronics for each voice consist of two identical (Left/Right) synth sections, each with an analog waveshape oscillator, a 2/4 pole resonant low-pass filter, and a Voltage Controlled Amplifier (VCA).
The Poly Evolver offers everything you'd expect from an analog synth and more! Sure, you can use it to recreate legendary sounds from the past. But you can also use the Poly Evolver to generate never-before-heard sounds and patterns. The analog electronics for each voice consist of two identical (Left/Right) synth sections, each with an analog waveshape oscillator, a 2/4 pole resonant low-pass filter, and a Voltage Controlled Amplifier (VCA).
… With a digital brain
Surrounding the Poly Evolver's analog electronics is a high-speed Digital Signal Processor (DSP) that both pre- and post-processes the audio signal. Since the DSP also computes the control voltages for the analog circuitry, it can handle a wide range of modulation with high precision. The DSP provides audio functions such as the Digital Oscillators, Envelope Follower, the Peak/Hold detector (and associated external trigger generator), High-pass filter, Distortion (with noise gate), Pan, Delay, and Hack. It also handles the Poly Evolver's tuned feedback, and the additional Delay feedback paths. All the modulation calculations (envelopes, LFOs, routing, and so on) are DSP-controlled.
Surrounding the Poly Evolver's analog electronics is a high-speed Digital Signal Processor (DSP) that both pre- and post-processes the audio signal. Since the DSP also computes the control voltages for the analog circuitry, it can handle a wide range of modulation with high precision. The DSP provides audio functions such as the Digital Oscillators, Envelope Follower, the Peak/Hold detector (and associated external trigger generator), High-pass filter, Distortion (with noise gate), Pan, Delay, and Hack. It also handles the Poly Evolver's tuned feedback, and the additional Delay feedback paths. All the modulation calculations (envelopes, LFOs, routing, and so on) are DSP-controlled.
Four independent analog sequencers
Each of the Poly Evolver's four voices has its own sequencer. This allows some great wave-sequencing applications by gating sequences polyphonically from the keyboard. Each voice also has its own effects, such as feedback, distortion, and delay, which enables completely independent processing of each voice for a super thick sound.
Each of the Poly Evolver's four voices has its own sequencer. This allows some great wave-sequencing applications by gating sequences polyphonically from the keyboard. Each voice also has its own effects, such as feedback, distortion, and delay, which enables completely independent processing of each voice for a super thick sound.
Stereo audio inputs for processing external signals
The stereo audio inputs on the Poly Evolver go to all four voices, each of which can select to process or ignore the external signals, so you can do quad parallel processing of any audio source. Or, since there are stereo outputs on each of the Poly Evolver's four voices, you can route the output of one voice to the input of another voice for some interesting effects.
The stereo audio inputs on the Poly Evolver go to all four voices, each of which can select to process or ignore the external signals, so you can do quad parallel processing of any audio source. Or, since there are stereo outputs on each of the Poly Evolver's four voices, you can route the output of one voice to the input of another voice for some interesting effects.
Once you play a Poly Evolver, you'll immediately hear what's missing with all those soft and virtual synths - real personality and individuality.The Poly Evolver is much more than an analog retro synth. It starts with the benefits of true analog design, and then goes well beyond with the tightly integrated digital features. You get all the old stuff plus an all-new sound - check it out!
Dave Smith Instruments Poly Evolver Features:- Four-voice analog/digital synthesizer
- Five-octave semi-weighted keyboard, 77 knobs, and 59 switches
- Four oscillators in total: two analog, two digital
- Analog oscillator waveshape are sawtooth, triangle, saw-triangle, and pulse (with voltage-controlled analog pulse-width modulation)
- Digital oscillators feature 96 wavetables from the Prophet-VS and 32 user-loadable (via MIDI) wavetables
- Digital oscillators get trashy as the frequency gets higher, as with the original VS
- Hard sync on the analog oscillators
- FM and ring mod on the digital oscillators
- Separate Glide per oscillator, with two glide modes
- Real voltage-controlled analog low-pass filters - not digital recreations
- 4-pole/2-pole switchable filters, fully resonant (in 4-pole mode). Two separate filters, one for the left channel and one for the right
- Analog Voltage Controlled Amplifiers (VCA), one for each channel
- Dual digital 4-pole high-pass filters (one per channel) can be placed before or after analog electronics
- Stereo audio inputs; noise generator
- Envelope Follower and Peak Detect from External Input to use as modulation sources
- External input can be used to gate envelopes and/or step the sequencers
- Three snappy ADSR envelopes.
- Four LFOs (sync with sequencer and MIDI)
- Dual (left and right channel) tunable feedback loops; modulate frequency and amount
- Delay with 3 taps, each with separate time and amount modulation. Syncs to sequencer/MIDI. Normal feedback and additional feedback path through analog filters
- Distortion! Digital, one for each channel, can be placed before or after analog electronics
- 4 Banks of 128 Programs for 384 total Programs - dump to/from MIDI
- 16 x 4 analog-style sequencer - syncs with MIDI
- Extensive modulation capabilities, including audio-range modulation. Bipolar (+/-) modulation
- A bunch of MIDI stuff
- Internal controllers and DSP chips can be reprogrammed via MIDI, for easy feature additions