Docs
Ask or search…
K
Links
🔢

Variables

The following list of variables can be used inside any Droptop Community App to relay the specified information:

#NumberOfItems#

The NumberOfItems variable will determine the how many items will be present in the menu. These can either be individual items that launch a shortcut or perform some function, or they can be folders that open a submenu containing additional options. Each menu can contain up to a maximum of 10 items.

#ItemText1# - #ItemText10#

The text that will appear for each item. These variables are labelled 1 through 10 in order as the items appear in the menu. (eg. To edit the text of the 5th item in the menu, edit the value for ItemText5)

#ItemIsFolder1# - #ItemIsFolder10#

Set the value of these variables to 1 to designate that item as a folder that will open a separate submenu. Set the value to 0 to designate that item as something that performs an action when clicked.

#ItemAction1# - #ItemAction10#

Here you enter the bangs (actions) that will take place when the item is clicked. ItemIsFolder must equal 0 for these actions to occur.

#NumberOfBoxes#

The NumberOfBoxes can be any number between 0 and 5. Boxes can be used to display additonal information, shortcuts, or separate functions from the rest of the app. Most apps will not require the use of Boxes, in which case, set the value of this variable to 0.

#BoxHeight1# - #BoxHeight5#

Select the height in pixels for each respective box. The height of the box will automatically scale up or down depending on the size setting in Droptop.

#NumberOfDividers#

The value of this variable will add additional height to the dropdown menu to accommodate the option of having dividers between items. More info on dividers can be found in the "Dividers" section of this tutorial.

#MyAppID#

Can be used to return the folder name for your app (Eg. "Sample_App-Cariboudjan") You can also use [##MyAppID#] to return the app's current slot number (1 to 10).
This variable cannot be used in BackgroundProcesses.inc or BarModifier.

#MyAppName#

Can be used to return the formatted name of your app (Eg. "Sample App")
This variable cannot be used in BackgroundProcesses.inc or BarModifier.

#MyAppAuthor#

Can be used to return the formatted name of the author (Eg. "Cariboudjan")
This variable cannot be used in BackgroundProcesses.inc or BarModifier.

#MyVariablesLoc#

Can be used to return the location of the Variables.inc file (Eg. "C:\Users\%USERNAME%\Documents\Rainmeter\Skins\Droptop Community Apps\Apps\Sample_App-Cariboudjan\Variables\Variables.inc")
This variable cannot be used in BackgroundProcesses.inc or BarModifier.

[#CustomAppInstallDate[##MyAppID#]]

Returns the date the app was installed on the user's PC in YY.MMDD format.
This variable cannot be used in BackgroundProcesses.inc or BarModifier.

#DroptopSize#

Returns the current scale multiplier of Droptop, from 0.8 (80%) to 2.5 (250%). More information on #DroptopSize# can be found in the "How to Scale w/ Examples" section of this tutorial.
Will return the current width of the app or submenu. You can also use [#CURRENTCONFIGWIDTH]. This variable does not need to be scaled with #DroptopSize#.
Add DropdownMenuWidth=(999*#DroptopSize#) to the [Variables] section of any of your menus to set any specific width. By default, your app's width is determined by the current theme the user has enabled.
Will return the height of a single item in a dropdown or submenu. This variable does not need to be scaled with #DroptopSize#.
By default, your app's item height is determined by the current theme the user has enabled.

[#PlayerTitle[#PlayerTypeNum]]

Returns the title of any song or media playing, if any.

[#PlayerArtist[#PlayerTypeNum]]

Returns the artist of any song or media playing, if any.