File	Date	Author	Commit
debian	2024-06-16	rncbc	[0408a1] - Making up the unthinkable (aka. v1.0.0) (2)
rpm	2024-06-16	rncbc	[0408a1] - Making up the unthinkable (aka. v1.0.0) (2)
src	2024-06-16	rncbc	[0408a1] - Making up the unthinkable (aka. v1.0.0) (2)
.gitignore	2022-01-11	rncbc	[120685] - Ignore qtcreator project state files.
CMakeLists.txt	2024-06-16	rncbc	[0408a1] - Making up the unthinkable (aka. v1.0.0) (2)
ChangeLog	2024-06-16	rncbc	[0408a1] - Making up the unthinkable (aka. v1.0.0) (2)
LICENSE	2021-12-05	rncbc	[63bc8b] - Dropped autotools (autoconf, automake, etc.) ...
README	2022-08-12	rncbc	[79632e] - Update corrected README.

Read Me

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
------------

Unpack the tarball and in the extracted source directory:

    cmake [-DCMAKE_INSTALL_PREFIX=<prefix>] -B build
    cmake --build build [--parallel <Njobs>]

and optionally, as root:

    [sudo] cmake --install build

Note that the default installation path (<prefix>) is /usr/local .


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