DEV SSH 2 stars sample-draw-handler-addin-v1.0.1

MPC Sample Draw Handler

A display add-on that lets MPC Sample plugins and add-ons draw their own full-screen pages, switching screen ownership between them and the stock app.

Screenshots (2)

Images: from jacob-sabella/mpc-addin-sample-draw-handler

About

mpc-addin-sample-draw-handler

An addin for the MPC Sample that owns the screen on behalf of the plugins and addins that draw on it. MPC's own UI on the Sample has no plugin page, so a plugin built for it can draw a full-screen page of its own: the addin decides which plugin may draw and puts its pixels on the panel.

Stompbox's page on the MPC Sample: the dial steps presets, the buttons step sections, the knobs turn

Keyscope's page Tuner's page

Recent releases

  • sample-draw-handler-addin-v1.0.1 MPC Sample draw handler addin v1.0.1 Nov 6, 2026
    Release on GitHub ↗
    Release notes

    Owns the MPC Sample's screen for plugins that draw on it: the last plugin to ask gets the whole screen until it gives it back.

    Requirements

    • A Gen2 MPC OS standalone device (aarch64: Live III, One G2, Key(s) G2). The installer refuses anything else.
    • Root shell access (SSH) to the device. Stock MPC OS doesn't offer this; you need a modded unit.
    • Installing addins this way is unofficial: back up first, use at your own risk.

    Install

    1. Unzip, then copy the whole folder to the device, e.g. scp -r MPC-Sample-draw-handler-addin-1.0.1 root@<device-ip>:/tmp/
    2. Run it: ssh root@<device-ip> sh /tmp/MPC-Sample-draw-handler-addin-1.0.1/install.sh

    The installer copies the addin into /data/mpc-addins/sample-draw-handler/, adds mpc_sample_draw_handler.so to the LD_PRELOAD list of MPC's service and restarts MPC (save your project first). The list is extended, never replaced: other addins and the libraries the firmware preloads stay. Where no writable file sets the list (the unit is on the read-only root), one drop-in shared by every addin sets it, /etc/systemd/system/<service>.service.d/90-mpc-addins.conf. Re-run the installer after a firmware update. -y skips the question, -n leaves the restart to you.

    Settings are in /data/mpc-addins/sample-draw-handler/mpc_sample_draw_handler.conf; an upgrade keeps your edits.

    On the MPC Sample it now owns the screen for plugins and addins that draw on it; a long hold of PAD FX cycles their pages. Control (on the device): http://127.0.0.1:6740/status, /test?on=1 shows a test pattern, /release gives MPC its screen back. From a computer: ssh -L 6740:127.0.0.1:6740 root@.

    Uninstalling and the file list are in INSTALL.md inside the zip.

    Changes in 1.0.1

    • After a page gave the screen back, parts of it could stay on the glass under MPC's waveform. MPC double-buffers its screen and redraws only what changed, so each framebuffer now keeps its own copy of MPC's pixels (seen on an MPC Sample, 2026-11-06).

    Built from jacob-sabella/mpc-addin-sample-draw-handler@c7f3960 with mpc-vst-plugins (tools/release-aarch64.sh). Tested on an MPC Sample (firmware 1.3.0.12) on 2026-11-06.

  • sample-draw-handler-addin-v1.0.0 MPC Sample draw handler addin v1.0.0 Nov 6, 2026
    Release on GitHub ↗
    Release notes

    Owns the MPC Sample's screen for plugins that draw on it: the last plugin to ask gets the whole screen until it gives it back.

    Requirements

    • A Gen2 MPC OS standalone device (aarch64: Live III, One G2, Key(s) G2). The installer refuses anything else.
    • Root shell access (SSH) to the device. Stock MPC OS doesn't offer this; you need a modded unit.
    • Installing addins this way is unofficial: back up first, use at your own risk.

    Install

    1. Unzip, then copy the whole folder to the device, e.g. scp -r MPC-Sample-draw-handler-addin-1.0.0 root@<device-ip>:/tmp/
    2. Run it: ssh root@<device-ip> sh /tmp/MPC-Sample-draw-handler-addin-1.0.0/install.sh

    The installer copies the addin into /data/mpc-addins/sample-draw-handler/, adds mpc_sample_draw_handler.so to the LD_PRELOAD list of MPC's service and restarts MPC (save your project first). The list is extended, never replaced: other addins and the libraries the firmware preloads stay. Where no writable file sets the list (the unit is on the read-only root), one drop-in shared by every addin sets it, /etc/systemd/system/<service>.service.d/90-mpc-addins.conf. Re-run the installer after a firmware update. -y skips the question, -n leaves the restart to you.

    Settings are in /data/mpc-addins/sample-draw-handler/mpc_sample_draw_handler.conf; an upgrade keeps your edits.

    On the MPC Sample it now owns the screen for plugins and addins that draw on it; a long hold of PAD FX cycles their pages. Control (on the device): http://127.0.0.1:6740/status, /test?on=1 shows a test pattern, /release gives MPC its screen back. From a computer: ssh -L 6740:127.0.0.1:6740 root@.

    Uninstalling and the file list are in INSTALL.md inside the zip.


    Built from jacob-sabella/mpc-addin-sample-draw-handler@fa9cb24 with mpc-vst-plugins (tools/release-aarch64.sh). The same code as 0.6.0, tested on an MPC Sample on 2026-11-05.

  • sample-draw-handler-addin-v0.6.0 MPC Sample draw handler addin v0.6.0 Nov 6, 2026
    Release on GitHub ↗
    Release notes

    Owns the MPC Sample's screen for plugins that draw on it: the last plugin to ask gets the whole screen until it gives it back.

    Requirements

    • A Gen2 MPC OS standalone device (aarch64: Live III, One G2, Key(s) G2). The installer refuses anything else.
    • Root shell access (SSH) to the device. Stock MPC OS doesn't offer this; you need a modded unit.
    • Installing addins this way is unofficial: back up first, use at your own risk.

    Install

    1. Unzip, then copy the whole folder to the device, e.g. scp -r MPC-Sample-draw-handler-addin-0.6.0 root@<device-ip>:/tmp/
    2. Run it: ssh root@<device-ip> sh /tmp/MPC-Sample-draw-handler-addin-0.6.0/install.sh

    The installer copies the addin into /data/mpc-addins/sample-draw-handler/, adds mpc_sample_draw_handler.so to the LD_PRELOAD list of MPC's service and restarts MPC (save your project first). The list is extended, never replaced: other addins and the libraries the firmware preloads stay. Where no writable file sets the list (the unit is on the read-only root), one drop-in shared by every addin sets it, /etc/systemd/system/<service>.service.d/90-mpc-addins.conf. Re-run the installer after a firmware update. -y skips the question, -n leaves the restart to you.

    Settings are in /data/mpc-addins/sample-draw-handler/mpc_sample_draw_handler.conf; an upgrade keeps your edits.

    On the MPC Sample it now owns the screen for plugins and addins that draw on it; a long hold of PAD FX cycles their pages. Control (on the device): http://127.0.0.1:6740/status, /test?on=1 shows a test pattern, /release gives MPC its screen back. From a computer: ssh -L 6740:127.0.0.1:6740 root@.

    Uninstalling and the file list are in INSTALL.md inside the zip.


    Built from jacob-sabella/mpc-addin-sample-draw-handler@3db0a76 with mpc-vst-plugins@9aab04f (tools/release-aarch64.sh). Tested on an MPC Sample on 2026-11-05.

Something wrong or missing on this page?

Opens GitHub's editor; your change becomes a pull request and you're credited as a contributor.