= Installing spettro from source =

if you got spettro from a "git clone" run
    ./autogen.sh
and then
    ./configure
    make
    sudo make install

You'll need to have a c compiler, make, pkg-config and,
to run "autogen.sh", autoconf and automake.

It needs libSDL2 or libefl, the FFTW3 library and at least one of
libsndfile, libsox and libav{format,codec,util}

Optional libraries:
libpng for screen-dumping
libcaca for a bigger font in the axes
libmpg123 for MP3 decoding more resilient to corrupt files
libmagic if you have libsndfile and libmpg123, for more reliable detection
	of MPEG files (without it, libmpg123 opens some files that are not
	MP3 and makes a mess of them

= Release-specific runes =

== ArchLinux ==

    pacman --sync autoconf automake gcc make pkgconf \
	fftw libpng sdl2 libcaca libsndfile ffmpeg
    ah autogen.sh
    ./configure
    make
    sudo make install

== Debian/Ubuntu/Mint ==

    apt-get install -y --no-install-recommends \
	autoconf automake make gcc pkg-config \
	libsdl2-dev libcaca-dev libpng-dev libfftw3-dev \
	libsndfile-dev libmpg123-dev libmagic-dev \
	libavformat-dev libavcodec-dev libavutil-dev
    sh autogen.sh
    ./configure
    make
    sudo make install

On Ubuntu, you must have the "universe" repository enabled for this to work.

== Fedora ==

    yum install SDL2-devel	# or efl-devel
    sh autogen.sh
    ./configure
    make
    sudo make install

== OpenSUSE ==

    zypper install c_compiler make pkg-config fftw3-devel \
	libpng-devel libSDL2-devel libcaca-devel libsndfile-devel \
	ffmpeg-4-libavformat-devel ffmpeg-4-libavcodec-devel \
	ffmpeg-4-libavutil-devel
    sh autogen.sh
    ./configure
    make
    sudo make install

They don't seem to have libmagic-devel, necessary for reliable identification
of MP3 files, so don't install mpg123-devel and let libsndfile handle them.

= ALTERNATIVE CONFIGURATIONS =

To do to graphics and to play the sound, by default it uses SDL 2.0.
Alternatively, it can use the Enlightenment Foundation Libraries,
which make it portable to Windows, Android, iOS and Tizen.

For this, install libEFL
Debian/Ubuntu: libefl-all-dev
	(was e17-dev libecore-dev libemotion-dev before Debian buster 2019-07)
OenSuSe: efl-devel
re-run autogen.sh and
    ./configure --with-efl
    make
Some versions of EFL's sound player don't work (on 64-bit Ubuntu 16.04 or
64-bit Debian of the same age) for which you can use EFL for the graphics
and SDL to play the sound:
    ./configure --with-sdl --with-efl
    make
