Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/madskjeldgaard/birdhouse

An OSC to Midi Bridge. Cross-platform. VST, CLAP, Standalone.
https://github.com/madskjeldgaard/birdhouse

clap-plugin juce juce-framework midi osc vst3

Last synced: about 1 month ago
JSON representation

An OSC to Midi Bridge. Cross-platform. VST, CLAP, Standalone.

Host: GitHub
URL: https://github.com/madskjeldgaard/birdhouse
Owner: madskjeldgaard
License: other
Created: 2024-02-17T21:43:57.000Z (10 months ago)
Default Branch: main
Last Pushed: 2024-08-20T14:51:26.000Z (4 months ago)
Last Synced: 2024-08-20T17:04:14.913Z (4 months ago)
Topics: clap-plugin, juce, juce-framework, midi, osc, vst3
Language: C++
Homepage:
Size: 3.25 MB
Stars: 29
Watchers: 2
Forks: 1
Open Issues: 17
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

[![Build](https://github.com/madskjeldgaard/Birdhouse/actions/workflows/cmake_build.yml/badge.svg)](https://github.com/madskjeldgaard/Birdhouse/actions/workflows/cmake_build.yml)

[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/X8X6RXV10)

# BirdHouse
## An OSC to MIDI bridge

![Birdhouse in action](manual/bitwigcc.png)

With BirdHouse you can receive OSC messages with a DAW or plugin host and have them converted to MIDI.

The Birdhouse OSC to MIDI plugin is a simple plugin that listens for OSC messages, processes their data and sends outputs it as MIDI to allow using it in a DAW or other plugin host environment. Each instance of Birdhouse is able to process a stream of OSC messages to a MIDI event type, with a visualization of the stream and the ability to mute/unmute the output data.

The need for this plugin arose from having to make different projects that rely on OSC communication to generate notes or affect sound parameters. Often this was solved with middlewares written in one of the common computer music languages, with varying levels of success and then passed on to different Digital Audio Workstations with even more varying levels of success. The thing is, different software process OSC messages with different priority levels. This can be annoying in interactive art since we sometimes want to blast software with values from sensors, other software or from wherever, and be able to expect pretty consistent results. Birdhouse attempts to solve this.

[![Birdhouse in action](http://img.youtube.com/vi/Of1s9zzU6Jo/0.jpg)](http://www.youtube.com/watch?v=Of1s9zzU6Jo)

## Features

- Convert OSC to MIDI inside any DAW or plugin host
- Realtime-processing of the incoming OSC messages
- Audio-rate MIDI
- Scale from any input value range to MIDI ranges automatically
- Process 8 streams of OSC messages per instance
- Output common MIDI message types: Note on/off, MIDI CC, Pitch bend (more coming)

## Use cases

- Controlling your DAW using a phone or tablet
- Sending OSC from an Arduino, ESP or Raspberry Pi Pico to a DAW to trigger notes or control parameter changes in plugins
- Using OSC to control a DAW using computer music software like SuperCollider, Max/MSP or PureData

## Supported hosts

Tested and working in:
- ✅ Reaper
- ✅ BitWig
- ✅ Ardour (see [this for more info on setup](https://github.com/madskjeldgaard/Birdhouse/issues/45))

Untested:
- ✖️ Ableton Live
- ✖️ Logic Pro
- ✖️ Cubase
- ✖️ Pro Tools
- ✖️ FL Studio
- ✖️ Studio One
- ✖️ Reason

If you test the plugin in one of the untested or unmentioned hosts, please open an issue and let us know how it worked.

# Usage

[![Birdhouse in action](http://img.youtube.com/vi/Of1s9zzU6Jo/0.jpg)](http://www.youtube.com/watch?v=Of1s9zzU6Jo)

See the [manual](manual/birdhouse-manual.pdf) or check out this [tutorial on YouTube](http://www.youtube.com/watch?v=Of1s9zzU6Jo).

# Development

This project was generated using [Cookiejuce](github.com/madskjeldgaard/Cookiejuce).

## Supporting the project

If you find this project useful and want to support it, please consider supporting it by [buying me a coffee](https://ko-fi.com/madskjeldgaard).

## Build and install

### Prerequisites

- CMake
- [git lfs](https://docs.github.com/en/repositories/working-with-files/managing-large-files/installing-git-large-file-storage)

### Building

Download source code (make sure eto include submodules):

```bash
git clone --recurse-submodules https://github.com/madskjeldgaard/Birdhouse.git
cd Birdhouse
```

Configure:
```bash
cmake -S . -B build
```

Build.

This will automatically install the plugins on your system.

If you want the standalone, you should copy it manually.

```bash
cmake --build build
```

The plugins are now copied to your system.

Run standalone (on MacOS):
```bash
./build/BirdHouse_artefacts/Standalone/BirdHouse.app/Contents/MacOS/BirdHouse
```

## Building the manual

The manual is built using pandoc. Run it from the root of the repo:

```bash
pandoc -i manual/birdhouse-manual.md -o manual/birdhouse-manual.pdf
```