1. Introduction

MP is a free music module player for Linux. It uses the ncurses library for the user interface, and the mikmod library as sound playing engine. MP is able to play 18 module formats (such as xm, s2m and it).

2. Installation

MP consists of a single executable file (mp).

To install MP on your system, just type 'make' and wait for the compilation process to end. Once compiled, you may test MP by typing './mp <module name>'. If it is working, and good enough for you, install MP on your system by typing 'make install'. This will copy the binary file 'mp' to the '/usr/local/bin' directory.

3. Keyboard keys

MP only uses the keyboard to interact with the user. Here are the keys you can use in MP.

In main window

        p............ Play/pause module.
        t............ Stop module.
        i............ Module comment.

        a............ Restart current pattern.
        A............ Restart current module.
        n............ Next position.
        v............ Previous position.
        N............ Next module (playlist).
        V............ Previous module (playlist).

        f............ File selector.
        q............ Quit MP.

        T............ All voices panel.
        c............ All channels panel.
        Y............ Voices position.
        y............ Voices frequency.

        b/B.......... BPM up/down.
        r/R.......... Reverb up/down.
        m/M.......... Tempo up/down.
        s/S.......... Speed up/down.
        +/-.......... Volume up/down.
        !............ Reverse stereo.
        u............ Switch volume display.

        l............ Playlist panel.
        e............ Effects panel.
        o............ Options panel.
        w............ Samples panel.
        W............ Instruments panel.

        UP/DOWN...... Select channel.
        ENTER........ Mute/unmute channel
        M............ Mute/unmute all channels.

        h/H.......... Display help.
        ?............ About.

        *............ Change gauge character.

File selector

        d/D.......... Edit directory name.
        f/F.......... Edit file name.
        TAB.......... Switch between buttons and files.
        ENTER........ Select file or button.

'All channels' panel

        p............ Play/pause module.
        u............ Switch volume display.
        m............ Move panel (UP/DOWN/LEFT/RIGHT).
        q/ESC........ Close panel.

'Voices frequency' panel

        p............ Play/pause module.
        u............ Switch volume display.
        m............ Move panel (UP/DOWN/LEFT/RIGHT).
        q/ESC........ Close panel.

'Voices position' panel

        p............ Play/pause module.
        u............ Switch volume display.
        m............ Move panel (UP/DOWN/LEFT/RIGHT).
        q/ESC........ Close panel.

Options panel

        UP/DOWN...... Select option.
        ENTER........ Toggle option on/off.
        m............ Move panel (UP/DOWN/LEFT/RIGHT).
        q/ESC........ Close panel.

        Mixing frequency:
                UP........... Mix frequency +1
                DOWN......... Mix frequency -1
                PAGE_UP...... Mix frequency +100
                PAGE_DOWN.... Mix frequency -100
                LEFT......... Mix frequency / 2
                RIGHT........ Mix frequency * 2

        Refresh delay:
                UP........... Mix frequency +1
                DOWN......... Mix frequency -1
                PAGE_UP...... Mix frequency +5
                PAGE_DOWN.... Mix frequency -5
                LEFT......... Mix frequency / 2
                RIGHT........ Mix frequency * 2

Effects panel

        UP/DOWN...... Select effect.
        LEFT/RIGHT... Decrease/increase value.
        m............ Move panel (UP/DOWN/LEFT/RIGHT).
        q/ESC........ Close panel.

Playlist panel

        LEFT/RIGHT... Select button.
        ENTER........ Confirm button.
        m............ Move panel (UP/DOWN/LEFT/RIGHT).
        q/ESC........ Leave without doing anything.

4. Bugs

Please, submit bugs (or ideas) to Gael Gence <gael.gence@skynet.be>

Thank you for reading,

Gael Gence (Brussels, Belgium, Jan. 2004)