2.1 Compile under Un*x

IMYplay, in various versions, has been successfully compiled on the following systems:

• Fedora Core 4 GNU/Linux, i686
• Fedora 12 GNU/Linux, i686
• Mandriva 2008.1, 2011 GNU/Linux, i686
• OpenMandriva 3.0, 4.2, 4.3 GNU/Linux, amd64
• OpenBSD 3.8, i586
• Debian 5.0 GNU/Linux, i686
• Ubuntu GNU/Linux
• FreeBSD
• Solaris/SunOS
• macOS

Requirements for compiling the full version of the program under Un*x:

• a working C compiler
• development package for the C library (like glibc-devel and glibc-headers). The getopt.h header and the ‘getopt_long’ from it are not required, but useful. The signal.h header is used to catch signals, and is optional. The translation headers (locale.h, libintl.h or other) are optional.
• if you want sound, not just MIDI conversion, a development package for one of the supported libraries (except OSS and PC-speaker, which require only the C library and system support). If you don’t have any of these installed or available, then go to
  http://alleg.sf.net/
  http://www.libsdl.org/
  http://alsa-project.org/
  http://xiph.org/ao/
  http://www.portaudio.com/
  http://www.pulseaudio.org/
  http://jackaudio.org/
  http://gstreamer.freedesktop.org/
  
• MIDI output requires the following functions from the standard C library: ‘malloc’, ‘realloc’, ‘memset’, ‘memcpy’, ‘fopen’, ‘fwrite’, ‘fseek’, ‘fclose’ and ‘qsort’.
• WAV output requires the ao library (http://xiph.org/ao/).

Type

‘./configure’

to configure the program for your system.

If you do not with support for a particular output mechanism, give the --enable-NAME=no option to ‘./configure’ (NAME=allegro, SDL, SDL2, ALSA, OSS, LIBAO, PORTAUDIO, PULSEAUDIO, JACK, MIDI, EXEC, GSTREAMER, FILE, SPKR, WAV).

Run ‘./configure --help’ for details.

By default, a flex-based scanner will be generated to parse the input file, if flex is available. If the scanner does not compile for you or works incorrectly (it hangs on binary files, for example), disable it with

‘./configure --enable-FLEXPARSER=no’

and recompile IMYplay.

If you do NOT wish IMYplay to use the network or get the computer’s IP address, get LibHideIP>=0.2 and LibNetBlock and configure IMYplay with

‘./configure --enable-LIBHIDEIP --enable-LIBNETBLOCK’

NOTE: this may cause network sound output to fail.

Type

‘make’

to compile the program.

Documentation is compiled, but may be recompiled, if you have the makeinfo program (texinfo package). Translations will be compiled, if you have the gettext package.

NOTE: if you have trouble compiling, see Reporting issues.

Type

‘make install’

to install the program.

NOTE: ‘make install’ is NOT recommended. Create and install an RPM package instead, if possible.

To create an RPM package:

1. copy the imyplay.spc file to $HOME/rpmbuild/SPECS
2. copy the source package imyplay-2.1.tar.gz to $HOME/rpmbuild/SOURCES
3. type ‘rpmbuild -bb $HOME/rpmbuild/SPECS/imyplay.spc’
4. get the RPMs from $HOME/rpmbuild/RPMS/your_cpu_arch

To create an RPM package (the old way):

1. copy the imyplay.spc file to /usr/src/redhat/SPECS
2. copy the source package imyplay-2.1.tar.gz to /usr/src/redhat/SOURCES
3. type ‘rpmbuild -bb /usr/src/redhat/SPECS/imyplay.spc’
4. get the RPMs from /usr/src/redhat/RPMS/your_cpu_arch

NOTE: some systems may use other directories than these.