mike-kelly/remotewig

remotewig is a bridge between a web browser and Bitwig.

Forked from https://github.com/j28/remotewig

New Features

• View and set tempo
• Stop / zero button for transport (stops Bitwig if playing, zeros position if stopped)
• Toggle Metronome control
• Display current position
• Some simple updates to layout and CSS
• Added documentation and terminal prompts to make it easier to get started

---

Installation

Tested with node version 18.7.0

Install on the same computer which is running Bitwig.

From the command line:

1. In the /app folder, run npm install
2. In the /app/web folder, run npm install
   Both folders should now have node_modules folders with npm libraries installed
3. In the /app folder, run npm run setup
4. Add the contents of /controller-scripts to your Bitwig Controller Scripts folder

Running the Application From Source

1. In the /app folder, start the Node.js server with npm run serve
2. A URL will be displayed in the terminal—this is the address to open in your web browser. A log message will be printed to the terminal when you are successfully connected. You will want to open the browser page on a remote computer, but in the same local network as the computer running Bitwig. The URL of the page is likely to be something like http://192.168.1.x:8888

Note: The npm run setup script tries to write the correct IP address to /app/web/assets/js/websocketIP.js. You can edit this value manually if required, to match the local area network IP of your host computer.

Packaging as a Standalone

1. Make sure you have already run npm run setup (see step 3 in Installation above)
2. Install pkg using npm install -g pkg
3. To package for mac, in the /app folder run npm run build (The build script assumes use of node v18.x.x)

Running as a Standalone

In the /app folder, run ./remotewig, or double click on the remotewig executable file which has been created in the app folder. You can move it to another location on your computer if required.