Skip to content

MOD-DOCKER is an open-source MOD Software emulator for Linux based on Docker that lets you play around with hundreds of LV2 audio plugins!

License

Notifications You must be signed in to change notification settings

raidolo/mod-docker

 
 

Repository files navigation

MOD Software 2023 version

I've forked this code from the very good work made by Alexis Boni in his mod-docker implementation His code was running an old version of the mod-ui interface. I made all the changes to build the current MOD software, taken from the MOD GitHub I did this basically because Mike Oliphant has released a Neural Amp Modeler LV2 plugin and I wanted to have a nice a powerful LV2 host to play with Linux. MOD Devices also made a mod-live-usb ISO to boot an x86 PC with their software, but it's difficult to use and booting from USB would not be ideal.

Additionally, I also built all the current MOD Plugins available in the mod-plugin-builder repo so not only you have the free LV2 plugins that Alexis included in his version of mod-docker, but at the end the host will offer nearly 1000 LV2 plugins :)

Another nice additional touch, I've also added the browsepy File manager so you can upload files directly from the MOD UI we interface.

LATEST Changes

MIDI Program Change Commands are working now while the UI is open in the web browser. I had to fork the original MOD Devices mod-ui and now the Dockerfile points to my version https://github.com/raidolo/mod-ui The Pedalboards can be changed using MIDI Channel 1, the Snapshots can be changed using MIDI Channel 2. The values for the Program Change start at 0 (zero), so using for instance Channel 1 PC 0 it loads the first pedalboard in your library and so on... the pedalboards are ordered in a not so clear way in mod-ui, so it's better if you call them like "001 - First song", "002 - Second song" and so on, this way you can keep them in the desired order.

Little Bug: Currently there is a bug in mod-ui, when you change the pedalboard via MIDI, the page refreshes, but the title on the top left keep the previous pedalboard name. If you refresh the mod-ui page then it updates correctly. I tried to fix it but i had no luck, sorry.

Prebuilt Image on Docker Hub

This repo contains all the code to build the docker containers yourself, but because it can take a lot of time I also made a docker prebuilt image available here: raidolo/mod-ui on Docker Hub

mod-docker

MOD-DOCKER is an open-source MOD Software emulator for Linux based on Docker that lets you play around with hundreds of LV2 audio plugins! This project aims to provide a docker container in order to use mod-host and mod-ui painlessly from your linux machine.

MOD team has done a remarkable job for the whole Linux audio open-source community, so if you like this emulator you should go get the real thing!

This project is heavily inspired in MODEP

REQUIREMENTS

You need to be have docker installed, docker-compose, JACK audio server should run at the HOST level, it should be installed in your linux Distro and already running before starting the container, aldo your user should be part of "audio" group.

The run scripts available in thie repo make three directories in yout $HOME folder, then the docker compose bind these local dire in the container, this is needed for the browsepy file manager and to store your files permanently in your home folder.

The directory that will be made are: $HOME/mod-user-files $HOME/mod-data $HOME/mod-pedalboards

USAGE to BUILD everything

WARNING It could a long time to compile

  • Clone the repo git clone https://github.com/raidolo/mod-docker.git
  • chmod +x run_build.sh
  • ./run_build.sh
  • go to http://localhost:8888 and start playing!

USAGE to DOWNLOAD the prebuilt Docker Image

  • Clone the repo git clone https://github.com/raidolo/mod-docker.git
  • chmod +x run_docker.sh
  • ./run_docker.sh
  • go to http://localhost:8888 and start playing!

TODO / GOTCHAS

Currently the builder uses the kxrepos plugins and the mod-plugin-builder plugins

Also some plugins does not provide modguis so thy will be 'ugly'. Also some might not even work.

At the moment the container is just one, because it contains everything needed to run, I didn't have time to understant why in the original version of Alexis Bonis he was not able to run mod-host in a separate container, if it will be needed I'll investigate it.

image

About

MOD-DOCKER is an open-source MOD Software emulator for Linux based on Docker that lets you play around with hundreds of LV2 audio plugins!

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Dockerfile 69.2%
  • Shell 30.8%