mastropinguino / qmidinet Goto Github PK

QmidiNet - A MIDI Network Gateway via UDP/IP Multicast
------------------------------------------------------

QmidiNet is a MIDI network gateway application that sends and receives
MIDI data (ALSA Sequencer [2] and/or JACK MIDI [3]) over the network, using
UDP/IP multicast. Inspired by multimidicast (https://llg.cubic.org/tools)
and designed to be compatible with ipMIDI for Windows (https://nerds.de).

Website:

  https://qmidinet.sourceforge.io
  http://qmidinet.sourceforge.net

Project page:

  https://sourceforge.net/projects/qmidinet

Weblog:

  https://www.rncbc.org

QmidiNet is free, open-source software, distributed under the terms of
the GNU General Public License (GPL) [4] version 2 or later.


Requirements
------------

The software requirements for build and runtime are listed as follows:

  Mandatory:

  [1] Qt framework, C++ class library and tools for
        cross-platform application and UI development
        https://qt.io/

  [2] ALSA, Advanced Linux Sound Architecture
        https://www.alsa-project.org/

  Optional (opted-in at build time):

  [3] JACK Audio Connection Kit
        https://jackaudio.org/

  
Installation
------------

The installation procedure follows the standard for source distributions.
Unpack the tarball and in the extracted source directory:

    ./configure [--prefix=/usr/local]
    make

and optionally as root:

    make install

This procedure will end installing the following couple of files:

    ${prefix}/bin/qmidinet
    ${prefix}/share/applications/qmidinet.desktop
    ${prefix}/share/icons/hicolor/32x32/apps/qmidinet.png

Just launch ${prefix}/bin/qmidinet and you're off (hopefully).

Note that the default installation path ${prefix} is /usr/local.

If you're checking out from Git, you'll have to prepare the
configure script just before you proceed with the above instructions:

   ./autogen.sh


Configuration
-------------

QmidiNet holds its settings and configuration state per user, in a file
located as $HOME/.config/rncbc.org/QmidiNet.conf . Normally, there's no
need to edit this file, as it is recreated and rewritten everytime
qmidinet is run.


Bugs
----

Plenty still, after all this is alpha software ;)


Support
-------

QmidiNet is open source free software. For bug reports, feature requests,
discussion forums, mailling lists, or any other matter related to the
development of this piece of software, please use the Sourceforge
project page (https://sourceforge.net/projects/qmidinet).

You can also find timely and closer contact information on my personal
web site (https://www.rncbc.org).


References
----------

[1] Qt framework, C++ class library and tools for
     cross-platform application and UI development
     https://qt.io/

[2] ALSA, Advanced Linux Sound Architecture
     https://www.alsa-project.org/

[3] JACK Audio Connection Kit
     https://jackaudio.org/

[4] GNU General Public License
     https://www.gnu.org/copyleft/gpl.html


Enjoy.

rncbc aka Rui Nuno Capela
rncbc at rncbc dot org
https://www.rncbc.org