MediaMonkey Wiki - User contributions [en]

Winamp Plug-ins (MM4)

2021-03-09T21:56:06Z

Steegy:

== Download plugins ==

A lot of Winamp plugins can be used with MediaMonkey. See the [http://web.archive.org/web/20131201123612/http://www.winamp.com/plugins Winamp's plugin library] for an overview and downloads.

Some of the most used MediaMonkey plugins are listed and can be downloaded [http://web.archive.org/web/20180222232119/http://home.scarlet.be/ruben.castelein/MM/MM-Plugins.htm here].

== Plugin development ==

The majority of the Winamp 2 API is supported, enabling Winamp Input plugins, Output plugins, General plugins, DSP plugins, and Visualization plugins to be used with MediaMonkey.

With MediaMonkey 3, support for unicode plugins has been added for higher compatibility with the Winamp 5 API. Media Library plugins are not supported.

[http://web.archive.org/web/20070818184840/http://www.winamp.com/development/plugins Winamp Plug-ins Development Page]


If you need help with developing plugins for MediaMonkey, or if you need information about MediaMonkey's Device plugins, please contact the developers or use the [http://www.mediamonkey.com/forum/viewforum.php?f=2 Scripts and Components forum].

== Help with plugins ==

Here you can add your help and snippets for the development of MediaMonkey plugins.
* [[Learning Code Snip-its]]
* [[Working Codes for addin to your plug-ins]]
* [[Helpful instructions]]
* [[Alpha or Beta Codes needing testing]]

SDBSongList

2011-10-11T21:13:06Z

Steegy:

{{AutomationObjectsList}}
== CoClass SDBSongList ==

List of tracks.

=== ISDBSongList members ===

{{MethodsList
|[[ISDBSongList::Add|Add]] |Method |
|[[ISDBSongList::Insert|Insert]] |Method |
|[[ISDBSongList::Albums|Albums]] |Property Get |
|[[ISDBSongList::Artists|Artists]] |Property Get |
|[[ISDBSongList::Count|Count]] |Property Get |
|[[ISDBSongList::Delete|Delete]] |Method |
|[[ISDBSongList::Item|Item]] |Property Get/Let |
|[[ISDBSongList::UpdateAll|UpdateAll]] |Method |
}}

=== Related Topics ===

*[[ISDBApplication::CurrentSongList]]
*[[ISDBApplication::SelectedSongList]]
*[[ISDBApplication::AllVisibleSongList]]
*[[ISDBPlaylist::Tracks]]
*[[ISDBApplicationEvents::OnBeforeTracksMove]]
*[[ISDBApplication::NewSongList]]

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBSongList|{{PAGENAME}}]]

ISDBDatabase::QuerySongs

2011-10-11T21:08:49Z

Steegy:

{{MethodDeclaration|SDBDatabase|ISDBDatabase|Function QuerySongs(AddSQL As String) As SDBSongIterator}}

===Parameters===

{{MethodParameters
|AddSQL |String |Only condition part of SQL statement (WHERE clause)}}

===Method description===

Returns a [[SDBSongIterator]] object with a list of tracks fulfilling criteria specified by AddSQL parameter.

===Example code===
<source lang="vb">
Set Iter = SDB.Database.QuerySongs("SongLength > 60*1000")
</source>

===Older versions===

In MediaMonkey prior version 3.0 the AddSQL string had to start with "AND ", but this is no longer needed.

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBDatabase|{{PAGENAME}}]]
[[Category:Interface ISDBDatabase|{{PAGENAME}}]]

ISDBSongList::UpdateAll

2011-10-11T21:04:26Z

Steegy:

{{MethodDeclaration|SDBSongList|ISDBSongList|Sub UpdateAll}}

===Method description===

Updates database entries for all tracks in the list, i.e. writes any modifications back to DB. Also all tags are updated accordingly, ''but only if the option is turned on in the Options dialog (by default it is)''.

This (using UpdateAll on a SDBSongList object), is prefered over using the UpdateDB and WriteTags methods on a SDBSongList object, because it takes into account the user's preferences.

===Example code===
<source lang="vb">
' Track refers to a SDBSongData Object for which you want to save changes to the database AND the file's tags (if set in the options)
Dim SL : Set SL = SDB.NewSongList
SL.Add Track
SL.UpdateAll

' This is prefered over:
'Track.UpdateDB
'Track.WriteTags ' The user might not always want this!
</source>

=== Related Topics ===

*[[ISDBSongData::UpdateDB]]
*[[ISDBSongData::WriteTags]]

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBSongList|{{PAGENAME}}]]
[[Category:Interface ISDBSongList|{{PAGENAME}}]]

SDBSongList

2011-10-11T20:54:23Z

Steegy:

{{AutomationObjectsList}}
== CoClass SDBSongList ==

List of tracks.

=== ISDBSongList members ===

{{MethodsList
|[[ISDBSongList::Add|Add]] |Method |
|[[ISDBSongList::Insert|Insert]] |Method |
|[[ISDBSongList::Albums|Albums]] |Property Get |
|[[ISDBSongList::Artists|Artists]] |Property Get |
|[[ISDBSongList::Count|Count]] |Property Get |
|[[ISDBSongList::Delete|Delete]] |Method |
|[[ISDBSongList::Item|Item]] |Property Get/Let |
|[[ISDBSongList::UpdateAll|UpdateAll]] |Method |
}}

=== Related Topics ===

*[[ISDBApplication::NewSongList]]

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBSongList|{{PAGENAME}}]]

ISDBSongData::WriteTags

2011-10-11T20:47:24Z

Steegy:

{{MethodDeclaration|SDBSongData|ISDBSongData|Sub WriteTags}}

===Method description===

Updates tags of file according to properties of the track.

However, the prefered way is to use ISDBSongList's [[ISDBSongList::UpdateAll|UpdateAll]] method, which saves changed to the database AND the file's tags (the latter only if this is set in MM's options).

=== Related Topics ===

*[[ISDBSongData::UpdateDB]]
*[[ISDBSongList::UpdateAll]]

{{Property Summary|SongData|WriteTags|Method||||||}}
[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBSongData|{{PAGENAME}}]]
[[Category:Interface ISDBSongData|{{PAGENAME}}]]

ISDBSongData::UpdateArtist

2011-10-11T20:46:02Z

Steegy:

{{MethodDeclaration|SDBSongData|ISDBSongData|Sub UpdateArtist}}

===Method description===

Normally it isn't necessary to call this method because artist is updated in Library after [[ISDBSongData::UpdateDB|UpdateDB]]. However, you need to call this method in case you changed only the capitalization of the artist name.

=== Related Topics ===

*[[ISDBSongData::UpdateAlbum]]
*[[ISDBSongData::UpdateDB]]

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBSongData|{{PAGENAME}}]]
[[Category:Interface ISDBSongData|{{PAGENAME}}]]

ISDBSongData::UpdateAlbum

2011-10-11T20:45:04Z

Steegy:

{{MethodDeclaration|SDBSongData|ISDBSongData|Sub UpdateAlbum}}

===Method description===

Normally it isn't necessary to call this method because album is updated in Library after [[ISDBSongData::UpdateDB|UpdateDB]]. However, you need to call this method in case you changed only the capitalization of the album name or album artist.

=== Related Topics ===

*[[ISDBSongData::UpdateArtist]]
*[[ISDBSongData::UpdateDB]]

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBSongData|{{PAGENAME}}]]
[[Category:Interface ISDBSongData|{{PAGENAME}}]]

ISDBSongList::UpdateAll

2011-10-11T20:43:14Z

Steegy:

{{MethodDeclaration|SDBSongList|ISDBSongList|Sub UpdateAll}}

===Method description===

For all tracks in the list updates DB entries, i.e. writes any modifications back to DB. Also all tags are updated accordingly, but only if the option is turned on if Options dialog (by default it is).

=== Related Topics ===

*[[ISDBSongData::UpdateDB]]
*[[ISDBSongData::WriteTags]]

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBSongList|{{PAGENAME}}]]
[[Category:Interface ISDBSongList|{{PAGENAME}}]]

ISDBSongData::UpdateDB

2011-10-11T20:42:39Z

Steegy:

{{MethodDeclaration|SDBSongData|ISDBSongData|Sub UpdateDB}}

===Method description===

Writes changes that were made to track's properties back to the Library.

However, the prefered way is to use ISDBSongList's [[ISDBSongList::UpdateAll|UpdateAll]] method, which saves changed to the database AND the file's tags (the latter only if this is set in MM's options).

=== Related Topics ===

*[[ISDBSongData::UpdateArtist]]
*[[ISDBSongData::UpdateAlbum]]
*[[ISDBSongData::WriteTags]]
*[[ISDBSongList::UpdateAll]]

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBSongData|{{PAGENAME}}]]
[[Category:Interface ISDBSongData|{{PAGENAME}}]]

ISDBApplication::NewSongList

2011-10-11T20:30:17Z

Steegy:

{{MethodDeclaration|SDBApplication|ISDBApplication|Property Get NewSongList As ISDBSongList}}

===Property description===

Returns a newly created [[SDBSongList]] object.

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBApplication|{{PAGENAME}}]]
[[Category:Interface ISDBApplication|{{PAGENAME}}]]

Introduction to scripting

2011-06-25T14:28:35Z

Steegy:

MediaMonkey can be customized through the use of custom scripts. Scripts are relatively simple computer programs written in a scripting language, such as VBScript. Unlike most computer programs, these scripts do not have to be compiled, which allows them to be tested and modified more easily than with more advanced languages. Still, writing MediaMonkey scripts can be a challenging experience so potential script writers should consider alternatives, particularly if they have little previous experience writing scripts.

== Considerations ==

Before writing their own scripts, users of MediaMonkey may wish to consider the following issues:
*In addition to supporting scripting, MediaMonkey has a [[Plug-ins|plug-in]] interface that allows a large number of Winamp and MediaMonkey plug-ins to be used. There may be no need to write a script if the desired features are already provided by a plug-in.
*Some users of MediaMonkey are willing to share the scripts that they have written with other users. An existing script may already provide the desired features or be relatively easily modified so that it does. The best place to find such scripts or to get support for them is the [http://www.mediamonkey.com/forum/viewforum.php?f=2 Scripts and Components forum].
*Although, in theory, MediaMonkey supports both of the [http://en.wikipedia.org/wiki/VBScript VBScript] (*.vbs) and [http://en.wikipedia.org/wiki/JScript JScript] (*.js) scripting languages, the implementation for JScript is only partial, so for some applications VBScript is required. Programmers not wishing to deal with VBScript may wish to create an [[#About external scripts and applications |external]] script or application using their preferred language and use a script written in VBScript (or JScript) to launch it.
*Other than tags embedded in media files, virtually all of MediaMonkey’s data is stored in a [http://en.wikipedia.org/wiki/Microsoft_Jet_Database_Engine Microsoft Jet] relational database by MediaMonkey 2.x, while MediaMonkey 3.x uses a [http://www.sqlite.org SQLite] database. It is possible to manipulate MediaMonkey’s data, while minimizing the use of MediaMonkey’s API, by using [http://en.wikipedia.org/wiki/SQL SQL]. MediaMonkey's API can be (almost, except string [[MediaMonkey_Database_structure#Additions_to_SQLite|collations]]) completely bypassed by using an interface provided by the underlying engine to access the database. MediaMonkey 2.x’s database can accessed through Jet or ODBC, or even opened directly by Microsoft Access, for example.

== Types of scripts ==

There are three major types of scripts that can be launched internally by MediaMonkey:
*'''Normal scripts''' are located in the ''Scripts'' folder and are executed according to the script's entry in the [[#Format of the Scripts.ini file|''Scripts\Scripts.ini'' file]].
*'''Auto-scripts''' are located in the ''Scripts\Auto'' folder and its OnStartup method is executed when MediaMonkey starts. If more than one script exists in the Auto folder the scripts are run in alphabetical order.
*'''Other scripts''', such as [[Search scripts]] and [[Auto-DJ scripts]] are intended for specific types of customization, but are also defined in the [[#Format of the Scripts.ini file|''Scripts\Scripts.ini'' file]].

In addition to the scripts that are launched by MediaMonkey (internal scripts), you can also work with MediaMonkey by using [[#About external scripts and applications|''external'' scripts and applications]].

== How to create a normal script ==

<ol>
<li>Create a plain text file in the ''Scripts'' folder, e.g. ''MyNormalScript.vbs''.</li>
<li>Write your VBScript script and make sure you have a procedure that can be called, e.g.
<source lang="vb">Sub CallMe

' This script will pop up a simple message box when the procedure CallMe is called.
MsgBox "CallMe was called by the action defined in the Scripts.ini file."

End Sub</source></li>
<li>Create a new entry for your script's ''CallMe'' procedure in the [[#Format of the Scripts.ini file|''Scripts.ini'' file]].</li>
</ol>

From within a MediaMonkey script, a reference to the SDB object (an instance of the [[SDBApplication]] class) is always present. By accessing its properties and methods, you can interact with many aspects of MediaMonkey. Check out the [[MediaMonkey Automation objects]] page for other MediaMonkey objects that can be created starting from the SDB object.
Another available object reference is the Script object (an instance of the [[SDBScriptControl]] class), that contains methods to control the running script's environment, usually to [[ISDBScriptControl::RegisterEvent|attach]] to events of MediaMonkey and its player and controls (see examples [[Sample Event Handlers script|1]] and [[Sample Events for User Interface script|2]]).

The script ''Scripts\MediaMonkey init.vbs'' is always executed just before any other script. It contains some constants that can be used in your own script.

A good and quite complex example is ''Scripts\Export.vbs'' (distributed with MediaMonkey) which contains code that takes care of all export features of MediaMonkey. For more examples, check out the [[Sample scripts|sample scripts page]] or, if you are already up to it, take a look at the code of some actively developed [http://www.mediamonkey.com/forum/viewforum.php?f=2 scripts on the forum] (most of them are distributed in [[Installation_Packages#Installation_Packages_structure|MM installation packages]]).

More information about scripting in general can be found at [http://msdn2.microsoft.com/en-us/library/ms950396.aspx Microsoft Scripting] (with official VBScript and JScript documentation).

== How to create an auto-script ==

<ol>
<li>Create a plain text file in the ''Scripts\Auto'' folder, e.g. ''MyAutoScript.vbs''.</li>
<li>Write your VBScript script and use the procedure ''OnStartup'' as start point for execution, e.g.
<source lang="vb">
Sub OnStartup

' This script will pop up a simple "Hello World!" message box when you start MediaMonkey.
MsgBox "Hello World!"

End Sub
</source></li>
</ol>

All VBScript, but not JScript, scripts in the ''Scripts\Auto'' folder are automatically checked during MM start-up, and the '''OnStartup''' procedure (if present) is called. Auto-scripts make it possible to add user interface enhancements such as new menu or toolbar items, new option sheets, etc.

Except that these scripts are automatically executed when MediaMonkey starts, they behave identical as the normal scripts. They also get a reference to the SDB object, and the constants defined in ''Scripts\MediaMonkey init.vbs'' are always usable.

You can choose to dynamically add an entry to the Scripts.ini from your code, so your script can be accessed from the Tools > Scripts submenu just like normal scripts. However, most auto-scripts add UI items (e.g. menu items) directly to the MediaMonkey user interface to be more tightly integrated.

== Format of the ''Scripts.ini'' file ==

<div style="float: right; margin-left: 1em; margin-bottom: 0.5em; clear: right; background-color:#F9F9F9; border:1px solid #CCCCCC; font-size:95%; padding:5px;">
<source lang="ini">
[AutoIncTrackN]
FileName=AutoIncTrackN.vbs
ProcName=AutoIncTrackNumbers
Order=1
DisplayName=Auto-&increment Track #s...
Description=Sequentially numbers Tracks
Language=VBScript
ScriptType=0
</source>
<div style="position: relative; top: -6px; left: 5px">Sample ''Scripts.ini'' entry</div>
</div>

This ''Scripts\Scripts.ini'' file is a standard .ini file where each section defines a procedure in a script. The section starts with a section identifier [SectionName], where ‘SectionName’ is a unique name of the script entry.
These are the entry's properties:
; Filename
: Path of a script file where the procedure is located, relative to the ''Scripts'' folder, e.g. ‘MyScripts.vbs’.
; ProcName
: Name of an existing procedure to be called when the script (specifiedby ‘Filename’) is executed in MM.
; ScriptType
: Defines type of the script:
:* 0 = A ''standard script'' that appears in the <code>Tools > Scripts</code> submenu.
:* 1 = An ''export script'' that can be found in the <code>File > Create Reports</code> submenu.
:* 2 = A ''track-start script'' that is activated whenever a new track is started. This script doesn’t appear in any menu, it’s simply called in the background. When this procedure is executed, a variable 'CurrentTrack' (object of the [[SDBSongData]] class) is defined, and you can use it to get information about the started track. This script type is obsolete, rather register OnPlay event. Also note, that this is the only case, when multiple instances of one script can be executed by MediaMonkey, otherwise only one instance is always executed.
:* 3 = A ''search script'' that allows custom searches to be programmed in the "Auto-tag from Web" dialog. See [[Search scripts]] for more information about this more complex script type.
:* 4 = An ''Auto-DJ script'' that can handle content added by Auto-DJ. See [[Auto-DJ scripts]] for more details.
; Order
: Defines the order of the script in its section. These numbers are sorted and scripts are listed according to the order.
; DisplayName
: The script is listed as menu item with this name.
; Description
: Message shown as tooltip when the mouse is moved over the menu item.
; Language
: The script language of the referenced script. Usually VBScript, but can be JScript too (although this is not recommended).
; Shortcut
: Specifies a shortcut that invokes the script in MM. You can use any of the strings ‘Shift+’, ‘Ctrl+’ or ‘Alt+’, singly or combined, followed a single letter or number, or the name of a special key - BkSp, Tab, Enter, Esc, Space, PgUp, PgDn, End, Home, Left, Up, Right, Down, Ins, Del.

== About external scripts and applications ==

(see also [[Scripting_Tips_&_Tricks#Interaction_with_MediaMonkey_from_outside|Interaction with MediaMonkey from outside]])

Besides supporting al large part of the Winamp [http://wiki.winamp.com/wiki/Plug-in_Developer plug-in model] and messages ([http://wiki.winamp.com/wiki/SendMessage_API 1],[http://forums.winamp.com/showthread.php?threadid=180297 2]), MediaMonkey exposes an API via the Microsoft COM model. This allows external applications to access and control MediaMonkey directly. These applications can be written in any language that can access COM objects. VBScript can be used to produce external scripts, but regular Visual Basic (or any COM-aware language) can be used as well, producing a full-fledged application.

In order to work with MediaMonkey’s objects from an external script or application, you need to create a reference to the SDB object (an instance of the [[SDBApplication]] class) yourself. For .NET-based applications, you must also add a reference to MediaMonkey's COM object "MediaMonkey Library" to your Visual Studio project, so that the compiler can find MediaMonkey and the SongsDB namespace.

If MediaMonkey is already running, creating a SDBApplication object instance will return a reference to the running instance. If MediaMonkey is not running yet, it will be started and a reference will be returned. In addition, if MediaMonkey was was not running before, it will normally shut down automatically when the external script/application exits. This can be prevented (so MediaMonkey will remain running) by setting SDB's [[ISDBApplication::ShutdownAfterDisconnect|ShutdownAfterDisconnect]] property to False.

'''Visual Basic / VBScript sample:'''
<source lang="vb">
Dim SDB : Set SDB = CreateObject("SongsDB.SDBApplication")

SDB.ShutdownAfterDisconnect = False ' in case you want to keep an opened instance open after disconnecting the SDB object
</source>
'''C# sample:'''
<source lang="csharp">
SongsDB.SDBApplication SDB = new SongsDB.SDBApplication();

SDB.ShutdownAfterDisconnect = false; // in case you want to keep an opened instance open after disconnecting the SDB object
</source>

'''C++/CLI sample:'''
<source lang="cpp">
SongsDB::SDBApplication^ SDB = gcnew SongsDB::SDBApplication();

SDB->ShutdownAfterDisconnect = false; // in case you want to keep an opened instance open after disconnecting the SDB object
</source>

'''Delphi sample:'''
<source lang="delphi">
var
SDB : Variant;
begin
SDB := CreateObject('SongsDB.SDBApplication');
SDB.ShutdownAfterDisconnect := false; // in case you want to keep an opened instance open after disconnecting the SDB object
</source>

'''PHP sample:''' (shows initialization only)
<source lang="php">
$objSDB = new COM('SongsDB.SDBApplication') or die('Cannot create MediaMonkey SDB Object');
</source>

'''Python (with PyWin32) sample:'''
<source lang="python">
try:
import win32com.client
except:
print "Install PyWin32"
# Open connection to COM object
try:
SDB = win32com.client.Dispatch("SongsDB.SDBApplication")
except:
print "Is MediaMonkey up and running?"

SDB.ShutdownAfterDisconnect = False
</source>

'''Perl sample:''' (shows initialization only)
<source lang="perl">
use Win32::OLE;
my $SDB = Win32::OLE->GetActiveObject('SongsDB.SDBApplication') || Win32::OLE->new('SongsDB.SDBApplication', '');
$SDB->ShutdownAfterDisconnect(true);
</source>

Developers that require MediaMonkey type library information (e.g. for C++/Delphi, as newer languages usually don't need this) can extract this from the MediaMonkey.exe file ([http://msdn.microsoft.com/en-us/library/ms680581(v=vs.85).aspx more information]), or can use #import on the Exe file as explained in [http://msdn.microsoft.com/en-us/library/8etzzkb6(v=vs.71).aspx this MSDN page].

== Further reading ==
* [[Scripting|Scripting main page]]
* [[.NET|.NET Tips page]]

Subscribing to events in external applications

2011-06-25T13:39:44Z

Steegy:

==Subscribing to events==
In MediaMonkey 4.0 and above (see [http://www.ventismedia.com/mantis/view.php?id=7920 bug tracking entry]), external applications can subscribe to MediaMonkey events in the same way as they register to other events.

In older versions however, subscribing to events does not work with external applications. See:
* [http://www.mediamonkey.com/forum/viewtopic.php?f=19&t=29201&p=291459 Events don't work with C#]
* [http://www.mediamonkey.com/forum/viewtopic.php?f=19&t=45676&p=297214 Trouble With Handling COM Events]
A solution is presented in:
* [http://www.mediamonkey.com/forum/viewtopic.php?f=2&t=14004&hilit=com+events MonkeyToys: VB.NET extension adding MCE remote support]

===Walkthrough===
This solution is based on making your assembly ComVisible, registering it and letting an auto-script in MediaMonkey create your application object. This can be accomplished by creating a class along the lines under.
* First build and run your program, then call the RegisterCOM() Method to register your application with COM.
''(continued after C#-code)''

<source lang="csharp">
using System.Reflection;
using System.Runtime.InteropServices;
using SongsDB;

namespace SomeNamespace {
[ComVisible(true)] // this overrides [assembly: ComVisible(false)] (is set by project options dialog) so registry don't get bloated with unneeded types
public class EventTest {
public SDBApplication SDB { get; private set; }

public static void RegisterCOM() {
RegistrationServices rs = new RegistrationServices();
rs.RegisterAssembly(Assembly.GetExecutingAssembly(),
AssemblyRegistrationFlags.SetCodeBase);
}
public static void UnRegisterCOM() {
RegistrationServices rs = new RegistrationServices();
rs.UnregisterAssembly(Assembly.GetExecutingAssembly());
}
public void Init(SDBApplication mm) {
this.SDB = mm;
this.SDB.set_Objects(Assembly.GetExecutingAssembly().GetName().Name, this);
this.SDB.OnPlay += () => { System.Windows.MessageBox.Show("OnPlay event fired!"); };
}
}
}
</source>
* Add an autoscript-to mediamonkey (ie. a file in ...\MediaMonkey\Scripts\Auto) named SomeScript.vbs that starts your application and runs the Init function. It's contents should be like this:
<source lang="vb">
Sub OnStartup
Set o = CreateObject("SomeNamespace.EventTest")
o.Init(SDB)
End Sub
</source>
* When you now start MediaMonkey it will connect to your application and event firing will work.

[[Category:.NET]]

Installation Packages (MM4)

2011-06-07T20:44:16Z

Steegy: Small additions

== Installation Packages structure ==

Additional Extensions can be easily installed in MediaMonkey using Installation Packages. Each installation package is a ZIP file with MMIP extension. When such a file is executed, it is automatically installed in MediaMonkey (see Tools|Extensions). From within the Extensions dialog, the user can update the extension to the latest version, change its options or remove it.

Inside the package can be included any files that need to be installed, but there are also some special files that can or must be included:

;Install.ini
:''Mandatory'' - this file describes the package and what to install.
;App.ico
:Optional - Icon of the package.
;Uninstall.ini
:Optional (but suggested) - describes steps on uninstall, which files to remove, etc.
;Uninstall.vbs
:Optional - is automatically preserved by installer and can be called by Uninstall.ini on uninstallation. To execute extra (un)install code, you can also reference a function in your main vbs script file.

=== Install.ini file ===

The installation file has a structure of an ini file, i.e. some sections with keys and values.

==== [Header] section ====

Each install.ini file starts with a mandantory section [Header]. It contains basic information about the product being installed, namely:

;ID
:Unique string identification of the product. It should contain only alphanumeric characters, digits or underscores.
;Title
:Product title shown to user.
;Description
:Detailed product description.
;ShowRestartPrompt
:Setting ShowRestartPrompt to True user will be requested for restart of MediaMonkey after (un)installation has completed. However, preferably use a way of (un)install the extension that does not need a restart of MediaMonkey. ''Introduced in MM 4.0.''
;VersionMajor
:Major version number.
;VersionMinor
:Minor version number.
;VersionRelease
:Release number.
;VersionBuild
:Build number. Any of these numbers can be missing, e.g. if only VersionMajor and VersionMinor are present, the version number shown to user would be 'VersionMajor.VersionMinor'.
;Type
:Type of product being installed. Either ''script'', ''skin'' or ''misc''. This is used so that MM knows more about the extension.
;UpdateURL
:URL to the [[Installation Packages#Sample_version_XML_file|version XML file]] where MM should look for the latest version of this product. If this entry is missing, MM can still try to find out whether a new version has been released, by asking MM web scripting repository using product ID above.
;ConfigurationScript
:A script file to execute. There is either a fully specified path entered here.
;ConfigurationProcedure
:A name of function to be called within the script file. If this entry is missing or empty, it's supposed that there's no need for calling a function and simple execution of the script file does whatever a developer wants to do. In this function you can e.g. create a [[ISDBUI::NewForm|new options form]] or [[ISDBUI::ShowOptions|open an existing Options Sheet]].

==== Other sections ====

After the header section, there can follow an arbitrary number of other sections specifying actions installer should do, and section names can be repeated. For example, if your package contains various files to be copied, you need one [Copy] Section for each individual file.

Sections are executed in order of appearance.<br>

==== [Copy] section ====

This section tells where individual files from the installer ZIP file should be placed. Expected keys there include:

;Src
:Source file name in the installer ZIP file.
;Tgt
:Destination file path. It can contain constants useful for placing files in common paths (the same as InnoSetup constants). Currently implemented constants:
:*{app} = MediaMonkey installation folder.
:*{sys} = Windows system folder.
:*{gpf} = Plugins folder (All Users). ''From 4.0''
:*{lpf} = Plugins folder (Current User). ''From 4.0''
:*{gsf} = Scripts folder (All Users). ''From 4.0''
:*{lsf} = Scripts folder (Current User). ''From 4.0''
:*{lcl} = Locale folder. ''From 4.0''

;Flags
:Comma separated list of flags related to this copy operation. Can be any of:
:;overwriteifnewer
::If the target file already exists, it will be overwritten only if the source file is newer. If this flag isn't specified, the target file will always be overwritten.
:;regserver
::If the target file is a DLL library then it registers specified DLL library by calling DllRegisterServer() from it.
:;onlyifdoesntexist
::If the target file already exists, it won't be overwritten by the source file. ''Introduced in MM 3.2.1.''

==== [Delete] section ====

This section is primarily for 'uninstall.ini' file. The only parameter is:

;File
:Full path of the file to be deleted.

==== [Execute] section ====

This section allows developer to execute a script and thus do any other necessary installation/uninstallation actions, for example prepare Scripts.ini content. Expected keys here are:

;File
:A script file to execute. Case sensitive. There is either a fully specified path entered here, or if there is no path information, the script is expected to be located in the installation ZIP file and is prepared to a temporary location prior its execution. For uninstaller 'uninstall.vbs' can be specified here and it would be called from its location.
;Function
:A name of function to be called within the script file. If this entry is missing or empty, it's supposed that there's no need for calling a function and simple execution of the script file does whatever a developer wants to do.

=== Uninstall.ini file ===

'Uninstall.ini' file is very similar to 'Install.ini' file, only difference is that [Header] section is optional. Other sections allow developers to properly delete installed files and remove any other traces of installation, e.g. execute a script that would delete some entries in Scripts.ini file.

== Sample Installation Package for Skins ==

Sample MMIP file can contain e.g. the following files:

*''App.ico'' icons shown in the extenions dialog
*''Install.ini'' file that tells where stuff is copied to
*''Uninstall.ini'' tells what should be deleted when uninstalling

=== Sample Install.ini file ===

Comments starting with ; should be removed <source lang="ini">
[Header]
ID=UniqueSkinName ; this is used when MM needs to see if update is available
Title=Skin Name
Description=Well a description
VersionMajor=1
VersionMinor=0
VersionRelease=0
VersionBuild=0
ShowRestartPrompt=1
Type=skin ; so MM knows what it is
UpdateURL=http://mywebserver.com/myscript1/version.xml

[Copy]
Src=skinfile.msz
Tgt={app}\skins\skinfile.msz

[Copy]
; you can copy more stuff if you want
</source>

=== Sample Uninstall.ini file ===

<source lang="ini">
[Header]
ShowRestartPrompt=0 ; optional, as the default value is False/0.

[Delete]
File={app}\skins\skinfile.msz
File={app}\skins\someicon.ico
</source>

== Sample Installation Package for Scripts ==

=== Sample content of MMIP file ===

Sample MMIP file can contain e.g. the following files:

*App.ico
*Install.ini
*Sample Option Sheets.vbs
*Uninstall.ini
*Uninstall.vbs

=== Sample Install.ini file ===

<source lang="ini">
[Header]
ID=MyScript1
Title=Sample Option Sheets
Description=Sample Option Sheets.vbs
VersionMajor=1
VersionMinor=0
VersionRelease=0
VersionBuild=0
Type=script
UpdateURL=http://mywebserver.com/myscript1/version.xml

[Copy]
Src=Sample Option Sheets.vbs
Tgt={app}\scripts\auto\Sample Option Sheets.vbs

[Copy]
Src=Sample.ico
Tgt={app}\scripts\auto\Sample.ico

[Copy]
Src=Icons\*.*
Tgt={app}\Icons\

[Execute]
File={app}\scripts\auto\Sample Option Sheets.vbs
Function=OnStartup()

; Use an install.vbs if you need to do more config, like installing menus or other configurations. Alternatively, you can also reference an install function in your main vbs script file.
[Execute]
File=Install.vbs
</source>

=== Sample install.vbs ===

<source lang="vb">

'Add entries to script.ini if you need to show up in the Scripts menu
Dim inip : inip = SDB.ScriptsPath & "Scripts.ini"
Dim inif : Set inif = SDB.Tools.IniFileByPath(inip)
If Not (inif Is Nothing) Then

inif.StringValue(scriptName,"Filename") = "PersonalTagEnhancer.vbs"
inif.StringValue(scriptName,"Procname") = "PersonalTagEnhancer"
inif.StringValue(scriptName,"Order") = "10"
inif.StringValue(scriptName,"DisplayName") = "PersonalTagEnhancer"
inif.StringValue(scriptName,"Description") = "Fixes most important tags using personal preferences"
inif.StringValue(scriptName,"Language") = "VBScript"
inif.StringValue(scriptName,"ScriptType") = "0"
inif.StringValue(scriptName,"Shortcut") = "Ctrl+i"
SDB.RefreshScriptItems
End If

' Add entries for Mediamonkey.ini
' Here you set the variables you need
' all 3 types are shown here
Dim ini: Set ini = SDB.IniFile
If Not ini.ValueExists("AdvShutdown","Enabled") Then ini.StringValue("AdvShutdown","Enabled") = "Enabled"
If Not ini.ValueExists("AdvShutdown","Timeout") Then ini.BoolValue("AdvShutdown","Timeout") = True
If Not ini.ValueExists("AdvShutdown","Action") Then ini.IntValue("AdvShutdown","Action") = 1
</source>

=== Sample Uninstall.ini file ===

<source lang="ini">
[Delete]
File={app}\scripts\auto\Sample Option Sheets.vbs
File={app}\scripts\auto\Sample.ico

[Execute]
File=Uninstall.vbs
</source>

=== Sample Uninstall.vbs file ===

<source lang="vb">
myName = "Sample Script" 'Put script name here
iniSec = "SampleScript" 'Put ini section name here

' Deletes settings from MediaMonkey.ini
MsgDeleteSettings = "Do you want to remove " & myName & " settings as well?" & vbNewLine & _
"If you click No, script settings will be left in MediaMonkey.ini"

If (Not (SDB.IniFile Is Nothing)) and (MsgBox(MsgDeleteSettings, vbYesNo) = vbYes) Then
SDB.IniFile.DeleteSection(iniSec)
End If

'Remove entries from scripts.ini
Dim inip : inip = SDB.ApplicationPath&"Scripts\Scripts.ini"
Dim inif : Set inif = SDB.Tools.IniFileByPath(inip)
If Not (inif Is Nothing) Then
inif.DeleteSection(iniSec)
SDB.RefreshScriptItems
End If

</source>

== Sample version XML file ==

<source lang="xml">
<SoftwareVersion>
<VersionMajor>5</VersionMajor>
<VersionMinor>6</VersionMinor>
<VersionRelease>0</VersionRelease>
<VersionBuild>0</VersionBuild>
<UpdateURL>http://url/to/mmip</UpdateURL>
<NewVersionDescription>Comment</NewVersionDescription>
</SoftwareVersion>
</source>

== See also ==

*[[SDBIniFile|SDBiniFile object]]

MediaMonkey Wiki:Community Portal

2009-01-27T21:42:33Z

Steegy: Fixed layout and removed my name

<div style="margin-left:auto; margin-right:auto; width:650px; font-size:125%; text-align:center;">
'''The MediaMonkey community can be reached through the [http://www.mediamonkey.com/forum/index.php MediaMonkey Forum]'''

For specific information, you can contact the following persons directly:
</div>

<div style="margin-left:auto; margin-right:auto; width:650px; font-size:95%; text-align:center;">
<div style="float:left; background-color:#F9FFF9; border:1px solid #CCCCCC; padding:15px; width:140px;">
'''Developers Team'''
<br>
<br>[[User:Jiri|Jiri]]
<br>[[User:Rusty|Rusty]]
<br>[[User:Ludek|Ludek]]
<br>[[User:Pavel|Pavel]]
<br>[[User:Peke|Peke]]
<br>[[User:Petr|Petr]]
</div>
<div style="float:left; margin-left:65px; background-color:#FFF9F9; border:1px solid #CCCCCC; padding:15px; width:140px;">
'''Scripters Team'''
<br>
<br>[[User:Bex|Bex]]
<br>[[User:Big Berny|Big_Berny]]
<br>[[User:DaledeSilva|DaledeSilva]]
<br>[[User:DiddeLeeDoo|DiddeLeeDoo]]
<br>[[User:Jitun|Jitun]]
<br>[[User:Lowlander|Lowlander]]
<br>[[User:MoDementia|MoDementia]]
<br>[[User:Octopod|Octopod]]
<br>[[User:Onkel Enno|Onkel_Enno]]
<br>[[User:Pablo|Pablo]]
<br>[[User:psyXonova|psyXonova]]
<br>[[User:Peke|Peke]]
<br>[[User:RedX|RedX]]
<br>[[User:Risser|Risser]]
<br>[[User:Teknojnky|Teknojnky]]
<br>[[User:Trixmoto|Trixmoto]]
<br>[[User:W. Kyle White|W. Kyle White]]
</div>
<div style="float:left; margin-left:65px; background-color:#F9F9FF; border:1px solid #CCCCCC; padding:15px; width:140px;">
'''Skinners Team'''
<br>
<br>[[User:Blake|Blake]]
<br>[[User:DaledeSilva|DaledeSilva]]
<br>[[User:Dread_M|Dread_M ]]
<br>[[User:Eyal|Eyal]]
<br>[[User:irshjet|irshjet]]
<br>[[User:MacMaster|MacMaster]]
<br>[[User:magicalpig|magicalpig]]
<br>[[User:MetalFrog |MetalFrog ]]
<br>[[User:Morten|Morten]]
<br>[[User:Nohitter151|NoHitter151]]
<br>[[User:Rovingcowboy|Rovingcowboy]]
<br>[[User:Tommae88|Tommae88]]
<br>[[User:Trixmoto|Trixmoto]]
</div>
</div>
<div style="width:650px;">
Someone missing? Add the name... after all this is a wiki. Also, this information is un-official.

'''Conclusion:''' Real developers have short nicknames :p
</div>

Talk:SDBUIRadioButton

2008-05-05T19:51:26Z

Steegy: Example could be improved

In the code example, wouldn't it be better to use
<source lang="vb">Dim Rad1Opt1 : Set Rad1Opt1 = SDB.UI.NewRadioButton(Pnl)

' bla bla bla

If Rad1Opt1.Checked Then Station1 = 1</source>
instead of
<source lang="vb">Dim Rad : Set Rad = SDB.UI.NewRadioButton(Pnl)

' bla bla bla

If Frm.Common.ChildControl("RadioStation1").Common.ChildControl("R01").Checked Then Station1 = 1</source>
In the example you can re-use the variable name Rad, but that isn't a real advantage. Readability, speed, ... is less good. Of course on such a scale that doesn't matter, but I think that a source like the scripting wiki (where novice to advanced scripters rely on) should give the best code as possible.
-- [[User:Steegy|Steegy]] 15:51, 5 May 2008 (EDT)

Talk:ISDBDatabase::BeginTransaction

2008-04-17T23:12:21Z

Steegy:

When/why should this be used, and even more importantly, when should it NOT be used?

What happens if you are unable to 'commit' the transaction (due to script error or crash, etc) and MM keeps running? or when the whole app crashes?

: From what I've read on the forum you should use it when you want to do different database queries at once (for better performance). If you have only one query at a time to do, you certainly don't need this. If the transaction isn't committed (e.g. due to MM crash), then the query won't be executed (I think). When the script crashes, the queries will only be committed when another action does the commit. However, in practice there will always first be a normal query, or a BeginTransaction command, which will probably void the command you started in your own script, or even result in an error. Anyone else has more info on this? -- [[User:Steegy|Steegy]] 15:28, 15 April 2008 (EDT)

:: here is an example of how I've started using transaction/commit

<code>
SDB.Database.Commit
SDB.Database.BeginTransaction
Set Iter = SDB.Database.OpenSQL(Qry)
SDB.ProcessMessages
Do While NOT Iter.EOF
' do whatever processing you need to do
Iter.Next
SDB.ProcessMessages
Loop
SDB.Database.Commit
</code>

:: I do this to avoid those sql errors 'can not open tranaction while another is in progress' or whatever it was. I commit any pending transactions, open my transaction, then commmit it after the loop. Note however, I am not really making database changes, but I think the above is sequence is even more important for when doing actual db updates.

:: I don't know if the above is the right way or not, but it seems to prevent the transaction errors and I have not seen any evidence it hurts anything. It seems to let multiple scripts and/or tag updates happen together without causing errors. --[[User:Teknojnky|Teknojnky]] 13:47, 17 April 2008 (EDT)

::: Notice though that calling SDB.ProcessMessages too much (certainly in a fast small loop) can do more harm than good. If you *really really* need to use it in a fast loop, then only do it each X iterations (e.g. by using a counter and a conditional SDB.ProcessMessages that also resets your counter).
<source lang="vb">
Dim Cnt : Cnt = 0
Do While SomethingIsTrue
' do whatever short processing you need to do
If Cnt = 300 Then
SDB.ProcessMessages
Cnt = 0
Else
Cnt = Cnt + 1
End If
Loop
</source>
That way (depending on X), SDB.ProcessMessages is only called e.g. each 500 ms instead of each 10 ms. -- [[User:Steegy|Steegy]] 19:12, 17 April 2008 (EDT)

Talk:SDBSongData

2008-04-15T19:31:30Z

Steegy:

Is there a way to programattically get all the 'user' fields or do they all have to be entered manually?

For example, populating a list box of fields... it would seem logical that there is (or should be) an internal list of modifiable fields somewhere.

something akin to

dim obj, fieldlist

set obj = sdb.selectedsonglist.item(0)

set fieldlist = obj.getuserfields 'returns list of all settable user fields

--[[User:Teknojnky|Teknojnky]] 16:07, 8 February 2008 (EST)

: They have to be entered manually. See a script like SwitchOrCopyFields or ExtractFields for an example. -- [[User:Steegy|Steegy]] 15:31, 15 April 2008 (EDT)

Talk:ISDBDatabase::BeginTransaction

2008-04-15T19:28:24Z

Steegy:

Talk:ISDBSongList::Delete

2008-04-15T19:18:26Z

Steegy:

What is the best way to use this method?

If I try to delete a track within a loop, the loop does not get the updated .count and it will go out of bounds..
<source lang="vb">
For x = 0 to sdbsonglist.count-1
if sdbsonglist.item(x).rating < 50 then
sdbsonglist.delete(x)
end if
Next
</source>
that is a realistic situation when you are checking a track list for certain criteria (ie rating etc) and you want to remove a track without creating a new secondary songlist object.
--[[User:Teknojnky|Teknojnky]] 23:03, 4 February 2008 (EST)

: The (probably easiest) trick to do that is counting backwards, from SDBSongList.Count - 1 to 0, and with step -1. See the example:
<source lang="vb">
For x = SDBSongList.Count - 1 To 0 Step -1
If SDBSongList.Item(x).Rating < 50 Then
SDBSongList.Delete(x)
End If
Next
</source>
: -- [[User:Steegy|Steegy]] 15:18, 15 April 2008 (EDT)

Talk:Main Page

2008-04-09T16:58:45Z

Steegy:

I see this page is locked, what is the best way to go abou getting a link added? I don't have anything I want to link at this time, I am just curious. -- [[User:Teknojnky|Teknojnky]] 12:52, 28 August 2007 (EDT)
: You can ask here (on the talk page) to add some link or to temporarily unprotect the page (e.g. for bigger changes). Of course keep in mind the reason why the page (as façade of the wiki) is protected. -- [[User:Steegy|Steegy]] 07:07, 31 August 2007 (EDT)

I refreshed the main page, mainly to draw a clear line between users content (which for now isn't really existing) and content for "developers" (scripters, skinners, translators, ...). If you don't really like the layout or have suggestions, feel free to post here. -- [[User:Steegy|Steegy]] 21:18, 7 September 2007 (EDT)

: I'd like to see a link to the [[MediaMonkey_Automation_objects]] page directly in either the navigation block or the toolbox block, so its easier to navigate to the objects reference list. --[[User:Teknojnky|Teknojnky]] 13:54, 6 February 2008 (EST)

I've significantly updated the Intro for New Users section. It seemed silly that the only way to find skins was to navigate under the "Developers" section for skinning. I think it may be even better to put a direct link to skins for MM 3.0 and higher on the front page, but this change can do for now as I don't want to alter the front page without an opinion from some other users. Let me know what you think about this. --[[User:Nohitter151|Steve]] 00:20, 5 March 2008 (EST)

: Really a great job you guys have been doing!
: @Teknojnky: I've been having the same issue (and I guess were not the only 2) so I added 3 reference links.
: @Steve/Nohitter151: sorry but I couldn't wait :p (I simply forgot to add a Skins link the first time and to split it from the developers skin page). -- [[User:Steegy|Steegy]] 16:34, 5 March 2008 (EST)

Not a problem Steegy, I'm very happy with the front page now! --[[User:Nohitter151|Steve]] 18:34, 5 March 2008 (EST)

: Yea page looks great, thanks Steegy! --[[User:Teknojnky|Teknojnky]] 15:35, 28 March 2008 (EDT)

Would like to start editing pages in the format below. I cannot see the categories shown in the preview so I am reluctant to save. Any ideas? --[[User:MoDementia|MoDementia]] 23:08, 4 April 2008 (EDT) OK so the categories are intact so that answers that question --[[User:MoDementia|MoDementia]] 23:10, 4 April 2008 (EDT)

: MoDementia, I have deleted the page that you specified. --[[User:Nohitter151|Steve]] 03:01, 5 April 2008 (EDT)

== wysiwyg Editor ==

This looked interesting
[http://mediawiki.fckeditor.net/ fckeditor for wikimedia]
[http://www.fckeditor.net/ base editor]

== Property Summary Template for Scripting Pages ==

I have finished the initial template that could be included with most of the scripting pages
Entering a single line (with parameters) will produce a table on the right hand side summarising the properties of the data.
[[Sandbox|Examples Here]]
--[[User:MoDementia|MoDementia]] 23:07, 6 April 2008 (EDT)

== Template Information as Special Pages Links ==

Is it possible to get some Template: information in to this page [[Special:Specialpages]]

EDIT Can you use the namespace Template or do they need to have the category Template?--[[User:MoDementia|MoDementia]] 02:46, 9 April 2008 (EDT)

E.g.<br>
Templates (list of all templates)<br>
Unused Templates<br>
Used Templates (with counts and links)<br>

I can't search for them using Prefix Index either :(

EDIT I think these need to be in a category for use with special pages?<br>
I have added Category:Template to the 2 I have made but there are quite a few around that could be useful if people could fimd them --[[User:MoDementia|MoDementia]] 01:32, 9 April 2008 (EDT)

I found them I think [[http://www.mediamonkey.com/wiki/index.php?title=Special%3APrefixindex&from=&namespace=10]]
--[[User:MoDementia|MoDementia]] 02:46, 9 April 2008 (EDT)

: Please give as some time to answer ;). Templates (as you found out) can be found under Toolbox > Special Pages > All Pages > namespace Template > Go

Sandbox

2008-04-05T13:50:33Z

Steegy:

<div style="float: right; margin-left: 1em; margin-bottom: 0.5em; clear: right; background-color:#F9F9F9; border:1px solid #CCCCCC; font-size:95%; padding:5px;">
<div style="text-align: center;">'''Song title'''</div>
<div><table>
<tr style="background-color: #ddd;"><td>'''Scripting value'''</td><td>[[SDBSongData|Object SongData]] > [[ISDBSongData::Title|Title]]</td></tr>
<tr style="background-color: #f4f4f4;"><td>      ''Value type''</td><td>''String''</td></tr>
<tr style="background-color: #ddd;"><td>'''Database field'''</td><td>[[Songs_table|Table Songs]] > [[Songs_table#SongTitle|SongTitle]]</td></tr>
<tr style="background-color: #f4f4f4;"><td>      ''Field type''</td><td>''String''</td></tr>
<tr style="background-color: #ddd;"><td>'''Tracklist column'''</td><td>"Title"</td></tr>
</table></div>
</div>
{{MethodDeclaration|SDBSongData|ISDBSongData|Property Get/Let Title As String}}

===Property description===

<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>

This page is purely for testing

This [http://diberri.dyndns.org/wikipedia/html2wiki/index.html html2wiki converter] is very useful.

[[Image:WMP11_m.jpg|center|thumb|150px|Thumb test]]

==[[Main Page]]==
===[[Main Page]]===
====[[Main Page]]====
=====[[Main Page]]=====
<big>[[Main Page]]</big>

{{MethodParameters}}

<source lang="csharp">
// Hello World in Microsoft C# ("C-Sharp").

using System;

class HelloWorld
{
public static int Main(String[] args)
{
Console.WriteLine("Hello, World!");
return 0;
}
}
</source>

<source lang="vb">
' A simple script that swaps the content of Title and Artist fields of selected tracks

Sub SwapArtistTitle
' Define variables
Dim list, itm, i, tmp

' Get list of selected tracks from MediaMonkey
Set list = SDB.CurrentSongList

' Process all selected tracks
For i=0 To list.count-1
Set itm = list.Item(i)

' Swap the fields
tmp = itm.Title
itm.Title = itm.ArtistName
If itm.AlbumArtistName = itm.ArtistName Then ' Modify Album Artist as well if is the same as Artist
itm.AlbumArtistName = tmp
End If
itm.ArtistName = tmp
Next

' Write all back to DB and update tags
list.UpdateAll
End Sub
</source>

__NOTOC__

Sandbox

2008-04-05T13:45:50Z

Steegy:

This page is purely for testing

<div style="float: right; margin-left: 1em; margin-bottom: 0.5em; clear: right; background-color:#F9F9F9; border:1px solid #CCCCCC; font-size:95%; padding:5px;">
<div style="text-align: center;">'''Song title'''</div>
<div><table>
<tr style="background-color: #ddd;"><td>'''Scripting value'''</td><td>[[SDBSongData|Object SongData]] > [[ISDBSongData::Title|Title]]</td></tr>
<tr style="background-color: #f4f4f4;"><td>      ''Value type''</td><td>''String''</td></tr>
<tr style="background-color: #ddd;"><td>'''Database field'''</td><td>[[Songs_table|Table Songs]] > [[Songs_table#SongTitle|SongTitle]]</td></tr>
<tr style="background-color: #f4f4f4;"><td>      ''Field type''</td><td>''String''</td></tr>
<tr style="background-color: #ddd;"><td>'''Tracklist column'''</td><td>"Title"</td></tr>
</table></div>
</div>

This [http://diberri.dyndns.org/wikipedia/html2wiki/index.html html2wiki converter] is very useful.

[[Image:WMP11_m.jpg|center|thumb|150px|Thumb test]]

==[[Main Page]]==
===[[Main Page]]===
====[[Main Page]]====
=====[[Main Page]]=====
<big>[[Main Page]]</big>

{{MethodParameters}}

<source lang="csharp">
// Hello World in Microsoft C# ("C-Sharp").

using System;

class HelloWorld
{
public static int Main(String[] args)
{
Console.WriteLine("Hello, World!");
return 0;
}
}
</source>

<source lang="vb">
' A simple script that swaps the content of Title and Artist fields of selected tracks

Sub SwapArtistTitle
' Define variables
Dim list, itm, i, tmp

' Get list of selected tracks from MediaMonkey
Set list = SDB.CurrentSongList

' Process all selected tracks
For i=0 To list.count-1
Set itm = list.Item(i)

' Swap the fields
tmp = itm.Title
itm.Title = itm.ArtistName
If itm.AlbumArtistName = itm.ArtistName Then ' Modify Album Artist as well if is the same as Artist
itm.AlbumArtistName = tmp
End If
itm.ArtistName = tmp
Next

' Write all back to DB and update tags
list.UpdateAll
End Sub
</source>

Sandbox

2008-04-05T13:41:45Z

Steegy:

This page is purely for testing

<div style="float: right; margin-left: 1em; margin-bottom: 0.5em; clear: right; background-color:#F9F9F9; border:1px solid #CCCCCC; font-size:95%; padding:5px;">
<div style="text-align: center;">'''Song title'''</div>
<div><table>
<tr style="background-color: #ddd;"><td>'''Scripting value'''</td><td>[[SDBSongData|Object SongData]] > [[ISDBSongData::Title|Title]]</td></tr>
<tr><td>      ''Value type''</td><td>''String''</td></tr>
<tr style="background-color: #ddd;"><td>'''Database field'''</td><td>[[Songs_table|Table Songs]] > [[Songs_table#SongTitle|SongTitle]]</td></tr>
<tr><td>      ''Field type''</td><td>''String''</td></tr>
<tr style="background-color: #ddd;"><td>'''Tracklist column'''</td><td>"Title"</td></tr>
</table></div>
</div>

This [http://diberri.dyndns.org/wikipedia/html2wiki/index.html html2wiki converter] is very useful.

[[Image:WMP11_m.jpg|center|thumb|150px|Thumb test]]

==[[Main Page]]==
===[[Main Page]]===
====[[Main Page]]====
=====[[Main Page]]=====
<big>[[Main Page]]</big>

{{MethodParameters}}

<source lang="csharp">
// Hello World in Microsoft C# ("C-Sharp").

using System;

class HelloWorld
{
public static int Main(String[] args)
{
Console.WriteLine("Hello, World!");
return 0;
}
}
</source>

<source lang="vb">
' A simple script that swaps the content of Title and Artist fields of selected tracks

Sub SwapArtistTitle
' Define variables
Dim list, itm, i, tmp

' Get list of selected tracks from MediaMonkey
Set list = SDB.CurrentSongList

' Process all selected tracks
For i=0 To list.count-1
Set itm = list.Item(i)

' Swap the fields
tmp = itm.Title
itm.Title = itm.ArtistName
If itm.AlbumArtistName = itm.ArtistName Then ' Modify Album Artist as well if is the same as Artist
itm.AlbumArtistName = tmp
End If
itm.ArtistName = tmp
Next

' Write all back to DB and update tags
list.UpdateAll
End Sub
</source>

ISDBSongData::Custom5

2008-04-05T11:59:58Z

Steegy:

{{MethodDeclaration|SDBSongData|ISDBSongData|Property Get/Let Custom5 As String}}

===Property description===

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBSongData|{{PAGENAME}}]]
[[Category:Interface ISDBSongData|{{PAGENAME}}]]

ISDBSongData::Custom4

2008-04-05T11:59:39Z

Steegy:

{{MethodDeclaration|SDBSongData|ISDBSongData|Property Get/Let Custom4 As String}}

===Property description===

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBSongData|{{PAGENAME}}]]
[[Category:Interface ISDBSongData|{{PAGENAME}}]]

Automation Objects (MM4)

2008-03-23T00:23:26Z

Steegy: Added SDBUIMaskEdit

*[[SDBAlbum]]
*[[SDBAlbumArtItem]]
*[[SDBAlbumArtList]]
*[[SDBAlbums]]
*'''''[[SDBApplication]]'''''
*[[SDBArtist]]
*[[SDBArtists]]
*[[SDBCommonDialog]]
*[[SDBDatabase]]
*[[SDBDBIterator]]
*[[SDBDevice]]
*[[SDBDeviceList]]
*[[SDBDropTarget]]
*[[SDBDropTargetLast]]
*[[SDBDropTargetNext]]
*[[SDBDropTargetRip]]
*[[SDBFileSystem]]
*[[SDBHWEvents]]
*[[SDBImage]]
*[[SDBIniFile]]
*[[SDBMedia]]
*[[SDBMenuItem]]
*[[SDBPlayer]]
*[[SDBPlaylist]]
*[[SDBPlaylists]]
*[[SDBProgress]]
*[[SDBRegistry]]
*'''''[[SDBScriptControl]]'''''
*[[SDBSongData]]
*[[SDBSongIterator]]
*[[SDBSongList]]
*[[SDBStringList]]
*[[SDBTextFile]]
*[[SDBTimer]]
*[[SDBTools]]
*[[SDBTrackSynchStatus]]
*[[SDBTracksWindow]]
*[[SDBTree]]
*[[SDBTreeNode]]
*[[SDBUI]]
*[[SDBUIActiveX]]
*[[SDBUIButton]]
*[[SDBUICheckBox]]
*[[SDBUICommon]]
*[[SDBUIDockablePanel]]
*[[SDBUIDropDown]]
*[[SDBUIEdit]]
*[[SDBUIForm]]
*[[SDBUIGroupBox]]
*[[SDBUILabel]]
*[[SDBUIMaskEdit]]
*[[SDBUIMultiLineEdit]]
*[[SDBUIPanel]]
*[[SDBUIRadioButton]]
*[[SDBUISpinEdit]]
*[[SDBUITrackBar]]
*[[SDBUITranspPanel]]
*[[SDBWebSearch]]

ISDBTree::CurrentNode

2008-03-12T19:17:06Z

Steegy:

{{MethodDeclaration|SDBTree|ISDBTree|Property Get/Let CurrentNode As ISDBTreeNode}}

===Property description===

Gets or sets the current tree node.

To avoid object errors during runtime, you should always verify the object is valid before using or referencing it.

<source lang="vb">
Function Foo
If Not (SDB.MainTree.CurrentNode Is Nothing) Then
'do whatever here
End If
End Function
</source>

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBTree|{{PAGENAME}}]]
[[Category:Interface ISDBTree|{{PAGENAME}}]]

ISDBApplication::UI

2008-03-05T22:22:21Z

Steegy:

{{MethodDeclaration|SDBApplication|ISDBApplication|Property Get UI As [[SDBUI]]}}

===Property description===

Returns [[SDBUI]] object that can be used to create and manipulate User Interface elements (windows, buttons, ...).

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBApplication|{{PAGENAME}}]]
[[Category:Interface ISDBApplication|{{PAGENAME}}]]

ISDBApplication::CurrentSongList

2008-03-05T22:21:20Z

Steegy:

{{MethodDeclaration|SDBApplication|ISDBApplication|Property Get CurrentSongList As [[SDBSongList]]}}

===Property description===

Returns [[SDBSongList]] object that contains tracks depending on the current context. E.g. if a tree node is in focus then all its tracks are returned, if the main track list (or the now playing list) is in focus then only its selected tracks are returned.

=== Related Topics ===
*[[ISDBApplication::AllVisibleSongList]]
*[[ISDBApplication::SelectedSongList]]

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBApplication|{{PAGENAME}}]]
[[Category:Interface ISDBApplication|{{PAGENAME}}]]

ISDBApplication::CreateTimer

2008-03-05T22:20:59Z

Steegy:

{{MethodDeclaration|SDBApplication|ISDBApplication|Function CreateTimer(Interval As Long) As [[SDBTimer]]}}

===Parameters===

{{MethodParameters
|Interval |Long |Interval between calls (in milliseconds).}}

===Method description===

Creates new timer.

===Example code===
<source lang="vb">
Set Tmr = SDB.CreateTimer( 10000) ' Pop up a message in 10 seconds
Script.RegisterEvent Tmr, "OnTimer", "TestTimer"

Sub TestTimer( Timer)
SDB.MessageBox "10 seconds elapsed!", mtInformation, Array(mbOk)
Script.UnregisterEvents Timer ' Terminate usage of this timer
End Sub
</source>

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBApplication|{{PAGENAME}}]]
[[Category:Interface ISDBApplication|{{PAGENAME}}]]

ISDBUI::Menu TrayIcon

2008-03-05T22:19:54Z

Steegy:

{{MethodDeclaration|SDBUI|ISDBUI|Property Get Menu_TrayIcon As [[SDBMenuItem]]}}

===Property description===

Menu item of the tray icon menu. It can be used to place menu items to tray icon menu.

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBUI|{{PAGENAME}}]]
[[Category:Interface ISDBUI|{{PAGENAME}}]]

ISDBUI::Menu Tools

2008-03-05T22:19:38Z

Steegy:

{{MethodDeclaration|SDBUI|ISDBUI|Property Get Menu_Tools As [[SDBMenuItem]]}}

===Property description===

Menu item of the main 'Tools' menu.

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBUI|{{PAGENAME}}]]
[[Category:Interface ISDBUI|{{PAGENAME}}]]

ISDBUI::Menu TbStandard

2008-03-05T22:19:25Z

Steegy:

{{MethodDeclaration|SDBUI|ISDBUI|Property Get Menu_TbStandard As [[SDBMenuItem]]}}

===Property description===

Standard toolbar (the main one).

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBUI|{{PAGENAME}}]]
[[Category:Interface ISDBUI|{{PAGENAME}}]]

ISDBUI::Menu TbSearch

2008-03-05T22:19:11Z

Steegy:

{{MethodDeclaration|SDBUI|ISDBUI|Property Get Menu_TbSearch As [[SDBMenuItem]]}}

===Property description===

Search toolbar.

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBUI|{{PAGENAME}}]]
[[Category:Interface ISDBUI|{{PAGENAME}}]]

ISDBUI::Menu TbNPMain

2008-03-05T22:18:57Z

Steegy:

{{MethodDeclaration|SDBUI|ISDBUI|Property Get Menu_TbNPMain As [[SDBMenuItem]]}}

===Property description===

The menu of Now Playing window.

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBUI|{{PAGENAME}}]]
[[Category:Interface ISDBUI|{{PAGENAME}}]]

ISDBUI::Menu TbNPList

2008-03-05T22:18:44Z

Steegy:

{{MethodDeclaration|SDBUI|ISDBUI|Property Get Menu_TbNPList As [[SDBMenuItem]]}}

===Property description===

List item of the menu in Now Playing window.

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBUI|{{PAGENAME}}]]
[[Category:Interface ISDBUI|{{PAGENAME}}]]

ISDBUI::Menu TbNPEdit

2008-03-05T22:18:31Z

Steegy:

{{MethodDeclaration|SDBUI|ISDBUI|Property Get Menu_TbNPEdit As [[SDBMenuItem]]}}

===Property description===

Edit item of the menu in Now Playing window.

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBUI|{{PAGENAME}}]]
[[Category:Interface ISDBUI|{{PAGENAME}}]]

ISDBUI::Menu TbNavigation

2008-03-05T22:18:18Z

Steegy:

{{MethodDeclaration|SDBUI|ISDBUI|Property Get Menu_TbNavigation As [[SDBMenuItem]]}}

===Property description===

Navigation toolbar.

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBUI|{{PAGENAME}}]]
[[Category:Interface ISDBUI|{{PAGENAME}}]]

ISDBUI::Menu TbEdit

2008-03-05T22:18:04Z

Steegy:

{{MethodDeclaration|SDBUI|ISDBUI|Property Get Menu_TbEdit As [[SDBMenuItem]]}}

===Property description===

Edit toolbar.

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBUI|{{PAGENAME}}]]
[[Category:Interface ISDBUI|{{PAGENAME}}]]

ISDBUI::Menu TbCategorize

2008-03-05T22:17:49Z

Steegy:

{{MethodDeclaration|SDBUI|ISDBUI|Property Get Menu_TbCategorize As [[SDBMenuItem]]}}

===Property description===

Categorize toolbar.

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBUI|{{PAGENAME}}]]
[[Category:Interface ISDBUI|{{PAGENAME}}]]

ISDBUI::Menu TbAdvanced

2008-03-05T22:17:37Z

Steegy:

{{MethodDeclaration|SDBUI|ISDBUI|Property Get Menu_TbAdvanced As [[SDBMenuItem]]}}

===Property description===

Advanced toolbar.

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBUI|{{PAGENAME}}]]
[[Category:Interface ISDBUI|{{PAGENAME}}]]

ISDBUI::Menu Pop Tree

2008-03-05T22:17:13Z

Steegy:

{{MethodDeclaration|SDBUI|ISDBUI|Property Get Menu_Pop_Tree As [[SDBMenuItem]]}}

===Property description===

Pop-up menu of the main tree.

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBUI|{{PAGENAME}}]]
[[Category:Interface ISDBUI|{{PAGENAME}}]]

ISDBUI::Menu Pop TrackList SendTo

2008-03-05T22:17:00Z

Steegy:

{{MethodDeclaration|SDBUI|ISDBUI|Property Get Menu_Pop_TrackList_SendTo As [[SDBMenuItem]]}}

===Property description===

'Send to....' item of the pop-up menu in track list window.

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBUI|{{PAGENAME}}]]
[[Category:Interface ISDBUI|{{PAGENAME}}]]

ISDBUI::Menu Pop TrackList MoreFrom

2008-03-05T22:16:46Z

Steegy:

{{MethodDeclaration|SDBUI|ISDBUI|Property Get Menu_Pop_TrackList_MoreFrom As [[SDBMenuItem]]}}

===Property description===

'More from....' item of the pop-up menu in track list window.

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBUI|{{PAGENAME}}]]
[[Category:Interface ISDBUI|{{PAGENAME}}]]

ISDBUI::Menu Pop TrackList

2008-03-05T22:16:27Z

Steegy:

{{MethodDeclaration|SDBUI|ISDBUI|Property Get Menu_Pop_TrackList As [[SDBMenuItem]]}}

===Property description===

Pop-up menu of the track list window.

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBUI|{{PAGENAME}}]]
[[Category:Interface ISDBUI|{{PAGENAME}}]]

ISDBUI::Menu Pop NP SendTo

2008-03-05T22:16:15Z

Steegy:

{{MethodDeclaration|SDBUI|ISDBUI|Property Get Menu_Pop_NP_SendTo As [[SDBMenuItem]]}}

===Property description===

'Send to....' item of the pop-up menu in Now Playing window.

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBUI|{{PAGENAME}}]]
[[Category:Interface ISDBUI|{{PAGENAME}}]]

ISDBUI::Menu Pop NP MoreFrom

2008-03-05T22:16:02Z

Steegy:

{{MethodDeclaration|SDBUI|ISDBUI|Property Get Menu_Pop_NP_MoreFrom As [[SDBMenuItem]]}}

===Property description===

'More from....' item of the pop-up menu in Now Playing window.

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBUI|{{PAGENAME}}]]
[[Category:Interface ISDBUI|{{PAGENAME}}]]

ISDBUI::Menu Pop NP MainWindow

2008-03-05T22:15:48Z

Steegy:

{{MethodDeclaration|SDBUI|ISDBUI|Property Get Menu_Pop_NP_MainWindow As [[SDBMenuItem]]}}

===Property description===

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBUI|{{PAGENAME}}]]
[[Category:Interface ISDBUI|{{PAGENAME}}]]

ISDBUI::Menu Pop NP

2008-03-05T22:15:33Z

Steegy:

{{MethodDeclaration|SDBUI|ISDBUI|Property Get Menu_Pop_NP As [[SDBMenuItem]]}}

===Property description===

The pop-up menu in Now Playing window.

[[Category:Scripting|{{PAGENAME}}]]
[[Category:Automation objects|{{PAGENAME}}]]
[[Category:CoClass SDBUI|{{PAGENAME}}]]
[[Category:Interface ISDBUI|{{PAGENAME}}]]