﻿
MoreAmp 0.1.29 README
___________________________________________________________________________

NOTE:  The latest version of MoreAmp is always at

	http://sourceforge.net/projects/moreamp/

Downloads from other sites may be older versions.

___________________________________________________________________________

Contents :

- Audio Media Player
- MoreAmp has unusual features
- Installation
- Usage
- Audio support
- Live audio input
- Keyboard shortcuts, Key bindings
- No gui - No Graphic User Interface
- Unicode UTF-8 encoded files
- Currently implemented functionality by platform and audio file type
- Known bugs
- MoreAmp is released under the GNU GENERAL PUBLIC LICENSE (GPL)

__________________________________________________________________________

Audio Media Player :

Plays aac, aif, fla, flac, m2a, m4a, mp1, mp2, mp3, mp4 sound, ogg, wav,
wmaand raw files, Audio CD's and the system audio input.

Creates aac, aif, flac, mp3, mp4, ogg, wav, raw files.

Builds and runs on Mac OSX, win32, Unix/X11/GTK. 
___________________________________________________________________________

MoreAmp has unusual features, it can :

- Load memory, or a virtual disk, full of songs and keep playing after the
  system's power-saving features spindown the hard disk(s).
  
- Play songs between settable start and stop points, and loop between them.
  For example, play just three seconds of every song in a list. Or loop on
  a section of a song.
 
- Apply more than the usual sound control: 31-band equalizer, stereo
  balance, stereo separation (nice to reduce for headphones), reverse
  stereo, left/right/pan mono, channel (speaker) phase inversion, a fun
  'Left minus Right' mono pan mode that removes sound in the 'center'
  channel, for example to take out a singer, pitch, tempo, and speed.

- Generate new songfiles with the sound controls applied, for example new
  mp3 files for a portable mp3 player that lacks a graphic equalizer.

- and more.

Note : aac, mp3 and mp4 encoding is not built into the binary releases, but
       can be built in from the source release.

MoreAmp is always under development. See
'Currently implemented functionality by platform and audio file type'
below.
___________________________________________________________________________

Installation

For OSX, mount the dmg image of the 'MoreAmp' binary release archive and
copy the MoreAmp folder to your home folder.

For win, unzip the binary release archive anywhere on your system.

This creates a 'MoreAmp' folder containing the MoreAmp executable, the two
'COPYING' license files and this 'README' file.

To uninstall, delete the 'MoreAmp' folder.

For linux/unix, read 'INSTALLunix.txt' in the src release.

For playing audio cd's on win32 platforms :
You may need to 'install an aspi layer'. Do this with 'aspi_471a2.exe'
available at :

     http://download.adaptec.com/software_pc/aspi/aspi_471a2.exe

If the link has changed, try Googling for "aspi_471a2.exe".


Quick test : drag and drop a songfile icon on the MoreAmp executable icon.

___________________________________________________________________________

Usage

Playlists

  MoreAmp plays from playlists, UTF-8 encoded text files containing full
  paths to audio files and/or cd tracks, and/or from standard m3u files.

  There are several ways to make playlists :

  - Use the 'Make Playlist' menu item under the MoreAmp 'Files' menu, which
    first prompts you to select a folder (that contains songfiles and/or
    playlists and/or links ('aliases' or 'shortcuts') to songfiles and/or
    cd's), then prompts you for a name for the new playlist. Playlists can
    be any valid file name with a .maf extension, except 'madrop.maf' and
    'macda.maf'. These two reserved names are for the playlists created
    when files are dragged-and-dropped or when a cd is played.

  or

  - Drag and drop song icons onto the MoreAmp icon or onto a MoreAmp
    window. The song icons can be songfiles and/or folders and/or links
    and/or cd's and/or m3u files. This creates a new 'madrop' list and
    if the 'Auto Start' menu setting is on then the player starts in 'play'
    mode. If the 'Add mode' checkbox is set then instead of creating a new
    'madrop' list the new songfiles are added to it. You can then save the
    list with the 'Save Playlist As' menu item to a playlist name other
    than 'madrop'. Selecting files with the 'Play Song Files' menu can be
    used instead of drag-and-dropping files.

  or 

  - On unix and win, MoreAmp accepts command line arguments that are
    song files, dirs, links cd's or m3u files and creates a new 'madrop'
    list as in drag-and-drop (above). If the first argument is a MoreAmp
    playlist then that playlist is played and any following arguments
    are ignored.

  or

  - Make a playlist with some other program like a database, or export one
    from another player. 
    A MoreAmp playlist is just a UTF-8 encoded text file of full paths to
    songfiles, one song per line. Note that a songfile name must end with a
    correct audio file type extension, i.e 'x.mp3' will play but 'x.mp3
    copy' will not. 
    Lines beginning with '#' are ignored.
    Append '.maf' to the playlist and place it in the 'maplaylists' folder.
  - MoreAmp also plays from standard UTF-8 encoded m3u files. Note that
    m3u files must stay in the dir where they were created, usually in the
    dir with their songfiles.

  Playlists are kept in the 'maplaylists' folder. MoreAmp starts up with
  the playlist that was last selected. Select another playlist to play with
  the 'Open Playlist' or 'Open Recent' item under the MoreAmp 'Files'
  menu, or drop a playlist icon on the MoreAmp executable icon or onto a
  MoreAmp window.

  See also "Unicode UTF-8 encoded files" below.

Settings

  MoreAmp 'settings' are the options selected with checkboxes, menu items
  and droplists, the equalizer values, and the window sizes and positions.

  Each playlist gets its own settings.

  Settings for new playlists are copied from default settings. Default
  settings can be changed with the 'Save Settings As Default' menu item.
  Each instance of MoreAmp has its own default settings.

  Factory settings are used when no settings files are available. You can
  also select them with the 'Factory Settings' menu item.

  You can copy the settings from another playlist with the 'Copy Settings'
  menu item.

  Setting are not automatically saved when quitting MoreAmp. Expressly save
  new settings with the 'Save Settings' menu item.

  Settings are saved in binary (non-editable) files in the 'masettings'
  folder. These files are named like their associated playlist, with '.mas'
  appended. If a settings file for a playlist is missing or corrupted,
  MoreAmp recreates one using the default settings or, failing that, the
  factory settings.

  The 'Advanced Settings' menu item opens a window for additional settings.
  See 'Advanced Settings window' below.

 Controls

  MoreAmp is controlled by pushbuttons or menus or from the keyboard. Most
  controls function as expected. Some are disabled while playing. Some menu
  items duplicate pushbuttons. Feel safe to click away to see and hear what
  happens. Use headphones to hear subtle adjustments.

  Some controls, menus and settings need some explanation :

  Main window :

  - Alt Size (menu)
    Toggles between two sets of window position and size settings. There is
    also a checkbox just under the Quit button with the same function.

    Notes:
    - Holding down the Shift key (or the Alt key on some platforms) while
      toggling sizes keeps the current window positions, i.e. only the
      sizes change, and the previous alternate window positions are lost.
    - Holding down the Shift key (or the Alt key on some platforms) while
      moving the main window prevents moving the other windows along with
      it, i.e. only the main window moves.

  - Title Info 
    If not set, or if settings menu 'Title Info->List Name' is selected,
    the main window title is 'MoreAmp' and the name of the playlist in use.

    If set once, or if settings menu 'Title Info->Song Name' is selected,
    you get the name of the songfile currently playing.

    If set a second time, or if settings menu 'Title Info->Numbers' is
    selected, you get the name of the playlist plus some sets of numbers:
    the index of the song currently playing, and in parentheses, the number
    of songs in the playlist that have played/the total number of songs in
    the playlist, the number of loaded songs that have played/the total
    number of songs loaded, and the playing song's remaining play time.
    If ReptPlayed is set you don't get the number of songs in the playlist
    that have already played.
    In Direct mode you don't get a number for songs loaded.

  - Random 
    Play or load songs from the playlist at random ('shuffle' mode).

  - Repeat Played 
    When going through a playlist for songs to play, MoreAmp normally
    skips songs that have already played until all songs have played.
    If this setting is on MoreAmp repeats a song that has already played.

  - Loop Loaded 
    In 'Mem' song mem mode MoreAmp normally loads songs from the playlist,
    plays them, then loads some more, plays them, etc. If this setting is
    on, it will not load more songs, just loop on the same loaded songs
    over and over; in 'Direct' song mem mode, it will loop on one song. 

  - Loop List 
    When all songs in the playlist have played MoreAmp will stop playing.
    If this setting is on MoreAmp will start over. See also 'Zero List'
    below.

  - Invert Right 
    Inverts the Right channel output polarity (same as inverting the wires
    of one speaker). Occasionally useful for fixing a badly encoded file,
    or if your speakers are out of phase. Also, if in normal Output Stereo
    mode, sliding the Sep slider down towards mono will gradually remove
    the 'center channel', as in 'L - R' mono mode (see 'L, R, rev
    checkboxes' and 'Sep (Separation)' below). 

  - Single Play 
    This will cause MoreAmp to stop at the end of a song, instead of
    starting the next song. 
    Useful when you want to output a single song to a file from a list.

  - Auto Start 
    This will cause MoreAmp to begin play when the program is started,
    instead of waiting for you to press the Play button. Useful if you use
    your computer as an alarm clock or if you want it to play immediately
    when you drop a file on it.
    Holding down the Shift key (or the Alt key on some platforms) when the
    program is started disables Auto Start.

  - Zero List (Tools menu) 
    Resets to zero a playlist's memory of songs that have played (see
    'Repeat Played' and 'Loop List' above).

   - Make Catalog (Tools menu) 
    Makes in the moreamp dir a text file named 'playlist.txt' that lists
    for each song in a playlist whether or not that song has played ("+1"
    or "+0" after the song name), and the song info displayed in the List
    window when clicking 'Song' : file name, size, duration, tags, etc.
    depending on the file format.
    The last line of the catalog file is the name and size of the largest
    songfile in the playlist.
    Use the 'Edit Catalog' Tools menu or any text viewer to view this file.
    You can search for and play songs from the catalog viewer instead of
    from the Playlist. 
    Use the 'Stop' button to interrupt cataloguing.
 
  - 'Edit Catalog' (Tools menu)
    Displays the file created with 'Make Catalog'. If a catalog for the
    current playlist doesn't exist, or is out of date, you will get a
    prompt to make a new one.
    To search for a song, enter text in the search entry field at the
    bottom of the window and press Enter (or select text from the catalog
    by left-mouse click-and-drag or double-click, which will copy it to the
    search entry field). This will show the number of matches next to the
    'Find' button and the index number of the matching song next to the
    'Play' button. Press Enter again to find the next match (or right-click
    in the catalog).
    You can also scroll up or down the catalog then left-click near a song
    and its index will appear next to the Play button. 
    To play the song, press the catalog window's 'Play' button, or, if
    the search entry field has focus, you can press the ESC key and then
    the key for the PlayCatalog shortcut ('-' by default).

  - 'Repeat' 'Begin' 'End' 
    Songs play from the 'Begin' value to the 'End' value, and loop between
    these two if the 'Repeat' checkbox is set (these settings are not
    saved). Use the position slider for rough settings and the up/down
    arrows for fine settings. The position slider is more accurate if 
    you widen the window. Currently not effective with WMA or AAC files.
    Set these checkboxes on from left to right (Repeat first), and off from
    right to left (Repeat last) to avoid starting the next song when 'End'
    is pressed.
     
  - Play
    Starts the player.
    - In Direct mode songs are played directly from the playlist in an
      order depending on the Random and ReptPlayed settings.
    - In VDisk or Mem modes, songs are loaded (onto VDisk or into memory)
      and a temporary 'Loaded' list of those songs is generated. Which
      songs are loaded depends on the Random, ReptPlayed and Song Mem
      settings. Songs are then played from the Loaded list in sequential
      order.

  - Next
    - Jumps to the next song in the playing order, which depends on the
      Song Mem, Random, ReptPlayed, LoopLoaded and LoopList settings.
    - If no songs have played yet, Next works like the Play button.

  - Previous
    - Jumps to the previous song in the playing order, or to the beginning
      of the current song, depending on the Song Mem, Random, ReptPlayed,
      LoopLoaded and LoopList settings.
    - If no songs have played yet, Previous works like the Play button.
 
    Note:
    'Standard' mode
      MoreAmp works like a 'standard' player when set to Direct mode with
      ReptPlayed on and Random off.
      In 'standard' mode it doesn't load songs, it just plays them
      sequentially from the playlist, and Next and Previous work as
      expected.
      The TitleInfo Numbers display shows the Index (with a '#' before it)
      instead of the number of songs played.
      At the last song in the playlist Next jumps to the first song in the
      playlist (recirculates); at the first song in the playlist Previous
      jumps to the last.

  - Volume
    The left and right volume sliders are normally linked together and you
    can slide either one to change the volume for both channels (see
    'Balance' below).
    The value under each slider shows the attenuation, from 0 dB at top
    (max volume) to -infinity at bottom (zero volume).

    - Mouse wheel volume control
      If the 'Use MouseWheel' menu item is set you can also change the
      volume with the mouse wheel. The focus needs to be in the main,
      equalizer, effects or list window (except in the list itself, where
      the mouse scrolls the list)

    - Keyboard volume control
      If the 'Use Keyboard' menu item is set you can also change the
      volume from the keyboard ("." period and "," comma by default).
      The keyboard focus needs to be in the main, list, effects or
      equalizer window (except in the eq preset name edit box).
      The new volume setting is momentarily displayed in the main window
      title in percent (of the linear scale of the sliders).
    
  - Balance 
    Set this to be able to move the volume sliders individually to change
    the left/right balance. Use the mouse wheel or the volume keyboard
    shortcut to move both sliders simultaneously without altering the
    balance.

 - Preamp, Limit 
    The Preamp slider changes the mp3 preamp level. If set too high you get
    clipping distortion, but if Limit is set, the mp3 level is
    automatically reduced enough to prevent clipping. The amount reduced is
    displayed next to the checkbox. 
    You can keep your mp3 songs all playing at about the same max level by
    setting the Preamp slider high enough, say 4.5, and setting Limit on.

  - L, R, rev checkboxes, Mono, Stereo, Pan 
    Normal value for these three checkboxes is off and 'Output Stereo' is
    displayed above them.
 
    - If you set 'rev', left and right channels will be reversed.
 
    - If you set 'L', then only the left channel will play (through both
      speakers), the label above changes to 'Output Mono', and the 'rev'
      checkbox disappears. Same for 'R' if 'L' is not set.
 
    - If 'L' and 'R' are both set then you get both channels in mono and
      'L+R' or 'L-R' in place of 'rev', and the 'Separation' slider becomes
      a 'Pan' slider with the Right channel at the top and the Left channel
      at the bottom. Then : 
      - if you set '+' you get normal 'L + R' mono, which you can pan left
        to right; 
      - if you set '-' you get 'L - R' mono, removing sound that both
        channels have in common, that is, removing sound that was in the
        middle in stereo mode, creating a silent hole in the middle; the
        'Pan' slider moves the hole from Left to Right. Also see 'Invert
        Right' above.

      Note:  
      On mp3 files, the mono 'L - R' mode works a little better on files
      that have been encoded in Normal Stereo mode rather than in Joint
      Stereo mode.

  - Sep (Separation) 
    Available in stereo mode to reduce left/right separation. A value of 0
    is equivalent to mono. 
    Also see 'Invert Right' above.

  - Song Mem 
    Selects where songs will be loaded (copied to) for playing :
 
    - Mem 
      System memory, using the amount set with the up/down arrows. This
      should be at least as large as the largest songfile in the playlist
      (excluding cd files), else you will get a prompt to increase mem or
      set the Direct mode when that file is selected for play. The largest
      songfile in a playlist is listed at the end of the playlist's catalog
      file (see 'Make Catalog').

    - VDisk
      Virtual Disk, or 'ram disk', using the amount set with the up/down
      arrows. You select an existing virtual disk from the 'Settings' menu,
      but be careful because you can select any disk, even a hard disk, as
      a 'virtual disk'. The selector pop up prompts for a directory, so a
      directory must exist on the virtual disk. There are various utilities
      for most platforms for creating virtual disks.

    - Direct 
      No song memory is used, songs are played directly from their source
      disk.

      Notes: 
      - Audio cd tracks are not normally loaded even when in Mem or
        Vdisk mode, instead they are played from the cd as in Direct mode.
        On OSX, however, you can open an audio cd like a folder and access
        aiff files, e.g "1 Audio Track.aiff", and drop them onto MoreAmp
        which then plays like them any songfile, i.e. it will load them if
        in Mem or Vdisk mode.         
      - You may want to select Mem or VDisk instead of Direct even when not
        expecting the hard disk to spindown, for example when repeating
        part of a song ('Repeat' is set) or to loop on several songs 
        ('LoopLoaded' is set). 
      - On OSX and Unix, if you ask for too much system memory, you get
        virtual memory instead of physical memory, so the hard disk may
        never spin down.

  - Output 
    Select the output, either the system's sound output or a file type for
    new files. New files take on the song name with the type's extension
    appended and are placed in the folder selected in the 'MoreAmp File
    Output Parameters' windows (which pop up whenever an output other
    than Sound is selected). New songfiles are created with all the
    controls applied to the song (except volume) : equalizer, preamp/
    limit, separation, L R rev/+/-, invertRight, effects.

    Notes: 
      - A new file type's extension is simply appended to the source
        filename, so you get a new file name like "Summertime.aif.mp3" for
        an mp3 file made from an aif file.
      - .wav files are created in Microsoft PCM format. 
      - The playlist is processed the same whether playing sound or
        creating new files. To create a single new file, make sure
        SinglePlay is set and double-click on its entry in the playlist
        and MoreAmp will stop when it has created that one file; to create
        a batch of new files from a playlist first zero the list (Tools
        menu) and turn off LoopList and SinglePlay, then press the Play
        button.

  - Open Playlist, Open Recent (File menu)
    Holding down the Shift key (or the Alt key on some platforms) while
    opening a playlist from this menu keeps the current settings instead
    of loading that playlist's settings.     

  - Save settings 
    Settings are not automatically saved on exit. Use this to keep any
    changes made to a playlist's settings. Also see 'Lists' under
   ' Lists window' below.

  - Set Audio CD Drives (unix only)
    Use this to tell MoreAmp what audio CDRom drives to use. Try the
    'cd paranoia' feature if you have problems reading a scratched or
    otherwise damaged audio disk. These settings are saved independently
    of the playlist settings.

  - README (Help menu)
    This Help menu item pops up a text viewer that displays this README
    file and can search for text you put in the search window. Text that
    you highlight with a double-click or by dragging the cursor is copied
    to the search window (on Win and Mac highlight then right-click). Use
    the 'Edit' function or a text editor to change README's contents to
    suit you.

  Equalizer window :

  - Eq31Bands 
    Set this to use 31-band equalization, where the bands are one-third
    octave wide, instead of 10-band equalization, where the bands are one
    whole octave wide.
    Also see 'Link' below. 

  - EqExtra 
    Set this to enable an extra (second) pass through the filter, on
    either 31-band or 10-band equalization.
    Note that this doubles the processor usage for equalizing. 

    Notes : 
    Equalization takes much processor time. Setting Eq31Bands and EqExtra
    off is the single most effective way to reduce skips on a slow busy
    system, next to setting the equalizer off entirely.

  - Zoom/Offset 
    If the Zoom checkbox is set, expand (+) or contract (-) the equalizer
    values about the 0 dB axis. 
    If the Zoom checkbox is not set, raise (+) or lower (-) all equalizer
    values.

  - Offset dB 
    Adds the dB value set with the up/down arrow to all equalizer values,
    effectively changing the value of the zoom axis, allowing correction
    for some of the loss introduced by the equalizer. The sum of the offset
    and the highest equalizer value should not exceed 12, to avoid possible
    clipping distortion.

  - Preset Name 
    Edit the preset names, for example to change 'Preset 16' to 'Cheap
    Speakers'. Note that equalizer settings are part of the settings saved
    with each playlist, i.e. Preset 16 could  be a set of values named
    'Cheap Speakers' in one playlist and a different set of values named
    'Deaf Listener' in another playlist.
    When finished editing the preset names, click outside the edit box to
    re-enable keyboard shortcuts in the eq window. 

  - Separate L/R
    Set this checkbox to use separate settings for the left and right
    channel. A second equalizer window pops up for adjusting the right
    channel. You can copy and paste between the two windows.

  - Mid 
    Sets all equalizer sliders to 0 dB.

  - Copy/Paste 
    Use this to copy settings from one equalizer preset to another.

  - Reset 
    Reverts to the last saved settings for the current equalizer preset.

  - ShiftLeft/ShiftRight 
    Shift the equalizer settings one slider to the left or right. Values
    shifted off either end are lost until recovered with the Reset button.

  - Invert 
    Inverts the equalizer settings about the 0 dB axis (boost becomes cut,
    and vice-versa).

  - Link 
    If this checkbox is set and a slider with a blue dot is moved, then the
    two sliders on either side will be linked to it and move as well. This
    means that you can set a fairly smooth 31-point curve by moving only
    ten sliders. Note that 31 sliders are displayed even when the Eq31Bands
    setting is off; in this case only the ten sliders with a blue dot are
    active.

  Lists window :

   - Info 
    Displays some info about the current playlist, the size of the memory
    bufer used, and any audio cd's that MoreAmp found.

  - List 
    Displays the current playlist. Double-clicking on an entry will play
    that song (creates a new 'loaded' list with a single entry). You can
    also move through the list with the keyboard up and down arrow keys
    and hit return to play a song. 
    The 'Previous' and 'Next' buttons work on this list when in Direct
    mode.
    A very large playlist may be slow to display. Avoid saving settings
    with the Lists window enabled and a large playlist displayed, so that
    the next time the MoreAmp app is started it won't be slowed down by
    displaying a large playlist.
    Keeping the 'Show index', 'Show dir' and 'Show path' settings off may
    speed up displaying a large playlist.

  - Load (meaning 'Loaded') 
    Displays the songs loaded. Double-clicking on an entry will play that
    song without reloading, whereas double-clicking in the 'List' playlist
    or pressing the 'Start' button loads new songs. You can also move
    through this list with the keyboard up and down arrow keys and hit
    return to play a song.
    The 'Previous' and 'Next' buttons work on this list when not in Direct
    mode.

  - Song 
    Shows info and tags (e.g. id3 tags) about the song currently playing.
    You can show info about another song (not currently playing) in either
    the playlist or loaded list by selecting the song (single-click) in the
    list and then pressing this button. A second press reverts the info to
    the song currently playing. The info shown here can be collected for
    all files in a playlist into a text file with the 'Make Catalog' button
    decribed above.

  - A horizontal scrollbar appears if either the list or the window are
    resized so that the list is wider than the window. To resize the
    list, drag the right edge of the header at the top of the list. You
    may need to widen the window or scroll right to see the right edge.

  File Output windows :
    These windows pop up whenever an output other than Sound is selected,
    and allow you to change the file output destination folder and some
    encoding parameters. These settings are saved individually with each
    playlist, so you might have for example mp3 songs from one playlist
    going into a folder called 'mp3hifi' at 192 kbps, and mp3 songs from
    another playlist going into a folder called 'mp3nofi' at 80 kbps.

  Effects windows :
    This window pops up when the Effects checkbox or menu item is set, and
    allows you to select and vary the pitch, tempo and speed.
    The Effects checkbox in the main window, duplicated in the Effects
    window, turns all effects on or off.
    These effects take processor time and degrade output quality somewhat.
    Effects settings are saved individually with each playlist.
    On wx builds, double clicking on an effect slider resets it to its
    saved value.
    
    - High quality (sbsms)
      This setting causes sbsms to be used instead of SoundTouch, but with
      these major differences:
      - The whole song is decoded before it is played, which takes more or
        less time depending on the song encoding (mp3, flac, etc.) The
        position slider shows the progress of this decoding process before
        the song actually plays.
      - The effect is applied over the whole song and any parameter change
        or toggling Effects or High quality on or off do not take effect
        while the song is playing.
      - Seeking with the position slider and Begin to End looping are not
        possible (Begin and End are disabled). Repeat is possible.
      - Audio Input or playing a CD are not possible.
      - sbsms requires so much CPU power that on slower systems the Sound
        output may not keep up with real time.
      
  Advanced Settings window (opened from the Settings menu)
  - Close and re-open sound channel between songs
    Leaving this setting off can result in less delay between songs on
    systems where the sound output unit is slow to open, such as the OSX
    Aggregate Device.
    Setting it on ensures that the sound output channel is closed, re- 
    initialized and re-opened for every song.
    The sound output channel is always re-opened if the sample rate of a
    song differs from the previous', e.g. 44100 to 22050, regardless of
    this setting.   

  - Input Monitor
    Plays the Audio Input Device through the Audio Output Device even when
    the output is set to a file instead of to Sound.      
  
  - Error-log non-playable files when creating a playlist
    Set this if you want to see in the error log what files MoreAmp is
    rejecting when you create playlists (.jpg files, .txt files, etc).
    The Error Logging off setting (see below) overrides this one.

  - Use m3u
    If this is set then when scanning a dir for files to play, MoreAmp will
    first look for m3u files in that dir and if it finds any it will add
    their songs to the playlist it is creating, and will ignore other
    files or subdirs in that dir.
    If this is not set then MoreAmp will ignore any m3u files in that dir
    and scan for songs like it normally does.

  - Exit after the playlist has played
    This can be useful when using MoreAmp as a player backend, calling it
    from scripts.
    When this setting and Auto Start are on, and Looplist and LoopLoaded
    are off, when you start MoreAmp the playlist gets zeroed, all songs
    in the playlist play, then MoreAmp exits.
    Typically, you setup playlist madrop, save settings and quit, then call
    MoreAmp with arguments for the songs to play.
    For example, using a nogui build (win):
    `C:\...\MoreAmpNOGUI.exe C:\...\songX`
    `C:\...\MoreAmpNOGUI.exe C:\...\songY C:\...\songZ`
    `C:\...\MoreAmpNOGUI.exe C:\...\AnySongongDir`
    See also "Auto Start" above.

  Drag and Drop :

  - You can drop songs, folders, links, CD, and/or playlist icons on the
    MoreAmp app icon, or, on Mac, also on the dock MoreAmp icon.
 
    - This will start MoreAmp and create a new madrop playlist.

    - If MoreAmp is already running 
       - on win this will start another instance of the player, or do
         nothing, depending on whether you have Win 2000, 98, XP,
         Vista or 7;
       - on Unix X11/GTK platforms what happens depends on the window
         manager;
       - on mac this will stop any currently playing song and create a new
         madrop playlist, or add to an existing madrop list if it has Add
         mode set.

  - With wx builds, you can also drop objects onto the MoreAmp app (main)
    window or list window. 
    This will stop any currently playing song and create a new madrop
    playlist, or add to an existing madrop list if it has Add mode set.
    - On Mac the main window does not accept dropped files (but the list
      window does).
    - On some unix/linux platforms this may not work at all.

  Error Logging :

    When MoreAmp encounters problems it will log up to 1000 errors to file
    'maLog.txt', after which it will popup up a warning and stop logging,
    and stop loading or playing. If the 'Error Logging' setting is off no
    logging or error stopping will occur. Use the 'Edit Log' Tools menu or
    any text viewer to view maLog.txt.

  - Depending on the type of error you can get both an error popup and a
    log entry.

  - If there is no maLog.txt file (no errors have been logged) then the
    Edit Log and Clear Log menu items are disabled until an error is
    logged (by that instance of MoreAmp). The keyboard shortcuts to view
    and clear the log are not disabled.    

  - The first digit of an entry ('1 ', '2 ', '3 ' etc.) refers to the
    instance of MoreAmp that generated the error.

  - See "Error-log non-playable files when creating a playlist" above.

  Multiple Instances :

  - On mac, run multiple instances of MoreAmp from multiple copies of the
    MoreAmp executable. The copies' names need to start with 'MoreAmp',
    e.g. 'MoreAmp', 'MoreAmp copy', 'MoreAmp copy 1', 'MoreAmp 2', etc.

  - On win, you can run multiple instances of MoreAmp from a single
    MoreAmp executable in the MoreAmp folder.

  - On unix, you can run multiple instances of MoreAmp from a single
    MoreAmp executable, installed anywhere.

  - Instances appear on the screen as 'MoreAmp' ('moreamp' on unix) for
    the first instance, then MoreAmp2', 'MoreAmp3', etc. in the order they
    are started.

  - You can disable multiple instances with the 'Multiple Instances' item
    in the Settings menu of the first instance.

  - Each instance has its own default settings.

___________________________________________________________________________

Audio support

MoreAmp built with Portaudio supports the following audio systems :

   ASIO for Windows and Macintosh
   BeOS
   Macintosh Sound Manager for OS 8,9 and Carbon
   Macintosh Core Audio for OSX
   Silicon Graphics AL
   OSS implementation for various Unixes
   Windows Direct Sound
   Windows MME (most widely supported)

___________________________________________________________________________

Live audio input

MoreAmp built with Portaudio can play live audio from a system audio input.

Audio input mode is activated with the 'Controls/Audio In' menu item or by
opening file maaudioin.maf or by playing any file with a '.maa' extension,
e.g. 'audioin.maa'.

The system audio input will play though the MoreAmp effects, equalizer and
output controls.

The output can be recorded to an output file by selecting one of the output
files (flac, ogg, wav, etc) instead of the Sound output.

If Portaudio was built with Jack support then audio from other applications
can be routed to MoreAmp.

The input device for Audio In and the audio output device can be selected
with the four popup selectors at the bottom of the main window.
   
The Enable button next to Audio Input Host API allows using an input
device on an API different from the output API, e.g., on Windows, an
MME device for input and a Windows Direct Sound device for output.
   
The Info list window lists the audio devices currently selected.

After adding or removing audio devices while Moreamp is running, use
the Tools/Rescan Audio Devices menu,
___________________________________________________________________________

Keyboard shortcuts, Key bindings

    If the 'Use Keyboard' menu item is set then MoreAmp will accept
    keyboard shortcuts to various menus, pushbuttons and checkbuttons.

    Keyboard shortcuts, the up and down arrows for scrolling the list, and
    the 'Enter' key are accepted in the main, list, eq and effects 
    wibndows. If the up and down arrows don't scroll the playlist on your
    platform, try using the 'Scroll Up' and 'Scroll Down' shortcuts ('i'
    and 'k' by default).

    The file masettings/makeybindings.txt contains the associations between
    keys and functions. It can be edited with the 'Edit Key Bindings' Tools
    menu and will be recreated with factory shortcuts if it is missing or
    if you select the 'Factory Key Bindings' Tools menu.
    You can use the the 'Blank Key Bindings' Tools menu to create a new
    keybindings file without the default values (no shortcuts defined).

    Key bindings are not affected by the Factory or Default Settings menus.

    Notes:
    - On some platforms (e.g. OS X with MoreAmpN) lists have an autoscroll
      feature, e.g. you type 'c' and the lists scrolls to the first entry
      beginning with 'c'. To use the keyboard shortcuts instead, you need
      to move the keyboard focus outside the list: click in the window area
      outside the list or click in another window, or press the ESC key.
    - Pressing the ESC key moves the keyboard focus to the main window.
    - On some platforms, the up/down arrows don't scroll lists when the
      list does not have keyboard focus. Use the ScrollUp and ScrollDown
      shortcuts instead ('i' and 'j' by default).
    - The PlayIndex shortcut ('?' by default) prompts you for the index
      number of a song to play (if the 'Use Keyboard' menu item is set).
    - The Lists shortcut ('q' by default) on a No gui build dumps the
      playlist to the terminal window in the Playlist format (Show paths
      or Show dir) last saved. The index is always shown.
___________________________________________________________________________

No gui - No Graphic User Interface

    MoreAmp can be built with a wxWidgets gui on OSX/windows/linux/
    unix, or with the native carbon gui on OSX, or with GTK+1.2 or GTK+2
    on linux/unix, or with no gui at all, as detailed in the INSTALL files.

    A MoreAmp without any gui works just like a MoreAmp with a gui with the
    keyboard shortcuts.

    Use a MoreAmp with gui to change the settings or to make playlists,
    quit, then start the MoreAmp without any gui.
    Both MoreAmps should have been built with the same configuration.

    Start the MoreAmp without any gui by double-clicking its icon or
    dropping files on it, or by entering a command line in a shell :

    on unix or OSX :

    	.../moreampnogui /fullpathto/moreamp/maplaylists/anyplaylist.maf

        or

    	.../moreampnogui /fullpathto/anysongfile.mp3

     or, in a win .bat file :

    fullpath\MoreAmpNOGUI.exe fullpath\MoreAmp\maplaylists\anyplaylist.maf

    The command line arguments can be full paths to song files or
    playlistsor directories or links, whatever is otherwise dropped on a
    MoreAmp with gui.

    If there are no command line arguments, the playlist at the head of
    file 'masettings/marecentlistname.txt' is used.

    A MoreAmp without any gui ignores the 'Use Keyboard' setting.

    A MoreAmp without any gui will stop and exit if no playlist was ever
    selected (empty or bad file 'masettings/marecentlistname.txt'), of if
    everything goes wrong.

    Exit a MoreAmp without any gui by typing the "Quit" shortcut ("Q" by
    default), or  with Ctl-C, or 'Quit' from its taskbar icon if there is
    one.

    See also the Notes about the PlayIndex and Lists shortcuts in
    'Keyboard shortcuts' above.

    On OS X the Terminal app needs to work with Unicode:
     1. In Terminal's Window Settings menu (named 'Terminal Inspector')
        a. In the 'Emulation' section,
           turn off the 'Escape non-ASCII characters' option.
        b. In the 'Display' section,
           choose 'Unicode (UTF-8)' as the Character Set Encoding.
        Click 'Use Settings as Defaults' for a permanent change.
     2. a. Enter `locale -a` to find your language and use it instead of
           'en_US' below, e.g. 'es_ES.UTF-8'.
        b. Enter `export LC_CTYPE=en_US.UTF-8` before running MoreAmp
           or, as a premanent change for all your terminal windows,
           add the following to your ~/.profile file and reopen Terminal :
           'export LC_CTYPE=en_US.UTF-8'.
           or, use a script with this line :
           'export LC_CTYPE=en_US.UTF-8; ...pathto/moreampnogui'.
        You need the permanent changes above if you start moreampnogui
        by double-clicking it in a finder window.
    
___________________________________________________________________________

Unicode UTF-8 encoded files

    The text files that MoreAmp creates for playlists (.maf), catalogs, the
    key bindings and the error log (.txt), and this README file, are
    encoded in Unicode UTF-8 text format.

    If you create playlists with a text editor or some other program, you
    should save (export) them with UTF-8 encoding. Most text editors let
    you choose a text encoding from the "Save As" menu.

    MoreAmp recognizes that files are UTF-8 encoded simply by checking for
    a BOM ("Byte Order Mark", three bytes hex ef bb bf) at the start of a
    file, and if it isn't there, it logs a "non-UTF-8 file" error message
    and tries to use the file by assuming it is in the local text encoding.

    So, when opening a playlist, if you get a "non-UTF-8 file" error in the
    log, and no other error, and you are then able to make a catalog with
    no errors, then that non-UTF-8 playlist is usable and you can Edit/Save
    it from the Tools "Edit Playlist" menu, which will save it on disk as a
    UTF-8 encoded playlist.

___________________________________________________________________________

Currently implemented functionality by platform and audio file type

in	: can play a file.

out	: can create a file; out* : src release only, not available in bin
          release.

tags	: can read and display tag info.

seek	: can play from arbitrary start time or slider position.

drag	: can play files/lists/cd/dirs/links by dragging and dropping them
drop	  on the MoreAmp app icon or on a MoreAmp window.

args    : accepts command line arguments (files/lists/cd/dirs/links).

OSX
   AAC in, out*, no tags, no seek
   AIF in, out, seek
   FLAC in, out, tags, seek
   MP3 in, out*, tags, seek
   MP4 in, out*, tags, seek
   OGG in, out, tags, seek
   WAV in, out, seek
   WMA in, tags, no seek
   CD in, seek
   Audio In (with Portaudio, and Jack if enabled in Portaudio)
   drag-drop (on osxnative build, works only on app icons, not app windows)
   no args (accepts OpenDocument events)

Win
   AAC in, out*, no tags, no seek
   AIF in, out, seek
   FLAC in, out, tags, seek
   MP3 in, out*, tags, seek
   MP4 in, out*, tags, seek
   OGG in, out, tags, seek
   WAV in, out, seek
   WMA in, tags, no seek
   CD in, seek
   Audio In
   drag-drop
   args

Unix
   AAC in, out*, no tags, no seek
   AIF in, out, seek
   FLAC in, out, tags, seek	
   MP3 in, out*, tags, seek	
   MP4 in, out*, tags, seek	
   OGG in, out, tags, seek	
   WAV in, out, seek	
   WMA in, tags, no seek
   CD in, seek		
   Audio In (and Jack if enabled in Portaudio)
   drag-drop (untested, depends on wxWidget and your window manager)
   args

* in src release only, not available in bin release.
___________________________________________________________________________

Known bugs

- On OSX/wx, drag-and-drop does not work on the main window, only on the
  list or eq windows or on the MoreAmp app icon or the dock icon.

- On OSX/wx, drag-and-dropping an Audio CD icon does not work onto a
  MoreAmp window but works onto a MoreAmp icon. Dropping an alias to an
  Audio CD onto a MoreAmp window or MoreAmp icon works, or opening an
  Audio CD and dropping the aiff files also works.

- On OSX wxGTK2 and OSX GTK2 builds, for the Play CD and Eject CD menus
  and the Info list window, an audio cd is not recognized unless it was
  mounted before starting moreamp. Selecting cd tracks from the Play Song
  Files menu (e.g. "/Volumes/Audio CD/1 Audio Track.aiff") does work.

- On win, MoreAmp with no gui cannot process shortcuts (.lnk files).

- On wxMac builds, the About or README keyboard shortcuts do not appear
  next to their menu item.

- The unix/linux cd player tries to play non-audio cd's.

- On unix/linux GTK2 builds the window positions relative to the
  main window are sometimes incorrect when the windows are opened or do
  not track when moving the main window. This problem varies with window
  managers. Leaving some space between the windows can help.
   
___________________________________________________________________________

MoreAmp is released under the GNU GENERAL PUBLIC LICENSE (GPL).
This means that you can get the source code and do pretty much what you
like with it, as explained in the text files 'COPYING' and
'COPYINGOggVorbis'.
 
MoreAmp uses libraries also released under GPL. Some of these libraries
have been modified for use with MoreAmp. Credit to the original releases
is given under the 'About' menu item and in the source code.

Due to patent restrictions, the MoreAmp binary executable is distributed
with only the flac and ogg encoders (and aif and wav) compiled in, i.e.
without the mp3 or aac/mp4 encoders.

If you want MoreAmp for unix/linux, or a MoreAmp that creates mp3 and/or
aac/mp4 files, or to otherwise modify MoreAmp, you can build it yourself
from the source code distribution. Go to
             http://sourceforge.net/projects/moreamp/files/
and select the newest MoreAmp-x.x.x-src.tar.gz.

For build instructions for each platform see the INSTALLxxx.txt files, and
the 'READMElibsXXX' files in the 'libs' dir of the source distributation.

You can post bugs or comments or get help on the SourceForge.net:Forums
for MoreAmp page. Go to
	http://sourceforge.net/projects/moreamp/forums
___________________________________________________________________________

eof
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      