1Installation Instructions
2-------------------------
3
4    1. Install all required dependencies:
5
6      * sqlite >= 3.6.19
7      * taglib >= 1.9.0
8      * expat
9      * cmake 3.3.1
10
11    2. Install optional dependencies:
12
13       * dbus 1.0.x
14       * flac
15       * mad
16       * vorbis (or tremor)
17       * ogg
18       * opus
19       * faad2
20       * pulse
21       * a52
22       * zlib
23       * openssl or gnutls
24
25    3. Run cmake:
26
27       > cmake .
28
29       The following options are available:
30
31          CMAKE_INSTALL_PREFIX => Installation Directory (default: /usr)
32          CMAKE_BUILD_TYPE     => Set the build type. Available types: Release, Debug, RelWithDebInfo and MinSizeRel (default)
33          CMAKE_INSTALL_LIBDIR => Name of directory where libraries are meant to be installed (default: lib)
34
35          WITH_OSS             => Enables building the OSS Output plugin (default: OFF on Linux, ON on UNIX)
36          WITH_ALSA            => Enables building the ALSA Ouput plugin (default: ON on Linux, OFF on UNIX)
37          WITH_PULSE           => Enables building the PulseAudio Output Plugin
38          WITH_WAVOUT          => Enables building the Wav File Output Plugin
39
40          WITH_MATROSKA        => Enables building the Matroska Input Plugin
41          WITH_MP4             => Enables building the MP4 Input Plugin
42
43          WITH_OGG             => Enables building with Ogg Library (required for Vorbis and Opus)
44          WITH_VORBIS          => Enables building with Vorbis Library
45          WITH_TREMOR          => Enables building with Tremor Library (Vorbis Alternative) (default: OFF)
46          WITH_FLAC            => Enables building with FLAC library
47          WITH_MAD             => Enables building with MAD library
48          WITH_ALAC            => Enables building with (buildin) ALAC library
49          WITH_FAAD            => Enables building with FAAD2 library
50          WITH_OPUS            => Enables building with Opus Library
51          WITH_A52             => Enables building with A52 Library (default: OFF)
52
53          WITH_OPENSSL         => Enables building with OpenSSL
54          WITH_GNUTLS          => Enables building with GnuTLS if OpenSSL is not found
55          WITH_GCRYPT          => Enables building with libgcrypt if neither OpenSSL or GnuTLS is included.
56          WITH_ZLIB            => Enables building with zlib
57
58          WITH_OPENGL          => Enables OpenGL based features
59          WITH_DBUS            => Enables DBUS based features
60          WITH_NLS             => Enables Native Language Support
61          WITH_SESSION         => Enabled X Session Support
62
63          Options are enabled by default unless otherwise noted.
64
65       These can be passed on the command line using:
66
67          > cmake -Doption=value .
68
69    4. Compile
70
71       > make
72
73   5. Install
74
75       > sudo make install
76
77   6. Run the software
78
79       > gogglesmm
80
81
82Building Goggles Music Manager on Ubuntu 14.04 LTS
83--------------------------------------------------
84
85    1. Install build tools and header files for FOX
86
87       > sudo apt-get install build-essential
88       > sudo apt-get install libxrandr-dev libxfixes-dev libxft-dev libxrender-dev libxcursor-dev libxi-dev libglu-dev libice-dev libsm-dev
89       > sudo apt-get install libtiff-dev
90       > sudo apt-get install libjpeg-dev
91       > sudo apt-get install libpng-dev
92       > sudo apt-get install libbz2-dev
93       > sudo apt-get install libwebp-dev
94       > sudo apt-get install libopenjpeg-dev
95
96    2. Install build dependencies for gogglesmm
97
98       > sudo apt-get install libasound2-dev
99       > sudo apt-get install libpulse-dev
100       > sudo apt-get install libogg-dev
101       > sudo apt-get install libvorbis-dev
102       > sudo apt-get install libopus-dev
103       > sudo apt-get install libflac-dev
104       > sudo apt-get install libmad0-dev
105       > sudo apt-get install libfaad-dev
106       > sudo apt-get install libsqlite3-dev
107       > sudo apt-get install libtag1-dev
108       > sudo apt-get install libglew-dev
109       > sudo apt-get install libgcrypt11-dev
110
111    4. Download, Build and Install gogglesmm (adjust version if necessary)
112
113       > wget https://github.com/gogglesmm/gogglesmm/archive/1.0.12.tar.gz
114       > tar xvf gogglesmm-1.0.12.tar.gz
115       > cd gogglesmm-1.0.12
116
117       for 32 bit:
118       > ./configure --with-faad --without-oss --libdir=/usr/lib/i386-linux-gnu
119
120       for 64 bit:
121       > ./configure --with-faad --without-oss --libdir=/usr/lib/x86_64-linux-gnu
122
123       > make
124       > sudo make install
125
126    5. Run
127
128       > gogglesmm
129