The source code can be found on my github repository.
Musicraft is also present in the python package index(pypi). repository. This ought to mean that Musicraft can be installed in existing python3 installation using a command like:
pip3 install musicraft
but in practice, some preparation is usually needed; this is because musicraft requires either 'pyqt' or 'pyside' to operate but this requirement is not expressed in the package's 'setup.py' script.
The installation instructions below are based on on my own experience with a small number of test systems. Feedback to make these instructions - or the 'setup.py' file itself - more reliable are of course welcome.
Installation on Linux
These instructions apply to Debian-based installations (including 'Ubuntu' and 'Mint'). I don't yet have instructions relating to e.g. Red Hat based distributions.
First check which version - if any - of python 3 you have installed by the following command:
... if this is 3.4. or 3.5., then you're good to go. If you have an earlier or later version, this may well also work; if not, instal python 3.5 (you may prefer to do this in a virtual environment).
I find it easiest to use Debian packages for python modules where available. (The pure python method of 'pip3 install ...' is great when it works but can sometimes give compilation problems. In fact, you can install most of the python stuff together with the non-python dependencies by copying the following long one-liner into a 'bash' (terminal) session ...
sudo apt-get install python3 python3-pyside python3-lxml python3-pil python3-pyaudio libportaudio2 timidity-daemon libportmidi0 libportmidi-dev abcm2ps abcmidi
... supplying your password if asked.
Now it's time to install 'musicraft' itself. This can be done using some form of the pip command.On a system supporting python3 (under which musicraft runs) alongside python2, The following command is required:
pip3 install musicraft
If all the above stuff worked without errors, you should now be able to start 'musicraft' as follows:
Installation on Mac OSX
I am embarrassed to admit that I have never used a Mac. Perhaps I will need help in this area. For now, I cannot provide any instrucitons.
Installation on Windows
Some windows users presumably expect to able to download a conventional windows installer for musicraft. I would love to be able to provide one... and maybe one day I will! In the meantime, please try to find the patience to follow the steps below:
Unless you're a regular python programmer, chances are great that 'python3' (essential to musicraft!) isn't even present on your computer. This is easily remedied; start by browsing to this page. This lists a number of installers for python 3.5. (I haven't tested with python 3.6 or later but feel free to do so for me if you feel brave and lucky!). If you're using a 64-bit Windows version, select the 'Windows x86-64 executable installer', otherwise select the 'Windows x86 executable installer' When you run this installer, enable the option to include python in the path; all the other options will be enabled by default anyway.
... to be completed!