List Of Macros:

 

  • %PROCSTATUS(processName) - returns ON if process is running, OFF else

    example: %PROCSTATUS("opera.exe") will return ON if Opera is running

  • %KILLPROC(processName) - kills the process

    example: %KILLPROC("opera.exe")

  • %FILESIZE(filename,format) - returns size of specified file, format is one of the following:

    M - size in MegaBytes
    K - size in KiloBytes
    B - size in Bytes

    example: %FILESIZE("c:\windows\explorer.exe","k") will return 977

  • %OWNIP - returns your ip address if u're online, OFFLINE else

  • %COPYFILE(source,destination,option) - Copies file source to destination , option specifies how this operation is to proceed if a file of the same name as that specified by destination already exists. If this parameter is 1 and the new file already exists, the macro fails. If this parameter is 0 and the new file already exists, the macro overwrites the existing file and succeeds.

    example: %COPYFILE("c:\windows\explorer.exe","c:\explorer.exe","1")

  • %DELETEFILE(filename) - Deletes file filename

    example: %DELETEFILE("c:\temp.txt")

  • %DELETEFILES(wildcard) - Deletes all files specified with wildcard

    example: %DELETEFILES("c:\windows\temp\*.txt")

  • %MD5(string) - calculates MD5 hash of string

  • %WTITLEE(word) - returns title of window ending with word

    example: %WTITLEE("Explorer") will return "about:blank - Microsoft Internet Explorer" (if Internet Explorer is open with a blank page)

  • %WTITLES(word) - returns title of window starting with word

    example: %WTITLES("ACDSee") will return "ACDSee 6.0 - My Pictures" (if "My Pictures" folder is open in ACDSee )

  • %WTITLEALL - returns titles of all windows

  • %WTITLEREGEXP(regexp) - returns title of window matching regexp regular expression

    example: %WTITLEREGEXP("[0-9]+.*Winamp") will return Winamp window title
    (like "50. Sepultura - Roots, bloody, roots - Winamp" :] )

  • %INETTIME - internet time in beats(1000 beats=1 day)

  • %NUM_LOCK_ON
    %NUM_LOCK_OFF
    %CAPS_LOCK_ON
    %CAPS_LOCK_OFF
    %SCROLL_LOCK_ON
    %SCROLL_LOCK_OFF


    - toggles NumLock(CapsLock ,ScrollLock) on/off

  • %NUMLOCK_IS_ON
    %CAPSLOCK_IS_ON
    %SCROLLLOCK_IS_ON


    - returns ON(OFF) if corresponding "lock" is on(off)

  • %GETINIVALUE(filename,section,key) - retrieves specified key value from .ini file

    example: %GETINIVALUE("c:\boot.ini","boot loader","timeout") will return the timeout key value from boot.ini file's [boot loader] section , e.g. 10

  • %SETINIVALUE(filename,section,key,value) - set specified key value in .ini file to specified value

    example: %SETINIVALUE("c:\boot.ini","boot loader","timeout","30") will set the timeout key value in boot.ini file's [boot loader] section to 30

    these 2 macros can be used to store %_variables in ini file and retrieve them later

  • %FIGLET(text,font_name) - returns text using specified figlet(Frank, Ian & Glenn's Letters) font. font_name - is the name of corresponding flf-file from "fonts" folder.

    example: %FIGLET("hello","smslant") will return the word "hello" using "smslant" font:
       __       ____   
      / /  ___ / / /__ 
     / _ \/ -_) / / _ \
    /_//_/\__/_/_/\___/ 
    18 figlet fonts are included, additional fonts can be installed by copying them to "fonts" folder.
    More fonts(over 400) can be downloaded from ftp://ftp.figlet.org/pub/figlet/fonts/

  • %WINAMP_GET("parameter") - returns corresponding information about winamp.
    Works with
    Winamp 2(5),Quintessential Player,Apollo,MediaMonkey.To make it work with iTunes player download plugin for iTunes.
    parameter can be one of the following
    • status - OFF,STOPPED,PLAYING ,PAUSED
    • title - current playing song title
    • playlist_length - number of songs in playlist
    • playlist_pos - playlist position(current playing song number)
    • bitrate - current playing song's bitrate
    • samplerate - current playing song's samplerate
    • channels - current playing song's channels number
    • track_length - the track length, in seconds
    • position -the position in milliseconds of the current track

    example: %IF:%WINAMP_GET(status)=PLAYING:"now playing song %WINAMP_GET(playlist_pos) of %WINAMP_GET(playlist_length)":"Winamp is stopped"

  • %WINAMP_CMD("command") - sends winamp(Quintessential Player,Apollo) the specified command.
    Works with Winamp 2(5),Quintessential Player,Apollo,MediaMonkey. Player must be running.

    command can be one of the following
    • play - start playback
    • stop - stop playback
    • pause - pause playback
    • prev - go to previous track
    • next - go to next track
    • startofl - go to first track in playlist(winamp only)
    • endofl - go to last track in playlist (winamp only)

    example: %WINAMP_CMD("pause")

  • %SONIQUE("parameter") - returns corresponding information about sonique player.

    parameter can be one of the following
    • path - path of current playing file
    • artist - current playing song's artist name
    • song - current playing song's name
    • length - current playing song's length is m:ss format
    • length_sec - current playing song's length is seconds
    • position - current playing song's position is m:ss format
    • position_sec - current playing song's posistion is seconds

    example: %SONIQUE("path") will return: D:\music\Einsturzende Neubauten\silence.mp3

  • %XMPLAY("parameter") - returns corresponding information from XMPlay player.

    parameter can be one of the following
    • artist - current selected song's artist name
    • title - current selected song's title

    if parameter isn't specified macro will return detailed information about selected song

    example: %XMPLAY("title") , %XMPLAY

  • %MMJB_TITLE - returns current playing song's title from MUSICMATCH Jukebox player.

    returns OFF is player is not running, or STOPPED if player is running but not playing a song.

    example: %MMBJ_TITLE

  • %SETCLIPBOARDTEXT("text") - places the text on clipboard

  • %BEEP(frequency,duration) - generates simple tones on the system speaker(has nothing to to with soundcard).
    frequency specifies the frequency, in hertz, of the sound. This parameter must be in the range 37 through 32767.
    duration specifies the duration, in milliseconds, of the sound.
    note:duration and frequency parameters are used only in windows 2k/xp.
    Windows 9x: On computers with a sound card, the function plays the default sound event. On computers without a sound card, the function plays the standard system beep.

  • %SKIPLINE(text,regular_expression) - removes lines containing regular_expression from text

    example: %SKIPLINE(%QUOTES,">>|wrote:") - will insert quoted text without lines that contain double quotation or "wrote:"


  • %TEXTBEFORE(text,regular_expression,[include]) - returns all lines from text before the line containing regular_expression.
    optional parameter include specifies if line containing regular_expression will be included.If macro is called with 2 parameters it's not included.

    example: %TEXTBEFORE(%QUOTES,"__") , %TEXTBEFORE(%QUOTES,"__",1)


  • %TEXTAFTER(text,regular_expression,[include]) - returns all lines from text after the line containing regular_expression.
    optional parameter include specifies if line containing regular_expression will be included.If macro is called with 2 parameters it's not included.

    example: %TEXTAFTER(%QUOTES,"__") , %TEXTAFTER(%QUOTES,"__",1)


  • %RANDOMFILE(mask) - returns a random file name from directory specified with mask

    example: %RANDOMFILE("c:\windows\*.exe") will return setdebug.exe

  • %VOLUMECONTROL(command,[value]) - controls master volume

    command can be one of the following
    • mute - mutes volume
    • enable - enables volume if it's muted
    • set - sets volume to specified value (1-100)
    value is used only with set command

    example:
    %VOLUMECONTROL("mute")
    %VOLUMECONTROL("set",50)


  • %GETCURRENTVOLUME - returns current volume value (1-100)


  • %EJECTCDROM - opens CD-ROM drive


  • %CLOSECDROM - closes CD-ROM drive


  • %ZVERSION - returns plugin version

back