https://github.com/ajboni/calvo
ð§ðžâðĶē A jalv based lv2 plugin rack for your terminal.
https://github.com/ajboni/calvo
hacktoberfest jalv lv2 lv2-host
Last synced: 6 months ago
JSON representation
ð§ðžâðĶē A jalv based lv2 plugin rack for your terminal.
- Host: GitHub
- URL: https://github.com/ajboni/calvo
- Owner: ajboni
- License: agpl-3.0
- Created: 2020-06-26T01:25:20.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2023-08-20T22:25:55.000Z (almost 2 years ago)
- Last Synced: 2024-12-08T16:55:11.766Z (6 months ago)
- Topics: hacktoberfest, jalv, lv2, lv2-host
- Language: JavaScript
- Homepage: https://ajboni.github.io/calvo/
- Size: 3.82 MB
- Stars: 11
- Watchers: 3
- Forks: 2
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Calvo ð§ðžâðĶē
Calvo is a [jalv](http://drobilla.net/software/jalv) based LV2 plugin browser and host to stack plugins in a rack fashion.
[](https://www.youtube.com/watch?v=3TH-dt7sods "Watch in YouTube")
# Features
- Runs entirely on the terminal.
- Suports launching multiple instances of jalv and eventually calvo.
- Category based plugin browser.
- Autoconnect inputs of system, and every plugin, linearly until reaching configured output. Dealing with mono/stereo conversion along the way.
- Basic parameters controls.
- Basic plugin output controls monitoring.
- Load plugin presets.
- Move plugins order.
- Alpha
# Limitations
- No GUI customization is loaded, any plugin which has a UI based workflow won't work properly.
- Only works with mono or stereo inputs/outputs.
- Monitoring is best effort and should not be taken too seriously.
### Roadmap to 1.0: [Milestone](https://github.com/ajboni/calvo/milestone/1)
# Dependencies
It uses:
- [jalv](http://drobilla.net/software/jalv) to host plugins
- [lilv](http://drobilla.net/software/lilv) to get plugin data
- JACK and jack-client
- [blessed](https://github.com/chjj/blessed) for the UI.
- nodejs to glue all together
For arch linux: `sudo pacman -S python-jack-client lilv jalv`
# Settings
Modify `.config.yaml` with your settings, more info [in the docs](https://ajboni.github.io/calvo/module-settings.html).
# Keyboard shortcuts
## KEYBOARD SHORTCUTS
| Context | Modifier | Combination | Action |
| ------------------------ | -------- | ------------------- | ---------------------------------------------------- |
| General | - | 1 ... 9 | Select menu option. |
| General | - | TAB | Focus next widget |
| Layout | SHIFT | TAB | Focus previous widget |
| Rack | - | RETURN | Select plugin. |
| Rack | - | DELETE | Remove Plugin |
| Rack | CTRL | UP / DOWN | Swap plugins up/down |
| Plugin Parameters Widget | - | UP / DOWN - TAB | Cycle through parameters. |
| Plugin Parameters Widget | - | LEFT / RIGHT | Change parameter value by default step |
| Plugin Parameters Widget | SHIFT | LEFT / RIGHT | Change parameter value by small step. |
| Plugin Parameters Widget | CTRL | LEFT / RIGHT | Change parameter value by big step. |
| Plugin Parameters Widget | - | TODO | Change parameter value by 1/5 of the maximum allowed |
| Plugin Parameters Widget | - | PAGE UP / PAGE DOWN | Scroll properties |
# DEV
Still need to figure out a way to distribute this.
For the time being it can be build from source.
Make sure to have the dependencies installed first.
```
git clone https://github.com/ajboni/calvo.git
git submodule init
git submodule update
npm install
npm start
```
### Documentation
Dev Documentation is available at: https://ajboni.github.io/calvo/
To build doc locally:
```
npm run document
```
documentation will be available at ./docs
@TODO: set up travis build to do this automatically