View source for InstallSynthAModeler2014

== Mac OS X ==
Requirements: Intel CPU and OS X 10.6 or greater

* First install XCode Developer tools 
https://developer.apple.com/xcode/

and make sure that command line tools are installed. (Alternative to XCode: [https://github.com/kennethreitz/osx-gcc-installer] and choose a package GCC-10.6.pkg, GCC-10.7.pkg, etc.)


When installing Jack, you want to have the 64/32 bit version.

Download and install the [http://www.jackosx.com/ Jack Audio Server for OS X] (after you install this you will need to restart).

http://qt-project.org/downloads
Then get "Qt libraries 4.8.5 for Mac (in the neighborhood of 185 MB)" and install it (takes about 5 minutes excluding download time)

Then inside the Faust directory:
make
sudo make install

Finally, install the Synth-A-Modeler software into the directory ~/SaM

Before you plug in your FireFader, run the command

''ls /dev/cu*''

for a list of the serial devices. Then, after plugging in the FireFader, run

ls /dev/cu*

again. The new path you see is the path to your FireFader. For instance, on my machine it is /dev/cu.usbmodem1d11. Then edit the file ~/SaM/PathToDevice.txt so that it contains only the new path, that is for me it contains only the following:

/dev/cu.usbmodem1d11

Then copy this file to the root directory:

sudo cp PathToDevice.txt /

Then try to compile the guiro model by typing

make jackqt SAMTARGET=guiro



'''Make sure that in the Jack settings, the frames/period is set to 32.'''




(Ran fine on Mac Book Pro Late 2008 Intel Core 2 Duo running OS X 10.8.2 at 32 samples per frame, MacBook Pro Intel Core i7 running OS X 10.7.5 with Qt version 4.7.4 at 32 samples per frame, and iMac running OS X 10.6.8 at 32 samples per frame, Ran fine on dual-core 2.53GHz Intel Core 2 Duo OS X 10.6.8)

== Linux ==

For beginners, 
[[Media:Example.ogg]]

sudo apt-get update

During the following, if you are prompted you should answer ''Yes'' to enable realtime process priority.

sudo apt-get install jackd1 qjackctl

sudo apt-get install libjack-dev 

Then run ''qjackctl &'' and make sure that you have permission to start Jack using realtime permissions. If not, then log out and log in again and try again.

If you still don't have permission, then read the error message in the Jack Message/Status window and follow up, making sure that the appropriate entries are in /etc/security/limits.conf and/or /etc/security/limits.d/audio.conf. You may also need to add your user to the "audio" group:
''sudo addgroup <username> audio''



On netbook, I could get it to run w/o dropouts using 64 frames/period and 8 periods/buffer. The interface was default.

On  Acer laptop, I could only get it to run w/o dropouts using 96 frames/period and 



sudo apt-get install libqt4-dev libqt4-core qt4-qmake 

For Ubuntu precise

sudo addgroup <username> dialout



For advanced users,

Download the [http://sourceforge.net/projects/faudiostream/files/faust-0.9.58.zip/download Faust source for version 0.9.58]



== Troubleshooting ==
Requires minimum Perl version 5.10

The following kinds of errors can for instance happen if you ever upgraded Faust but forgot to remove the older version of Faust: 
error: macro "max" passed 3 arguments, but takes just 2
or other particularly errors involving some standard template libraries, then please make sure you only have one version of Faust installed. You can remove all older versions of Faust by entering into each of their source directories and running
sudo make uninstall
(Then of course you will need to reinstall you favorite version of Faust 0.9.58 by going into its source directory and running ''sudo make install'')