linux-midi-latch 1.0.0__tar.gz

linux_midi_latch-1.0.0/.gitignore

@@ -0,0 +1,4 @@
+*.egg-info
+dist
+__pycache__
+token

linux_midi_latch-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 @readwith
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

linux_midi_latch-1.0.0/PKG-INFO

@@ -0,0 +1,46 @@
+Metadata-Version: 2.4
+Name: linux-midi-latch
+Version: 1.0.0
+Summary: MIDI note latch for Linux using mididings
+Project-URL: Homepage, https://github.com/talwrii/linux-midi-latch
+Project-URL: Repository, https://github.com/talwrii/linux-midi-latch
+License: MIT
+License-File: LICENSE
+Keywords: latch,linux,midi,mididings,music
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Multimedia :: Sound/Audio :: MIDI
+Requires-Python: >=3.8
+Requires-Dist: mido
+Requires-Dist: python-rtmidi
+Description-Content-Type: text/markdown
+
+# linux midi latch
+Implement latch functionality where each key acts as a toggle for a note for midi devices on linux. Optionally switch this functionality on and off with the systain pedal. Uses mido, only works on linux
+
+## Alternatives and prior work
+Some hardware implements latching. Apparently Nord Lead A1, Sequential Prophet 6 and Novation Summit amongt others.
+
+mido gives you complete control over what midi doers so you can do what you want if you are willing to put in the work - which has become fairly cheap with LLMs. Apparently, the VST Bidule has a midi latch feature as does VCV rack. These will work on windows. `loopMIDI` combined with mido apparently gives you programmatic contorl on windows. I have not tried most of thse things.
+
+## Installation
+pipx install linux-midi-latch
+
+## Usage
+`linux-midi-latch --alsa`
+
+Use `aconnect` to route midi traffic through linux-midi-latch.
+
+There are --jack and --osc options. I have not tested them nor do I know how to use them, but mididings works with jthem.
+
+## My setup
+I am using this with an impact gxp6 nektar on Ubuntu LTS with a yamaha sustain pedel using alsa midi and fluidsynth.
+
+## About me
+I am @readwith. I make tools for reading and agency and research - with and without Obsidian and AI.
+You can follow me https::/readwithai.substack.com/ and https://x.com/readwithai
+
+I also mess around with music and fitness technology. I have a treadmill desk with a lot of musical instruments. See [r/musicaltreadmilldesk](https://www.reddit.com/r/musicaltreadmilldesk/) for this. If you like this sort of tool you may well want to follow me there.
+

linux_midi_latch-1.0.0/README.md

@@ -0,0 +1,27 @@
+# linux midi latch
+Implement latch functionality where each key acts as a toggle for a note for midi devices on linux. Optionally switch this functionality on and off with the systain pedal. Uses mido, only works on linux
+
+## Alternatives and prior work
+Some hardware implements latching. Apparently Nord Lead A1, Sequential Prophet 6 and Novation Summit amongt others.
+
+mido gives you complete control over what midi doers so you can do what you want if you are willing to put in the work - which has become fairly cheap with LLMs. Apparently, the VST Bidule has a midi latch feature as does VCV rack. These will work on windows. `loopMIDI` combined with mido apparently gives you programmatic contorl on windows. I have not tried most of thse things.
+
+## Installation
+pipx install linux-midi-latch
+
+## Usage
+`linux-midi-latch --alsa`
+
+Use `aconnect` to route midi traffic through linux-midi-latch.
+
+There are --jack and --osc options. I have not tested them nor do I know how to use them, but mididings works with jthem.
+
+## My setup
+I am using this with an impact gxp6 nektar on Ubuntu LTS with a yamaha sustain pedel using alsa midi and fluidsynth.
+
+## About me
+I am @readwith. I make tools for reading and agency and research - with and without Obsidian and AI.
+You can follow me https::/readwithai.substack.com/ and https://x.com/readwithai
+
+I also mess around with music and fitness technology. I have a treadmill desk with a lot of musical instruments. See [r/musicaltreadmilldesk](https://www.reddit.com/r/musicaltreadmilldesk/) for this. If you like this sort of tool you may well want to follow me there.
+

linux_midi_latch-1.0.0/linux_midi_latch/main.py

@@ -0,0 +1,149 @@
+#!/usr/bin/env python3
+"""
+linux-midi-latch - MIDI note latch for Linux using mido.
+
+Each note press toggles that note on/off (latch mode).
+
+Sustain pedal modes:
+  default           -- latch always on; first sustain touch switches to --sustain-pedal mode
+  --ignore-sustain  -- latch always on, sustain passed through untouched
+  --sustain-pedal   -- sustain pedal must be held for latch to be active
+  --sustain-toggles -- sustain pedal press toggles latch on/off
+"""
+
+import argparse
+import mido
+import mido.backends.rtmidi  # noqa
+
+latched_notes = set()
+latch_active = True
+sustain_down = False
+sustain_mode = None
+
+def note_off_msg(channel, note):
+    return mido.Message('note_off', channel=channel, note=note, velocity=0)
+
+def note_on_msg(channel, note, velocity):
+    return mido.Message('note_on', channel=channel, note=note, velocity=velocity)
+
+def process_note(msg, outport):
+    if not latch_active:
+        outport.send(msg)
+        return
+
+    note = msg.note
+    channel = msg.channel
+
+    if msg.type == 'note_on' and msg.velocity > 0:
+        if note in latched_notes:
+            latched_notes.discard(note)
+            outport.send(note_off_msg(channel, note))
+        else:
+            latched_notes.add(note)
+            outport.send(note_on_msg(channel, note, msg.velocity))
+    # swallow note_off — latch holds the note
+
+
+def process_sustain_default(msg, outport):
+    global sustain_mode, latch_active, sustain_down
+
+    pedal_down = msg.value >= 64
+
+    if sustain_mode == 'default':
+        print("Sustain pedal detected — switching to sustain-pedal mode")
+        sustain_mode = 'pedal'
+
+    sustain_down = pedal_down
+    latch_active = pedal_down
+    if pedal_down:
+        print("Pedal down — latch on")
+    else:
+        print("Pedal released — latch off (notes keep ringing)")
+
+
+def process_sustain_pedal(msg, outport):
+    global latch_active, sustain_down
+
+    pedal_down = msg.value >= 64
+    sustain_down = pedal_down
+    latch_active = pedal_down
+
+    if pedal_down:
+        print("Pedal down — latch on")
+    else:
+        print("Pedal released — latch off (notes keep ringing)")
+
+
+def process_sustain_toggles(msg, outport):
+    global latch_active
+
+    if msg.value >= 64:
+        latch_active = not latch_active
+        print(f"Latch {'on' if latch_active else 'off'}")
+
+
+def main():
+    global sustain_mode
+
+    parser = argparse.ArgumentParser(
+        prog='linux-midi-latch',
+        description='MIDI note latch for Linux. Route MIDI through this with aconnect.',
+        epilog='example: linux-midi-latch --alsa',
+    )
+
+    backend_group = parser.add_mutually_exclusive_group(required=True)
+    backend_group.add_argument('--alsa', action='store_true', help='Use ALSA MIDI backend')
+    backend_group.add_argument('--jack', action='store_true', help='Use JACK MIDI backend')
+
+    sustain_group = parser.add_mutually_exclusive_group()
+    sustain_group.add_argument('--ignore-sustain', action='store_true',
+        help='Latch always on, sustain pedal passed through untouched')
+    sustain_group.add_argument('--sustain-pedal', action='store_true',
+        help='Sustain pedal must be held for latch to be active')
+    sustain_group.add_argument('--sustain-toggles', action='store_true',
+        help='Sustain pedal press toggles latch on/off')
+
+    args = parser.parse_args()
+
+    if args.ignore_sustain:
+        sustain_mode = 'ignore'
+        sustain_fn = None
+        print("Latch on. Sustain pedal ignored.")
+    elif args.sustain_pedal:
+        sustain_mode = 'pedal'
+        sustain_fn = process_sustain_pedal
+        print("Latch active while sustain pedal is held.")
+    elif args.sustain_toggles:
+        sustain_mode = 'toggles'
+        sustain_fn = process_sustain_toggles
+        print("Latch on. Sustain pedal toggles latch.")
+    else:
+        sustain_mode = 'default'
+        sustain_fn = process_sustain_default
+        print("Latch on. First sustain touch will switch to sustain-pedal mode.")
+
+    if args.alsa:
+        mido.set_backend('mido.backends.rtmidi/LINUX_ALSA')
+    else:
+        mido.set_backend('mido.backends.rtmidi/UNIX_JACK')
+
+    print(f"Backend: {'alsa' if args.alsa else 'jack'}. Use aconnect to route MIDI through linux-midi-latch.")
+
+    with mido.open_input('linux-midi-latch', virtual=True) as inport, \
+         mido.open_output('linux-midi-latch out', virtual=True) as outport:
+
+        print("Ready.")
+        for msg in inport:
+            if msg.type in ('note_on', 'note_off'):
+                process_note(msg, outport)
+            elif msg.type == 'control_change' and msg.control == 64:
+                if sustain_fn:
+                    sustain_fn(msg, outport)
+                else:
+                    outport.send(msg)
+            else:
+                outport.send(msg)
+
+
+if __name__ == '__main__':
+    main()

linux_midi_latch-1.0.0/pyproject.toml

@@ -0,0 +1,26 @@
+[build-system]
+requires = [ "hatchling",]
+build-backend = "hatchling.build"
+
+[project]
+name = "linux-midi-latch"
+version = "1.0.0"
+description = "MIDI note latch for Linux using mididings"
+readme = "README.md"
+requires-python = ">=3.8"
+dependencies = [ "mido", "python-rtmidi",]
+keywords = [ "midi", "latch", "linux", "mididings", "music",]
+classifiers = [ "Environment :: Console", "Operating System :: POSIX :: Linux", "Programming Language :: Python :: 3", "License :: OSI Approved :: MIT License", "Topic :: Multimedia :: Sound/Audio :: MIDI",]
+
+[project.license]
+text = "MIT"
+
+[project.scripts]
+linux-midi-latch = "linux_midi_latch.main:main"
+
+[project.urls]
+Homepage = "https://github.com/talwrii/linux-midi-latch"
+Repository = "https://github.com/talwrii/linux-midi-latch"
+
+[tool.hatch.build.targets.wheel]
+packages = [ "linux_midi_latch",]

linux_midi_latch-1.0.0/release

@@ -0,0 +1,47 @@
+#!/bin/bash
+set -o errexit
+set -o nounset
+set -o pipefail
+
+# SSH ControlMaster setup
+CONTROL_PATH="/tmp/ssh-release-%r@%h:%p"
+
+echo "🔐 Establishing SSH connection to GitHub..."
+ssh -o ControlMaster=yes -o ControlPath="$CONTROL_PATH" -o ControlPersist=300 -fN git@github.com
+
+# Use ControlMaster for git
+export GIT_SSH_COMMAND="ssh -o ControlPath=$CONTROL_PATH"
+
+# Fail if there are any modified files
+if ! git diff-index --quiet HEAD --; then
+    echo "Error: You have uncommitted changes to tracked files"
+    git status --short
+    ssh -o ControlPath="$CONTROL_PATH" -O exit git@github.com 2>/dev/null || true
+    exit 1
+fi
+
+git push
+ 
+if [ -f pyproject.toml ]; then
+    VERSION=$(cat pyproject.toml | toml2json | jq -rc '.project.version')
+else
+    VERSION=$(python3 setup.py --version)
+fi
+
+git tag "$VERSION"
+git push --tags
+
+rm -rf dist *.egg-info build
+
+if [ -f pyproject.toml ]; then
+    python3 -m build
+else
+    python3 setup.py sdist
+fi
+
+twine upload -p $(cat token) dist/*
+
+# Close ControlMaster
+ssh -o ControlPath="$CONTROL_PATH" -O exit git@github.com 2>/dev/null || true
+
+echo "✅ Released version $VERSION"