Command line

Ay_Emul can take parameters from command line. Parameters must be divided with spaces. If first char of parameter is '-' (can be '/' also in Windows-version) then it is interpreted as key else as file name.

If parameter (key or file name) contains spaces, it must be double quoted (can be quoted the part of parameter with spaces).

If several same parameters are passed, then last one is stored.

Files in command line (except skin files) will be added to cleared playlist and first one will start playing. Skin file can be passed with or without key (see further). You can give via command line one or more file names (including playlist files: AYL, M3U, M3U8, PLS and CUE). And you can specify track/song number for multitrack/multisong formats (AY, AYM, SNDH, MID or XMI) after file name (using ":N" addition, where N is track number starting from 0).

You don't need point full path to executable in Windows-version if you are registering application in system (see "Tools" window description).

List of keys

-sX – sample rate in Hz
X = from 8000 to 300000
-b8, -b16 – bit rate
8 or 16
-dmono, -dstereo, -dlist, -dmixer – channels number for sound card
mono or stereo; take or ignore pointed in playlist
-wonX – number of sound buffers
X = from 2 to 10
-wolX – length of sound buffer in ms
X = from 5 to 2000
-wodX – digital sound device number
X >= 0
-zX – Z80 chip frequency in Hz
X = from 1000000 to 8000000
-eay, -eym, -elist, -emixer – chip type
AY-3-8910/12 or YM2149(F); take or ignore pointed in playlist
-yX, -ylist, -ymixer – sound chip frequency in Hz
X = from 1000000 to 3000000; take or ignore pointed in playlist
-tX – first interrupt offset in Z80 tacts
X >= 0
-iX – number of Z80 tacts between interrupts
X > 0
-aon, -aoff – amplitude analyzer
turn on or off
-fon, -foff – spectrum analyzer
turn on or off
-lX – interface language
X = standard ID for language (ru – Russian, en – English, etc.)
-nX, -nlist, -nmixer – interrupt frequency in mHz
X = from 1000 to 2000000; take or ignore pointed in playlist
-con, -coff – loop song playing
turn on or off
-ri, -rn, -rh – application priority (for Windows-version)
idle, normal or high
-hX, -hlist, -hmixer – channels amplification
X - abbreviation for standard schematic (MONO, AYABC, YMABC, AYACB, YMACB and so on); take or ignore pointed in playlist
-hX,X,X,X,X,X – manual channels amplification
three pairs of amplification coefficients for each chip's channel A, B and C (first number for left channel, second for right in a pair), X = from 0 to 255
-g0, -g1, -g2 – icon in system tray
never, always or minimize
-kon, -koff – auto scroll name
turn on or off
-j0, -j1, -j2 – timer mode
"elapsed", "remained", "duration”
-p, -pX – load skin
standard or from file (X is its path and name), skin file name can be pointed without key -p also
-q, -qX – MFP timer frequency in Hz
attach to AY/YM frequency or set fixed (X = from 1000000 to 3000000)
-uX – beeper amplification
X = from 0 to 255
-vhide, -vshow – application's windows
minimize or restore
-won, -woff – auto saving path to last folder
turn on or off
-!on, -!off – auto saving volume position
turn on or off
-xon, -xoff – auto saving position of windows
turn on or off
-fdPX – adjusting track information (see "Tools" window)
change P for parameter and X for its value:
-fdfX – X is the target file name
-fdnX – X is "Nothing" string
-fdsX – X is "Suffix" string
-fdpX – X is "Prefix" string
-fde0, -fde1 – check or uncheck "Enabled"
-fdk0, -fdk1 – check or uncheck "Kill On Nothing"
-fdx0, -fdx1 – check or uncheck "Kill On Exit"
-fdcX – X is "Code page" name
-add – change adding mode for next files
adding files to the end of playlist
-adp – change adding mode for next files
adding files to the end of playlist and starting playing first one of them

Examples

  1. Play My_Song.vtx using channel B only at center (hmixer key is pointing to ignore corresponding parameter in VTX-file):
    Ay_Emul -h0,0,255,255,0,0 -hmixer My_Song.vtx
  2. Play My New Song.sqt by emulating AY-3-8910/12:
    Ay_Emul.exe "My New Song.sqt" /eay
  3. Setting standard amplification YMABC, chip type YM2149, chip frequency 1750000 Hz, interrupt frequency 48.828 Hz in mixer (typical xUSSR version of ZX Spectrum computer is Pentagon 128K):
    Ay_Emul.exe /hYMABC /eym /y1750000 /n48828
  4. Load skin Example.ays:
    Ay_Emul Example.ays
  5. Load skin Example.ays via key (backward compatibility):
    Ay_Emul.exe /p"C:\Skin Manager\"Example.ays
  6. Add to playlist first track of DESERT.XMI, third melody from Dizzy 7.ay and second melody from Dizzy 6.aym:
    Ay_Emul -add DESERT.XMI:0 "Dizzy 7.ay":2 "Dizzy 6.aym:1"