Recent changes to Compiling and Installing

Compiling and Installing modified by Peter Maersk-Moller

Peter Maersk-Moller — Fri, 31 Jul 2015 23:00:44 -0000

--- v20
+++ v21
@@ -1,4 +1,8 @@
 ###Compiling, Testing, and Running Snowmix###
+
+####This page is a compile and install instruction for older versions of Snowmix. You can find the [newer compile and install instructions on the new Snowmix website](http://snowmix.sourceforge.net/Intro/compileandinstall.html).####
+
+-----

 Updated for version 0.4.5.

Compiling and Installing modified by Peter Maersk-Moller

Peter Maersk-Moller — Thu, 22 Jan 2015 11:00:10 -0000

--- v19
+++ v20
@@ -148,7 +148,7 @@
 **Yosemite, Maverick, Mountain Lion, Lion and Snowleopard**
 The boostrap script will offer to download and install [port for Mac](https://www.macports.org/) as well as a number of libraries mentioned in the Linux Section. It will also offer to download and install GStreamer for Mac for you. If you have a GStreamer version older than 1.4.1, you may want to remove that version before running the bootstrap script.

-When Xcode has been installed and [Snowmix-0.4.4.tar.gz](https://sourceforge.net/projects/snowmix/files/latest/download) has been downloaded to your Download directory, you can execute the following commands to compile Snowmix:
+When Xcode has been installed and [Snowmix-0.4.5.tar.gz](https://sourceforge.net/projects/snowmix/files/latest/download) has been downloaded to your Download directory, you can execute the following commands to compile Snowmix:

     $ cd $HOME
     $ mkdir Developer

Compiling and Installing modified by Peter Maersk-Moller

Peter Maersk-Moller — Thu, 22 Jan 2015 10:59:37 -0000

--- v18
+++ v19
@@ -1,37 +1,42 @@
 ###Compiling, Testing, and Running Snowmix###

-Updated for version 0.4.4.
+Updated for version 0.4.5.

 #####Requirements#####

-Snowmix has been developed and tested on Ubuntu Desktop 12.04 LTS through 14.04 LTS i386/i686/amd64. It has also been tested with Linux Linero 13.10 for ARMv7 on an ODROID-U2. Likewise has it been tested for Mac OS X Mountain Lion and Maverick for amd64. Occasionally Snowmix is also tested on Fedora and Linux Mint amd64.
+##Hardware##
+Snowmix require a laptop or PC or server running Linux with i386/i686/amd64/ARMv7 CPU or Mac OS X with Intel CPU.

-**Linux Ubuntu and Debian (See further down for Fedora and Mac OS X)**

-On Linux Ubuntu Snowmix the bootstrap script will check and install all necessary libraries, tools and programs, but for those who wants the details, Snowmix will require the following packages:
+##Operating System##
+Snowmix has been tested on Ubuntu, Fedora, Debian OpenSUSE, Chakra and Linero Linux. It has also been tested on Mac OS X Lion, Mountain Lion, Mavericks and Yosemite.

-* build-essential
-* automake
-* autoconf
-* libtool
-* g++
-* pkg-config
-* libsdl1.2-dev
-* libpango1.0-dev
-* libpng12-dev
-* tcl-dev

-The bootstrap script will do this for you. The script will check for packages needed and ask for confirmation. The script will try to install missing packages. Doing so and using the command sudo, you will be asked for your password and you need to be in the sudo group in the /etc/group file.
+##Software##
+The table below list the packages needed to be installed for Snowmix to compile, run and test on each platform. Snowmix's boostrap script will detect platform and offer to install missing packages.

-Although the boostrap script will do it for you, you can also choose to install the packages yourself by executing the following command:
+Operating System       | Version | Packages
+---------------------- | ------- | ----------
+Linux Ubuntu | 12.04 LTS - 14.04 LTS | build-essential, automake, autoconf, libtool, g++, pkg-config, libsdl1.2-dev, libpango1.0-dev, libpng12-dev, tcl-dev, tcl, tk, bwidget, gstreamer-tools
+Linux Mint | 17.1 Cinnamon | build-essential, automake, autoconf, libtool, g++, pkg-config, libsdl1.2-dev, libpango1.0-dev, libpng12-dev, tcl-dev, tcl, tk, bwidget, gstreamer-tools
+Linux Debian | 7.7.0 Wheezy | build-essential, automake, autoconf, libtool, g++, pkg-config, libsdl1.2-dev, libpango1.0-dev, libpng12-dev, tcl-dev, tcl, tk, bwidget, gstreamer-tools
+Linux Fedora | Live Workstation 21 | gcc, gcc-c++, autoconf, automake, libtool, SDL-devel, libpng12-devel, pango-devel, tcl, tcl-devel, tk, bwidget, gstreamer, gstreamer-devel, gstreamer-ffmpeg, gstreamer-plugins-bad, gstreamer-plugins-bad-free, gstreamer-plugins-bad-free-extras, gstreamer-plugins-bad-nonfree, gstreamer-plugins-base, gstreamer-plugins-espeak, gstreamer-plugins-fc, gstreamer-plugins-good, gstreamer-plugins-good-extras, gstreamer-plugins-ugly gstreamer-tools
+Linux Chakra | 2014.11 Euler | openbsd-netcat, bc, gst-libav, pkg-config, autoconf, automake, libtool, awk, gcc
+Linux OpenSUSE | 13.2 | autoconf, automake, libtool, gcc, gcc-c++, pkg-config, libSDL-1_2-0, SDL-devel, libpng16, libpng16-devel, libcairo2, cairo-devel, libpango-1_0-0, pango-devel, tcl, tk, tcllib, tcl-devel, bwidget, gstreamer, gstreamer-utils, gstreamer-plugins-base, gstreamer-plugins-good, gstreamer-plugins-bad, gstreamer-plugins-ugly, gstreamer-plugins-qt
+Mac OS X | Lion 10.7 | Xcode, Xcode Command Line Tools, port, autoconf, automake, libtool, pkgconfig, pango, cairo, libsdl, libpng, gstreamer
+Mac OS X | Mountain Lion 10.8 | Xcode, Xcode Command Line Tools, port, autoconf, automake, libtool, pkgconfig, pango, cairo, libsdl, libpng, gstreamer
+Mac OS X | Mavericks 10.9 | Xcode, Xcode Command Line Tools, port, autoconf, automake, libtool, pkgconfig, pango, cairo, libsdl, libpng, gstreamer
+Mac OS X | Yosemite 10.10 | Xcode, Xcode Command Line Tools, port, autoconf, automake, libtool, pkgconfig, pango, cairo, libsdl, libpng, gstreamer
+
+The bootstrap script will use the command *sudo* for installing missing packages and you will be required to provide your password for *sudo* for it to succeed. ALternatively you can manually install any missing packages and safely ignore the install process in the bootstap script, but you still need to run the bootstrap script. Debian users do not by default have access to execute *sudo* commands. To have access to execute the *sudo* command on a Debian system, you need to add your username to the sudo group in the /etc/group file. After adding your username to the sudo group, you need to log out and log in again.
+
+On Ubuntu you can manually install the missing packages using the following command:

         $ sudo apt-get install build-essential automake autoconf libtool g++ pkg-config libsdl1.2-dev libpango1.0-dev libpng12-dev tcl-dev

-Some Ubuntu/Debian distros may require tcl8.5-dev or tcl8.6-dev instead of tcl-dev. The boostrap script require that you have access to execute the *sudo* command. Debian user do not by default have access to execute *sudo* commands. To have access to execute the *sudo* command on a Debian system, you need to add your username to the sudo group in the /etc/group file. After adding your username to the sudo group, you need to log out and log in again.
+Some Ubuntu/Debian alike distros may require tcl8.5-dev or tcl8.6-dev instead of tcl-dev.

-The bootstrap script will check for these packages and offer to install them if they are missing.
-
-Furthermore GStreamer 1.0 \(GStreamer 0.10 is no longer recommended) is needed by the demo example and the scripts to feed audio and/or video streams to Snowmix and to read mixed video from Snowmix. GStreamer version 1.2.1-1.2.2 have a performance issue \(uses 2-4 times as much CPU) when converting video streams from I420/YUV to BGRA lowering the overall performance of a Snowmix video mixer system. GStreamer version 1.2.0-1.2.1 have an issue \(seting value to 127 instead of 255) with the alpha value when converting video streams from I420/YUV to BGRA. Due to these issue, the scripts of Snowmix will require GStreamer 0.10 if GStreamer 1.2.0-1.2.2 is installed. The recommended GStreamer version is GStreamer-1.4.x. The basic GStreamer tools can be installed by executing the following command:
+GStreamer 1.0 \(GStreamer 0.10 is no longer recommended) is needed by the demo example and the scripts to feed audio and/or video streams to Snowmix and to read mixed video from Snowmix. GStreamer version 1.2.1-1.2.2 have a performance issue \(uses 2-4 times as much CPU) when converting video streams from I420/YUV to BGRA lowering the overall performance of a Snowmix video mixer system. GStreamer version 1.2.0-1.2.1 have an issue \(seting value to 127 instead of 255) with the alpha value when converting video streams from I420/YUV to BGRA. Due to these issue, the scripts of Snowmix will require GStreamer 0.10 if GStreamer 1.2.0-1.2.2 is installed. The recommended GStreamer version is GStreamer-1.4.x. The basic GStreamer tools can on Ubuntu be installed by executing the following command:

         $ sudo apt-get install gstreamer-tools

@@ -50,8 +55,8 @@

 Unpack the Snowmix package, enter the main directory and run the bootstrap script. The script may be needed to run more than once if packages are missing. After running the bootstrap script, you can rerun the configure program with your own customized settings. After bootstrap and the optional configure process, you run the make command as shown below:

-    $ tar -xzvf Snowmix-0.4.4.tar.gz
-    $ cd Snowmix-0.4.4
+    $ tar -xzvf Snowmix-0.4.5.tar.gz
+    $ cd Snowmix-0.4.5
     $ ./bootstrap
     $ make

@@ -68,20 +73,18 @@
     $ cd WHERE_EVER_YOUR_SNOWMIX_BASE_DIRECTORY_IS
     $ export SM=`pwd`

-A more permanent solution would be to add the following line to your ~/.profile or ~/.bash_profile
+A more permanent solution would be to add the following line to your ~/.profile or ~/.bash_profile and after changes, you need to logout and login again.

     export SM=WHERE_EVER_YOUR_SNOWMIX_BASE_DIRECTORY_IS.

-Remember to logout and login again for the change to take effect.
+On Mac OS X you should add it to your ~/.bash_profile.

-On Mac OS X you should add it to your ~/.bash_profile
-
-You can now run the demos:
+When SM has been been set, you can now run the demos:

         $ cd $SM
         $ bash scripts/demo

-This demo will open one xterm window for Snowmix, one experimental audio mixer based on Tcl/Tk, one xterm running output of audio and video as well as more xterm windows running test input streams. if all goes well, you will hear audio and see a window with the mixed result depending on which menu point you choose when running the demo.
+This demo will open one xterm-like window for Snowmix, one experimental audio mixer based on Tcl/Tk, one xterm running output of audio and video as well as more xterm windows running test input streams. if all goes well, you will hear audio and see a window with the mixed result depending on which menu point you choose when running the demo.

 If you want to test individual ini files, you can do so using the following commands and replacing the *some_ini_file* with your choice of ini file.

@@ -133,7 +136,7 @@

 #####Compiling Snowmix for Mac OS X#####

-As of Snowmix-0.4.4, Snowmix can now be compiled on Mac OS_X Lion, Mountain Lion and Maverick. It might also work on future Yosemite and older Snow Leopard.
+Snowmix compiles on Mac OS_X Lion, Mountain Lion, Maverick and Yosemite. It might also work on older Snow Leopard, but it has not been tested.

 **Yosemite, Maverick and Mountain Lion**
@@ -142,7 +145,7 @@
 **Lion and Snowleopard**
 To compile Snowmix on OS X on Lion and Snowleopard you first need to install Xcode, which Apple provide through App Store for free. Then you need to download the Command Line Utilities and install this package as the bootscript **can not do this**. You can find the Utilities for Lion on the Apple Developer website, but for Snowleopard you may have to search elsewhere.

-**Yosemite, Maverick, Mountain Lion, Lion and SNowleopard**
+**Yosemite, Maverick, Mountain Lion, Lion and Snowleopard**
 The boostrap script will offer to download and install [port for Mac](https://www.macports.org/) as well as a number of libraries mentioned in the Linux Section. It will also offer to download and install GStreamer for Mac for you. If you have a GStreamer version older than 1.4.1, you may want to remove that version before running the bootstrap script.

 When Xcode has been installed and [Snowmix-0.4.4.tar.gz](https://sourceforge.net/projects/snowmix/files/latest/download) has been downloaded to your Download directory, you can execute the following commands to compile Snowmix:
@@ -150,8 +153,8 @@
     $ cd $HOME
     $ mkdir Developer
     $ cd Developer
-    $ tar -xzvf $HOME/Downloads/Snowmix-0.4.4.tar.gz
-    $ cd Snowmix-0.4.4
+    $ tar -xzvf $HOME/Downloads/Snowmix-0.4.5.tar.gz
+    $ cd Snowmix-0.4.5
     $ export SM=`pwd`
     $ echo "export SM=$SM" >>~/.bash_profile

Compiling and Installing modified by Peter Maersk-Moller

Peter Maersk-Moller — Sun, 18 Jan 2015 20:27:03 -0000

--- v17
+++ v18
@@ -20,6 +20,8 @@
 * libpango1.0-dev
 * libpng12-dev
 * tcl-dev
+
+The bootstrap script will do this for you. The script will check for packages needed and ask for confirmation. The script will try to install missing packages. Doing so and using the command sudo, you will be asked for your password and you need to be in the sudo group in the /etc/group file.

 Although the boostrap script will do it for you, you can also choose to install the packages yourself by executing the following command:

@@ -46,11 +48,11 @@

 #####Compiling Snowmix:#####

-Unpack the Snowmix package, enter the main directory, run the bootstrap script, optionally run the configure with customized settings and then run the make process.
+Unpack the Snowmix package, enter the main directory and run the bootstrap script. The script may be needed to run more than once if packages are missing. After running the bootstrap script, you can rerun the configure program with your own customized settings. After bootstrap and the optional configure process, you run the make command as shown below:

     $ tar -xzvf Snowmix-0.4.4.tar.gz
     $ cd Snowmix-0.4.4
-    $ sh bootstrap
+    $ ./bootstrap
     $ make

 That's it.
@@ -69,6 +71,8 @@
 A more permanent solution would be to add the following line to your ~/.profile or ~/.bash_profile

     export SM=WHERE_EVER_YOUR_SNOWMIX_BASE_DIRECTORY_IS.
+
+Remember to logout and login again for the change to take effect.

 On Mac OS X you should add it to your ~/.bash_profile

@@ -150,12 +154,18 @@
     $ cd Snowmix-0.4.4
     $ export SM=`pwd`
     $ echo "export SM=$SM" >>~/.bash_profile
+
+Now logout and login again for changes to take effect and the run:
+
+    $ cd $SM
     $ ./bootstrap
     $ make
     $ bash scripts/demo

-If GStreamer is not in your PATH environment variable, you may have to execute the following before running the demo scripts and possibly also add it to your ~/.bash_profile for future logins:
+If GStreamer is not in your PATH environment variable, you may have to execute the following before running the demo scripts and possibly also add it to your ~/.bash_profile for future logins.:

     $ export PATH=$PATH:/Library/Frameworks/GStreamer.framework/Commands

+Again logout and login for changes to take effect.
+
 Reports on success and failures on the Mac OS X platform are very welcome in the [Forum](https://sourceforge.net/p/snowmix/discussion/)

Compiling and Installing modified by Peter Maersk-Moller

Peter Maersk-Moller — Sun, 18 Jan 2015 14:20:03 -0000

--- v16
+++ v17
@@ -125,6 +125,8 @@
         $ make
         $ bash scripts/demo

+**PLEASE NOTE**. Fedora Live Workstation 21 appear to be missing a H.264 encoder and decoder for GStreamer. Without it, the current input2feed used in the demo script will not work. If you know how to install H.264 encoder and decoder support for GStreamer on Fedora, please drop a note in the [Discussion Forum](https://sourceforge.net/p/snowmix/discussion/).
+
 #####Compiling Snowmix for Mac OS X#####

 As of Snowmix-0.4.4, Snowmix can now be compiled on Mac OS_X Lion, Mountain Lion and Maverick. It might also work on future Yosemite and older Snow Leopard.

Compiling and Installing modified by Peter Maersk-Moller

Peter Maersk-Moller — Thu, 11 Dec 2014 10:52:20 -0000

--- v15
+++ v16
@@ -6,8 +6,7 @@

 Snowmix has been developed and tested on Ubuntu Desktop 12.04 LTS through 14.04 LTS i386/i686/amd64. It has also been tested with Linux Linero 13.10 for ARMv7 on an ODROID-U2. Likewise has it been tested for Mac OS X Mountain Lion and Maverick for amd64. Occasionally Snowmix is also tested on Fedora and Linux Mint amd64.

-**Linux Ubuntu (See further down for Fedora and Mac OS X)**
-
+**Linux Ubuntu and Debian (See further down for Fedora and Mac OS X)**

 On Linux Ubuntu Snowmix the bootstrap script will check and install all necessary libraries, tools and programs, but for those who wants the details, Snowmix will require the following packages:

@@ -20,24 +19,30 @@
 * libsdl1.2-dev
 * libpango1.0-dev
 * libpng12-dev
+* tcl-dev

 Although the boostrap script will do it for you, you can also choose to install the packages yourself by executing the following command:

-        $ sudo apt-get install build-essential automake autoconf libtool g++ pkg-config libsdl1.2-dev libpango1.0-dev libpng12-dev
+        $ sudo apt-get install build-essential automake autoconf libtool g++ pkg-config libsdl1.2-dev libpango1.0-dev libpng12-dev tcl-dev
+
+Some Ubuntu/Debian distros may require tcl8.5-dev or tcl8.6-dev instead of tcl-dev. The boostrap script require that you have access to execute the *sudo* command. Debian user do not by default have access to execute *sudo* commands. To have access to execute the *sudo* command on a Debian system, you need to add your username to the sudo group in the /etc/group file. After adding your username to the sudo group, you need to log out and log in again.

 The bootstrap script will check for these packages and offer to install them if they are missing.

-Furthermore GStreamer 0.10 or GStreamer 1.0 is needed by the demo example and the scripts to feed audio and/or video streams to Snowmix and to read mixed video from Snowmix. GStreamer version 1.2.1-1.2.2 have a performance issue \(uses 2-4 times as much CPU) when converting video streams from I420/YUV to BGRA lowering the overall performance of a Snowmix video mixer system. GStreamer version 1.2.0-1.2.1 have an issue \(seting value to 127 instead of 255) with the alpha value when converting video streams from I420/YUV to BGRA. Due to these issue, the scripts of Snowmix will require GStreamer 0.10 if GStreamer 1.2.0-1.2.2 is installed. The recommended GStreamer version is GStreamer-1.4.x.
+Furthermore GStreamer 1.0 \(GStreamer 0.10 is no longer recommended) is needed by the demo example and the scripts to feed audio and/or video streams to Snowmix and to read mixed video from Snowmix. GStreamer version 1.2.1-1.2.2 have a performance issue \(uses 2-4 times as much CPU) when converting video streams from I420/YUV to BGRA lowering the overall performance of a Snowmix video mixer system. GStreamer version 1.2.0-1.2.1 have an issue \(seting value to 127 instead of 255) with the alpha value when converting video streams from I420/YUV to BGRA. Due to these issue, the scripts of Snowmix will require GStreamer 0.10 if GStreamer 1.2.0-1.2.2 is installed. The recommended GStreamer version is GStreamer-1.4.x. The basic GStreamer tools can be installed by executing the following command:

-If you want to run snowcub, which is a gui tool for controlling primarily audio and some other settings of Snowmix, you will need Tcl/Tk and BWidgets. To install these either execute
+        $ sudo apt-get install gstreamer-tools
+
+Additional plugins from the good, bad, ugly and libav packages may be required as well.
+
+If you want to run snowcub, which is a gui tool for controlling primarily audio and some other settings of Snowmix, you will need Tcl/Tk and BWidgets. To install these packages  execute one of the following:

     $ sudo apt-get install tcl8.5 tk8.5 bwidget tcl8.5-dev
+    $ sudo apt-get install tcl8.6 tk8.6 bwidget tcl8.6-dev
+    $ sudo apt-get install tcl tk bwidget

-or

-    $ sudo apt-get install tcl8.6 tk8.6 bwidget tcl8.6-dev
-
-The tcl8.5-dev or tcl8.6-dev is required for compilation. Once again, the boostrap script will off to install the required Tcl and Tk tools.
+Once again, the boostrap script will off to install the required Tcl and Tk tools.

 #####Compiling Snowmix:#####

Discussion for Compiling and Installing page

Peter Maersk-Moller — Mon, 15 Sep 2014 19:24:32 -0000

Hi Frederico.

Support uestions are best handled in the Dicussion/Forum

Debian is currently not tested with SNowmix, but if you have the required packages installed, you can run the following commands in the Snowmix directory

export SM=`pwd`
aclocal
autoconf
libtoolize --force
automake --add-missing
./configure

If you are using bash, you can do that by executing the following command:
echo " export SM=$thisdir"
echo "If you are placing the command in the .profile file in your home directory, it will be done automatically when you log in"
echo
fi

Now you can compile Snowmix by cd into src and run make.
After that, you can run Snowmix by executing the command

make
cd src
./snowmix ../ini/YOUR_INI_FILE

or you can run the demo by executing the command

../scripts/demo

For questions and help, please use the discussion forum at http://sourceforge.net/projects/snowmix/
where you in the Wiki also can find a lot of documentation, examples and help

Discussion for Compiling and Installing page

Federico Allegretti — Mon, 15 Sep 2014 17:26:05 -0000

downloaded the package and apt-getted everything ... but "sh bootstrap" fires me an "unsupported OS".
I'm running the script on a debian 7 32 bit.

Discussion for Compiling and Installing page

Peter Maersk-Moller — Wed, 10 Sep 2014 16:24:27 -0000

Hi ladyQonlmv

Snowmix is a tool and not an application. The installation process is described in the page above. If you have followed the instructions on this page, you should have compiled an executable file called snowmix. It resides in WHERE_EVER_YOU_PLACED_IT/Snowmix-0.4.4/src/snowmix.

If you follow the instructions on this page, you can run the demo as explained. Got to the Snowmix directory and run these commands:

$ cd WHERE_EVER_YOU_PLACED_IT/Snowmix-0.4.4
$ ./bootstrap
$ make
$ export SM=`pwd`
$ bash scripts/demo

Note that you need t ohave GStreamer installed to feed video into Snowmix or to get Video out of Snowmix.

If the bootstrap process fails or the make process fails, post me the output of the terminal window, but please do so in the Forum under Discussion found here and please do so in a new thread. You can create a new thread by clicking on the 'Create Topic' button on the page of the Discussion/Forum.

If you can run the demo, then please start reading the documentation in the Wiki.

When you have done so, feel free to describe in Forum what you want to do if you need help to do that.

Best regards
Peter Maersk-Moller

Discussion for Compiling and Installing page

ladyQonImvu — Wed, 10 Sep 2014 15:18:59 -0000

I tried following the instructions .. and all i get is a folder with the files in it .. What else can i do ? is there an installer pagkage available anywhere?