Add vim swap ignore and README build/install instructions

This commit is contained in:
Armin 2026-08-05 20:05:38 +02:00
commit 6ebf6dd04a
2 changed files with 26 additions and 3 deletions

4
.gitignore vendored
View file

@ -17,6 +17,7 @@ CMakeOutput.log
CMakeError.log CMakeError.log
cmake-build-*/ cmake-build-*/
Makefile Makefile
!Makefile
*.ninja *.ninja
# Xcode # Xcode
@ -31,7 +32,8 @@ DerivedData/
.vs/ .vs/
*.sublime-project *.sublime-project
*.sublime-workspace *.sublime-workspace
*.swp *.sw[a-p]
.*.sw[a-p]
*~ *~
# macOS # macOS

View file

@ -46,15 +46,36 @@ The VST3 plugin is written to:
build/MonoStep_artefacts/Release/VST3/MonoStep.vst3 build/MonoStep_artefacts/Release/VST3/MonoStep.vst3
``` ```
### Installing ### Quick start with make
Copy the bundle into your DAW's VST3 directory: A `Makefile` wraps configure, build, and install. Just run `make`:
```sh
make # build the plugin and copy it into ~/Library/Audio/Plug-Ins/VST3/
make test # build and run the headless host test
make clean # remove the build directory
```
### Installing (manual copy)
The VST3 plugin ships as a macOS bundle (`MonoStep.vst3`). Copy the whole
bundle into your DAW's VST3 directory:
```sh ```sh
cp -R build/MonoStep_artefacts/Release/VST3/MonoStep.vst3 \ cp -R build/MonoStep_artefacts/Release/VST3/MonoStep.vst3 \
~/Library/Audio/Plug-Ins/VST3/ ~/Library/Audio/Plug-Ins/VST3/
``` ```
Notes for macOS:
- The per-user VST3 directory is `~/Library/Audio/Plug-Ins/VST3/`; create it
with `mkdir -p` if it does not exist. A system-wide copy would go to
`/Library/Audio/Plug-Ins/VST3/` but requires `sudo`.
- When updating, remove the old bundle first (`rm -rf` on the `MonoStep.vst3`
inside the target directory) so stale files do not remain.
- Your DAW may cache the plugin list — quit and relaunch it (or rescan plugins)
after installing before looking for MonoStep.
## Running the tests ## Running the tests
Build the headless host test and run it against the built plugin: Build the headless host test and run it against the built plugin: