IMYplay

Contents:

• Description
• Screenshots
• Download
• Building the software
• System compatibility
• Reporting issues
• My projects on SourceForge
• My other software
• Contact information
• Page information

Description

IMYplay is a program for playing iMelody ringtones (IMY files), conforming to the iMelody specification, as written in doc/imelody.txt.

An example IMY file looks like this:

	BEGIN:IMELODY
	VERSION:1.2
	FORMAT:CLASS1.0
	NAME:Test
	BEAT:120
	STYLE:S1
	VOLUME:V15
	MELODY:c1d2e3f4g5
	END:IMELODY

The most up-to-date documentation can be found in the package itself, a generated copy is available here, in the docs directory.

Documentation is also available on the IMYplay wiki.

IMYplay can use the following outputs to produce sound:

1. the Allegro game library (alleg.sf.net),
2. SDL v1 and v2 (Simple DirectMedia Layer; www.libsdl.org),
3. ALSA (Advanced Linux Sound Architecture; alsa-project.org),
4. OSS (Open Sound System),
5. libao (xiph.org/ao),
6. PortAudiov19 (www.portaudio.com),
7. PulseAudio (www.pulseaudio.org),
8. JACK1/JACK2 (jackaudio.org),
9. GStreamer v0.10 and v1.x (GStreamer.freedesktop.org),
10. PC-speaker (at least Linux and DOS).

It can also:

• convert IMY ringtones to MIDI files,
• write raw samples to an output file,
• call an external program on each note.

Screenshots of IMYplay

Screenshots are available on the SourceForge project page.

Download IMYplay

Current version is 2.0.

Download this at SourceForge.

(free badge provided by Shields.io)

IMYplay release file feed

RPM dependencies:

• libc.so.6(GLIBC_2.34)(64bit)
• liballeg.so.4.4()(64bit)
• libSDL2-2.0.so.0()(64bit)
• libao.so.4(LIBAO4_1.1.0)(64bit)
• libasound.so.2(ALSA_0.9)(64bit)
• libjack.so.0()(64bit)
• libportaudio.so.2()(64bit)
• libm.so.6(GLIBC_2.2.5)(64bit)
• libpulse-simple.so.0(PULSE_0)(64bit)
• libpulse.so.0(PULSE_0)(64bit)
• libglib-2.0.so.0()(64bit)
• libgobject-2.0.so.0()(64bit)
• libgstcontroller-1.0.so.0()(64bit)
• libgstreamer-1.0.so.0()(64bit)

Building the software

The most up-to-date instructions can be found in the package itself, a generated copy is available here, in the docs directory.

Requirements for compiling the full version under Un*x:

• the make program
  
  
• 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 (check twice), then go to
  • alleg.sf.net for the Allegro library
  • www.libsdl.org for the SDL library
  • alsa-project.org for the ALSA library
  • xiph.org/ao for the AO library
  • www.portaudio.com for the PortAudiov19 library
  • www.pulseaudio.org for the PulseAudio library
  • jackaudio.org for the JACK1/JACK2 library
  • GStreamer.freedesktop.org for the GStreamer library
  
  
• MIDI output requires the following functions from the standard C library: malloc(), realloc(), memset(), memcpy(), fopen(), fwrite(), fseek(), fclose() and qsort().

Type ./configure to configure the program for your system. If you do not wish support for a particular output, give the --enable-SYS=no option to ./configure (SYS=allegro, SDL, ALSA, OSS, LIBAO, PORTAUDIO, PULSEAUDIO, JACK, MIDI, EXEC, GSTREAMER, FILE, SPKR). Run ./configure --help for details.

By default, a flex-based scanner will be generated to parse the input file. If the scanner does not compile for you or works incorrectly, 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 will be compiled, if you have the makeinfo program (texinfo package). Translations will be compiled, if you have the gettext package.

Type make install to install the program.
NOTE: make install is NOT recommended. Create and install an rpm package instead, if possible.

Type info imyplay (after installation) or info doc/imyplay.info (before installation) to get help.

Requirements for automatic compiling the DOS version:

• a working GCC compiler (preferably DJGPP).
• development package for the C library (comes with DJGPP)
• if you want sound, not just MIDI conversion, a development package for one of the supported libraries (except PC-speaker, which requires only the C library and system support). If you don't have any of these installed or available (check twice), then go to
  • alleg.sf.net for the Allegro library
  
  
• MIDI output requires the following functions from the standard C library: malloc(), realloc(), memset(), memcpy(), fopen(), fwrite(), fseek(), fclose() and qsort().
• the sed utility (comes with DJGPP)
• the zip utility (comes with DJGPP)
• NASM assembler version >= 2.0 (www.nasm.us)
• the upx utility (upx.sf.net) is optional. The program is compiled correctly without it.
• the tr utility (comes with DJGPP coreutils) is optional. The program is compiled correctly without it.

To compile under DOS using DJGPP, either enable LFN support or find your GCC's limits.h file (NOT the standard one) and change the line

	#include "syslimits.h"

	#include "syslimit.h"

The run make -f Makefile.dos. If you don't have a 'make' utility, you can run the dosdist.bat file.

If you prefer to compile manually (like when you don't have all of the required utilities), then go to the src directory. Change @VERSION@ to the current version number in the imyp_cfg.hin file and rename the file to imyp_cfg.h. Then compile all the files you wish to (the dosfiles.txt file is a good starting point), for example:

	gcc -o imyplay.exe *.c -lalleg

The resulting imyplay.exe is the program to use.

System compatibility

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

• Fedora Core 4 GNU/Linux (i686 CPU)
• Fedora 12 GNU/Linux (i686 CPU)
• Mandriva 2008.1, 2011 (gcc 4.6.1) GNU/Linux (i686 CPU)
• OpenMandriva Lx 3.0, 4.2, 4.3 (gcc 11.2.0) GNU/Linux (amd64 CPU)
• OpenBSD 3.8 (x86 CPU)
• Debian 5.0 GNU/Linux (x86 CPU)
• FreeDOS + DJGPP (gcc 4.1.0) + NASM 2.15.05
• DOSBox + DJGPP (gcc 4.1.0) + NASM 2.15.05
• Ubuntu (amd64 CPU) (Travis): log
• FreeBSD (Travis): log
• macOS X (Travis): log
• MinGW
• Oracle Solaris 11.4 Build 15 (SunOS 5.11) (gcc 7.3.0) (amd64 CPU)

Reporting issues

Any defects or issues can be reported by e-mail or in the SourceForge project defect manager (in English).

Any improvement suggestions can be reported by e-mail or in the SourceForge project ticket manager (in English).

To report build or installation problems, include:

1. the compiler name and version (e.g. gcc version 10),
2. the C standard library name and version (e.g. glibc version 2.x),
3. the output of the configure script. You can capture it by running ./configure > configure-output.txt 2>&1,
4. the generated config.log file,
5. the generated config.h file, if it exists,
6. the output of the make command. You can capture it by running make > make-output.txt 2>&1,
7. any other error messages,
8. any other information that you think could lead to solving the problem.

To report usage problems, include:

1. all the above things you include when reporting building problems,
2. a description of the problem that the software causes,
3. any error messages that are displayed,
4. information whether you tried other input files and whether they are processed correctly,
5. information whether you tried another sound output system, if possible, and whether it worked,
6. (if the problem is with an input file) if possible, the whole input file or a minimalistic input file that causes the problem to show up,
7. any other information that you think could lead to solving the problem.

Help in victory, play a game, send regards, or at least stop using some products

My projects on SourceForge

• WipeFreeSpace - a program for cleaning of free space on filesystems
• LibSecRm - a security wrapper library for C library functions which insecurely delete data
• Trinventum - software that helps manage an e-business
• Meqaris - meeting room and equipment booking system using e-mail invitations
• JYMAG - a program for serial-based (AT-based) mobile phones (like Sagem) and a serial port terminal
• IMYplay - a program for playing iMelody ringtones (IMY files) and an IMY-to-MIDI converter
• LibHideIP - a security wrapper library for C library functions which could lead to revealing your local IP address
• LibNetBlock - a security wrapper library that ensures that no program under its control can access the network
• FMSec - a set of extensions to file managers that enable some security-related operations to be easily performed. The operations include:
  • Secure removal of files using shred,
  • Secure removal of directories,
  • Mounting block devices and regular files using VeraCrypt,
  • Unmounting directories using VeraCrypt,
  • Wiping block devices (without removing them) using shred (the filesystem itself is destroyed too)
  • Wiping free space on filesystems on block devices or inside regular files using WipeFreeSpace,
  • Encrypting and decrypting files using OpenSSL,
  • running programs with LibSecRm preloaded,
  • running programs with LibHideIP preloaded,
  • running programs with LibNetBlock preloaded.
  FMSec consists of projects formerly known as KonqSec/Konq4Sec/Konq5Sec.
• Project Asmosis - a set of tools for assembly language programmers:
  • the Asm::X86 Perl module,
  • AsmDoc - a HTML documentation generator for assembly language,
  • assembly source code converters between NASM, fasm and GNU as,
  • C header to assembly header converters (h2fasm, h2gas, h2nasm),
  • Makefile generator for fasm (make4fasm),
  • Linux 2.6 kernel module helpers for fasm and NASM (symvers-nasm, symvers-fasm),
  • Asm4Doxy - Assembly converter for Doxygen,
  • util-macros.* - some utility macros for fasm and NASM,
  • Autoconf macros that check for existence and command-line options of the various assemblers (ax_prog_nasm.m4, ax_prog_nasm_opt.m4, ax_prog_fasm.m4, ax_prog_fasm_opt.m4, ax_prog_yasm.m4, ax_prog_yasm_opt.m4, ax_prog_tasm.m4, ax_prog_tasm_opt.m4, ax_prog_masm.m4, ax_prog_masm_opt.m4, ax_prog_hla.m4, ax_prog_hla_opt.m4),
  • OS parts - sample pieces of code that may be useful for starting developing a simple operating system.
• KeyParaStocX - is an extension for LibreOffice, Apache OpenOffice and the old OpenOffice.org that searches for keywords in a text, changes their style and builds a Table of Contents for them (formerly: "PozeraczUstaw").
• Fronsetia - a web application that allows testing webservices (formerly: SOAPServiceTester).

The always-up-to-date list of my SourceForge projects is on my profile page on SourceForge.

My other software

• primary site - rudy.mif.pg.gda.pl/~bogdro/soft - down
• first backup site - bogdro.ciki.me/soft - down
• second backup site - bogdro.fulba.com/soft - down
• third backup site (also available over HTTPS)
• fourth backup site (also available over HTTPS)

1. Certificate and key generators
2. E-mail address verifiers
3. LastMod - a script that inserts or updates a META element with the Last-Modified HTTP header
4. Atom2Rss - a script that converts an Atom (RFC 4287) channel XML file to an RSS 2.0 XML file
5. List2Atom - a script that generates an Atom (RFC 4287) channel XML file from a list of files
6. InSyTrack - telemetry software to track program flow (calls) across libraries, threads, programming languages or even different systems on different machines

• primary site with assembly tools - rudy.mif.pg.gda.pl/~bogdro/inne - down
• first backup site with assembly tools - bogdro.ciki.me/inne - down
• second backup site with assembly tools - bogdro.fulba.com/inne - down
• third backup site with assembly tools (also available over HTTPS)
• fourth backup site with assembly tools (also available over HTTPS)

1. Kate/KWrite syntax highlighting for NASM/fasm

Contact information

Contact me: bogdro AT users . sourceforge . net (English accepted, just say '[SOFT]' in the title).

The certificate of the timestamping server which confirms the signature time, can be found on freeTSA.org.

Page information

This page is hosted at SourceForge.net.
This page is written using valid HTML 4.01 , , for all browsers:

This page uses a valid CSS

This page has a content security policy.

This page doesn't use GIF images and doesn't use JPG images.

This page is pure HTML and CSS.

The project icon was created using Inkscape™.

Legal information

Oracle®, Java, and MySQL are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

LINUX® is a registered trademark of Linus Torvalds.

"Fedora" and the Fedora logo are trademarks of Red Hat, Inc.

Debian is a registered trademark of Software in the Public Interest, Inc.

FreeBSD is a registered trademark of The FreeBSD Foundation.

All other trademarks, logos and names on this page and all subpages are properties of their respective owners and are given here only as an example.