diff --git a/LICENSE.MIT b/LICENSE.MIT new file mode 100644 index 0000000..45abda0 --- /dev/null +++ b/LICENSE.MIT @@ -0,0 +1,20 @@ +Copyright 2022 Erkki Seppälä + +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. diff --git a/README.md b/README.md new file mode 100644 index 0000000..2c5ca6d --- /dev/null +++ b/README.md @@ -0,0 +1,29 @@ +Copyright 2022 Erkki Seppälä + +Licensed under the [`MIT license`](LICENSE.MIT). + +* midihidi + +`midihidi` converts a MIDI keyboard to a regular `evdev`-supported one +by reading MIDI data (via Jack or the Jack layer of PipeWire) and +providing them via `/dev/uinput` to `/dev/input/event?`. This provides +the ability to enter keyboard input to any Linux application, +including virtual consoles. + +* Setup + +You need to arrange both Jack/PipeWire and uinput to be accessible by +the sabme user. Most easily this can be achieved by changing to +ownership of `/dev/uinput` to have the same user id as your current +user id: + +``` +sudo chown $USER /dev/uinput +``` + +The best alternative would be to have special user that is able to +access the device via ownership or group ownership, and also able to +interact with the user's media. I haven't yet tried how to make this +happen.. + +* Usage