Installing - StreamMinder User Guide

Installing and Running StreamMinder

Installing the downloaded binary

If you've downloaded the pre-compiled binary, there's nothing to install. You can just run it as-is. Skip ahead to the section on running StreamMinder.

Installing from source

Short instructions for the impatient and those people already experienced in building Qt projects:


			tar -xvzf StreamMinder-X.Y.tar.gz

			cd StreamMinder-X.Y

			qmake streamminder.pro

			make

Long instructions:

If you downloaded the source code for StreamMinder, you will need to unpack the source and build the program before you can run it. Being a Qt project, there are a few tools you will need:

GNU tar (tar in your package manager)
GNU zip (gzip in your package manager)
Qt 4 development libraries (libqt4-dev or similar in your package manager)
GNU make (make in your package manager)

Open a terminal and navigate to the directory where you saved the gzipped tarball containing the source code. Unpack the tarball with the command tar -xvzf StreamMinder-X.Y.tar.gz (replacing X and Y with the version number in your tarball). This will create a new directory called StreamMinder-X.Y which houses the uncompressed source code for the program. cd into the directory and type qmake streamminder.pro to create a makefile appropriate for your system, then type make to compile the program. If all goes well, you'll end up with a few new files, including the streamminder executable.

Running the compiled program

Whichever way you got the binary, you can run it in the same ways you would run any other binary:

In a terminal, cd to the directory where the binary is located and type ./streamminder
Copy or move the binary to a directory in your execution path (e.g., /usr/local/bin) and type streamminder in a terminal
In any decent file manager (e.g., Konqueror, Nautilus, Thunar), navigate to where the binary is and click or double-click on it
Create a shortcut on your desktop that points to the binary and click or double-click the shortcut
Put the binary itself on your desktop and click or double-click it
Create a menu entry in your K-Menu, Gnome Menu, or whatever your desktop uses for launching applications, and point it to the binary