QmidiCtl - A MIDI Remote Controller via UDP/IP Multicast
--------------------------------------------------------

QmidiCtl is a MIDI remote controller application that sends MIDI data
over the network, using UDP/IP multicast. Inspired by multimidicast [3]
and designed to be compatible with ipMIDI for Windows [4].

QmidiCt [1] has been primarily designed for the Maemo [5] enabled
handheld devices, namely the Nokia N900 [6] and also being promoted
to the Maemo Package [7] repositories. Nevertheless, QmidiCtl [1]
may still be found effective as a regular desktop and, ultimately,
as an Android application as well [8].

Website:

  https://qmidictl.sourceforge.io
  https://qmidictl.sourceforge.net

Project page:

  https://sourceforge.net/projects/qmidictl

Weblog:

  https://www.rncbc.org

QmidiNet is free, open-source software, distributed under the terms of
the GNU General Public License (GPL) [2] 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/


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

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


Bugs
----

Probably plenty still, QjackCtl maybe considered on beta stage already.


Support
-------

QmidiCtl 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/qmidictl).

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] GNU General Public License
     https://www.gnu.org/copyleft/gpl.html

 [3] multimidicast - sends and receives MIDI from ALSA sequencers over network
     https://llg.cubic.org/tools/multimidicast

 [4] ipMIDI - MIDI over Ethernet ports - send MIDI over your LAN
     https://nerds.de

 [5] Maemo.org - Home of the Maemo community
     http://www.maemo.org

 [6] Maemo.org Wiki - Nokia N900
     http://wiki.maemo.org/Nokia_N900

 [7] Maemo.org - Downloads: QmidiCtl
     http://maemo.org/downloads/product/Maemo5/qmidictl

 [8] Get it on Google Play Store
     https://play.google.com/store/apps/details?id=org.rncbc.qmidictl


Enjoy.

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