basileus / qlcplus Goto Github PK

Q Light Controller Plus 4

Copyright (c) Heikki Junnila
	      Massimo Callegari

EMail: [email protected]
QLC+ on SourceForge: http://qlcplus.sourceforge.net/index.shtml
QLC+ on GitHub: https://github.com/mcallegari/qlcplus

DEVELOPERS AT WORK
------------------

If you're compiling QLC+ from sources and you regularly do "git pull" 
to get the latest sources, you probably end up seeing some
compiler warnings and errors from time to time. Since the whole source package
is under development, you might even encounter unresolved symbols etc. that
halt the compiler immediately. If such a thing occurs, you should do a "make
distclean" on qlcplus (top-most source directory) and then "qmake" and "make"
again. We attempt to keep the GIT master free of fatal errors and it should
compile all the time. However, some inter-object dependencies do get mixed up
sometimes and you need to compile the whole package instead of just the latest
changes. Sometimes even that doesn't work, because QLC+ installs its common
libraries to system directories, where (at least unixes) fetch them instead
of the source directory. In those cases, you might try going to the libs
directory, compile it with "make" and install with "make install" and then
attempt to re-compile the whole package with "make".

Apache 2.0 License
------------------
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Requirements - Linux
--------------------
* Qt >= 4.6 development libraries & tools

* Enttec DMX USB plugin: libftdi-dev, pkg-config
* HID plugin: No additional requirements
* MIDI plugin: libasound, libasound-dev, pkg-config
* ENTTEC Wing plugin: No additional requirements
* OLA plugin: libola, ola-dev, pkg-config (see libs/olaout/README)
* uDMX plugin: libusb, libusb-dev, pkg-config
* Peperoni plugin: libusb, libusb-dev, pkg-config
* Velleman plugin: Not available for Linux
* OSC plugin: liblo-dev, pkg-config
* ArtNet plugin: No additional requirements

Requirements - Windows
----------------------
* MinGW / MSYS environment (http://sourceforge.net/projects/mingw/files/Installer/mingw-get-inst/)
* Qt >= 4.6 (http://releases.qt-project.org/qt4/source/)

* Enttec DMX USB plugin: No additional requirements
* HID plugin: Not available
* MIDI plugin: No additional requirements
* ENTTEC Wing plugin: D2XX driver & development package (http://www.ftdichip.com/Drivers/D2XX.htm)
* OLA plugin: Not available for Windows
* uDMX plugin: No additional requirements
* Peperoni plugin: No additional requirements
* Velleman plugin: K8062 SDK from www.velleman.eu
* OSC plugin: liblo, pkg-config
* ArtNet plugin: No additional requirements

Requirements - Mac OS X
-----------------------
* XCode (http://developer.apple.com/technologies/tools/xcode.html)
* Qt SDK >= 4.8.x (http://qt.nokia.com/downloads/qt-for-open-source-cpp-development-on-mac-os-x)

* Enttec DMX USB plugin: macports, libftdi-dev, pkg-config
* HID plugin: Not available
* MIDI plugin: No additional requirements
* ENTTEC Wing plugin: No additional requirements
* OLA plugin: libola, ola-dev, pkg-config (see libs/olaout/README)
* uDMX plugin: macports, libusb-compat, pkg-config
* Peperoni plugin: macports, libusb-compat, pkg-config
* Velleman plugin: Not available for OSX
* OSC plugin: liblo, pkg-config
* ArtNet plugin: No additional requirements

Compiling & Installation
------------------------

For windows, just install the latest Qt package from Trolltech along with the
default MinGW setup and start the Qt command prompt. For Linux or OSX, in
addition to the Qt libraries, you need also Qt development packages.

As normal user, type to your X terminal:
	qmake
and then:
	make
and then (as administrator/root):
	make install


Support & Bug Reports
---------------------
For Wiki, code and bugs, go to:
https://github.com/mcallegari/qlcplus
For discussions, feedbacks, ideas and new fixtures, go to:
http://sourceforge.net/p/qlcplus/discussion/

Contributors
------------
QLC+:
Jano Svitok (Bugfixes, new features)
Thomas Achtner (ENTTEC wing improvements)
Joep Admiraal (MIDI SysEx init messages)
Stefan Riemens (new features)
Heiko Fanieng (German translation)
NiKoyes (French translation)
Raymond Van Laake (Dutch translation)
Luis García Tornel (Spanish translation)
Jan Lachman (Czech translation)

QLC:
Stefan Krumm <[email protected]> (Bugfixes, new features)
Christian Suehs <[email protected]> (Bugfixes, new features)
Christopher Staite <[email protected]> (Bugfixes)
Klaus Weidenbach <[email protected]> (Bugfixes, German translation)
Simon Newton <[email protected]> (OLA plugin)
Lutz Hillebrand <[email protected]> (uDMX plugin)
Matthew Jaggard <[email protected]> (Velleman plugin)
Ptit Vachon <[email protected]> (French translation)