Welcome

Home

About

Promote

Links

Articles

Quick start

Beginner's Guide

Illustrated Manual

Tutorials

XMPlay FAQ

Add-ons

Native

Skins (146)

Visuals (115)

Input Plug-ins (35)

Output Plug-ins (5)

General Plug-ins (11)

Archive Reader (16)

Winamp

Input Plug-ins (40)

DSP Plug-ins (10)

Tag Editing Plug-ins (6)

External Encoders (3)

External Add-ons (16)

XMPlay Archive (69)

Controlling XMPlay

You can have XMPlay execute lots of function by sending a key-command to it via DDE. Using an info-command, you can request information of the file currently being played. See the DDE command list for a full list of available commands, and the DDE code example page for some examples.

Opening and adding files

Files, folders and URLs can be passed to XMPlay via DDE. To do so, set the Application to XMPlay, the Topic to System and send the message [open("filename")] (to open a file) or [list("filename")] (to add a file to the playlist). Note that the message includes the brackets and parenthesis. Multiple files should be sent in multiple messages. XMPlay will treat files coming in quickly after each other as a single batch, so it can auto-sort them.

These DDE commands are used in Explorer for the associated filetypes on Windows XP and older.

Next page: DDE command list

The contents of the Info Window can be fetched via DDE by sending an info# message to XMPlay, where you replace # with the number from the list below.

Note that the returned text is in UTF-8 on Windows NT, XP and newer.

Below is a list of DDE control commands. The commands are executed by sending a key# message to XMPlay, where you replace # with the number found in the list.

Next page: DDE code example

XMPlay Controller

XMPlay Controller is a standalone application which uses DDE to send commands to XMPlay. See the included manual for more information.

DDE_run

DDE_run is a command line application which can send DDE messages to any other program. The code to send the Play/Pause command is DDE_run -s XMPlay -t System -c key80, where -s flags the target application name, -t the link topic and -c the command. You can replace key80 with any of the keys from the DDE command list, or with a file opening command.

Visual Basic 6

Create a new VB project, and dump two text boxes and a pair of command buttons on the form. Do whatever you like to them, but you'll want to make Text2 reasonably large with MultiLine enabled. Add the following code to the form (changing the names if you changed them):

Private Sub Command1_Click()
' Use this one to retrieve data, e.g. infox topics

Text2.LinkTopic = "XMPlay|" & Text1.Text ' Init link topic
Text2.LinkMode = 2 ' Open connection
Text2.LinkRequest ' Grab data
Text2.LinkMode = 0 ' Close connecton
'''' EDIT: remove next line if you get a blank line between every line ''''
Text2 = Replace(Text2, vbLf, vbCrLf) ' Reformat string as textbox needs CRLF
End Sub

Private Sub Command2_Click()
' Use this one to execute a function, e.g. keyxxx topics or playlist manipulation

Text2.LinkTopic = "XMPlay|XMPlay" ' Init link topic. The second part (after the '|') doesn't appear to matter but must not be empty.
Text2.LinkMode = 2 ' Open connection
Text2.LinkExecute Text1.Text ' Execute function
Text2.LinkMode = 0 ' Close connection
End Sub

This code example is made by BoggyB (a long time ago).

Next page: Library file format