Skip to content

Command Reference

mctinker edited this page Aug 30, 2026 · 4 revisions

MapTasker Command Reference

Every command, option and pulldown in the MapTasker user interface: 271 entries (224 of them commands) across 12 windows.

Generated from the MapTasker 13.0.3 source on 2026-08-30 by build_command_wiki.py. Do not edit this page by hand -- rerun that program instead.

How to use this page

  • Searching: press Ctrl/ + F and type any part of a command's name. Every command appears twice -- once in the alphabetical index, once in full under its window -- so a search always lands on something.
  • Reading a path: commands are written as the clicks that get you there. Edit Profile > Save To Android > Import Into Tasker means click Edit Profile, then Save To Android in the dialog that opens, then Import Into Tasker.
  • Kinds: Command is a button, Menu item sits in a pulldown menu, Option is a checkbox or switch, Pulldown is a list to choose from, and Tab switches panels.
  • Descriptions are the text MapTasker shows when you hover over the command. Where a command has no hover text, the description comes from MapTasker's own Help, or from the note written beside it in the source -- which is said, where that is so.

Contents

Command Index (A-Z)

Command Kind Where it is What it does
Actions Option Scene Preview Window Show what each component does when tapped, and what it writes to.
Add Command Add Scene Adds inside the selected component if it can hold children, otherwise directly after it.
Add Command Item Layout Designer Adds an element on top of the stack, in the middle of the Scene.
Add Command Edit Scene Adds inside the selected component if it can hold children, otherwise directly after it.
Add it where missing Option Map / Diagram / Tree View Toolbar > Find/Replace Tasker leaves out an argument nobody ever set, so this is what makes "give every Flash a Timeout" reach the Flashes that have none.
Add Profile Command Main Window Create a new object and add it to the loaded XML.
Add Project Command Main Window Create a new object and add it to the loaded XML.
Add Scene Command Main Window Create a new object and add it to the loaded XML.
Add Task Command Add Profile Create a new object and add it to the loaded XML.
Add Task Command Main Window Create a new object and add it to the loaded XML.
Add Task Command Edit Profile Create a new object and add it to the loaded XML.
AI Model Pulldown Main Window Select the model belonging to the AI you wish to use.
Analyze Tab Main Window Run the analysis for a Project, Profile, Task or Scene against an Ai model.
App not listed? Command Add Profile > Add Task > Pick Fetch the full list of installed applications from your Android device.
App not listed? Command Add Profile > Pick Fetch the full list of installed applications from your Android device.
App not listed? Command Add Task > Pick Fetch the full list of installed applications from your Android device.
App not listed? Command Edit Profile > Add Task > Pick Fetch the full list of installed applications from your Android device.
App not listed? Command Edit Profile > Pick Fetch the full list of installed applications from your Android device.
App not listed? Command Edit Task > Pick Fetch the full list of installed applications from your Android device.
Bounds Option Scene Preview Window Outline every component and name it, the way the designer's tree names it.
Cancel Command Add Scene > Add Closes this dialog and keeps nothing it was holding.
Cancel Command Item Layout Designer > Add Closes this dialog and keeps nothing it was holding.
Cancel Command Add Profile > Add Task Closes this dialog and keeps nothing it was holding.
Cancel Command Add Profile > Add Task > Pick > App not listed? Closes this dialog and keeps nothing it was holding.
Cancel Command Add Profile > Add Task > Pick Closes this dialog and keeps nothing it was holding.
Cancel Command Add Profile > Add Task > Save To Android Closes this dialog and keeps nothing it was holding.
Cancel Command Add Profile Closes this dialog and keeps nothing it was holding.
Cancel Command Add Profile > Pick > App not listed? Closes this dialog and keeps nothing it was holding.
Cancel Command Add Profile > Pick Closes this dialog and keeps nothing it was holding.
Cancel Command Add Profile > Save To Android Closes this dialog and keeps nothing it was holding.
Cancel Command Add Project Closes this dialog and keeps nothing it was holding.
Cancel Command Add Scene Closes this dialog and keeps nothing it was holding.
Cancel Command Add Task Closes this dialog and keeps nothing it was holding.
Cancel Command Add Task > Pick > App not listed? Closes this dialog and keeps nothing it was holding.
Cancel Command Add Task > Pick Closes this dialog and keeps nothing it was holding.
Cancel Command Add Task > Save To Android Closes this dialog and keeps nothing it was holding.
Cancel Command Main Window Closes this dialog and keeps nothing it was holding.
Cancel Command AI API Key Entry Closes this dialog and keeps nothing it was holding.
Cancel Command Action Condition Closes this dialog and keeps nothing it was holding.
Cancel Command Add Scene Closes this dialog and keeps nothing it was holding.
Cancel Command Choose An If Variant Closes this dialog and keeps nothing it was holding.
Cancel Command Delete Project Closes this dialog and keeps nothing it was holding.
Cancel Command Delete Scene Closes this dialog and keeps nothing it was holding.
Cancel Command Overwrite Confirmation Closes this dialog and keeps nothing it was holding.
Cancel Command Change Prompt Closes this dialog and keeps nothing it was holding.
Cancel Command Compare Files Closes this dialog and keeps nothing it was holding.
Cancel Command Edit Profile > Add Task Closes this dialog and keeps nothing it was holding.
Cancel Command Edit Profile > Add Task > Pick > App not listed? Closes this dialog and keeps nothing it was holding.
Cancel Command Edit Profile > Add Task > Pick Closes this dialog and keeps nothing it was holding.
Cancel Command Edit Profile > Add Task > Save To Android Closes this dialog and keeps nothing it was holding.
Cancel Command Edit Profile Closes this dialog and keeps nothing it was holding.
Cancel Command Edit Profile > Delete Profile Closes this dialog and keeps nothing it was holding.
Cancel Command Edit Profile > Pick > App not listed? Closes this dialog and keeps nothing it was holding.
Cancel Command Edit Profile > Pick Closes this dialog and keeps nothing it was holding.
Cancel Command Edit Profile > Rename Closes this dialog and keeps nothing it was holding.
Cancel Command Edit Profile > Save To Android Closes this dialog and keeps nothing it was holding.
Cancel Command Edit Project Closes this dialog and keeps nothing it was holding.
Cancel Command Edit Project > Rename Closes this dialog and keeps nothing it was holding.
Cancel Command Edit Project > Save To Android Closes this dialog and keeps nothing it was holding.
Cancel Command Edit Scene > Add Closes this dialog and keeps nothing it was holding.
Cancel Command Edit Scene Closes without saving, and puts this Scene back exactly as it was when this dialog opened -- including anything moved or resized in the Preview.
Cancel Command Edit Scene > Pick Closes this dialog and keeps nothing it was holding.
Cancel Command Edit Scene > Rename Closes this dialog and keeps nothing it was holding.
Cancel Command Edit Scene > Save To Android Closes this dialog and keeps nothing it was holding.
Cancel Command Edit Task Closes this dialog and keeps nothing it was holding.
Cancel Command Edit Task > Delete Task Closes this dialog and keeps nothing it was holding.
Cancel Command Edit Task > Pick > App not listed? Closes this dialog and keeps nothing it was holding.
Cancel Command Edit Task > Pick Closes this dialog and keeps nothing it was holding.
Cancel Command Edit Task > Rename Closes this dialog and keeps nothing it was holding.
Cancel Command Edit Task > Save To Android Closes this dialog and keeps nothing it was holding.
Cancel Command Get Local XML File Closes this dialog and keeps nothing it was holding.
Cancel Command Add Scene > Pick Closes this dialog and keeps nothing it was holding.
Cancel Command Add Scene > Rename Closes this dialog and keeps nothing it was holding.
Cancel Command Item Layout Designer > Rename Closes this dialog and keeps nothing it was holding.
Cancel Entry Command Get XML from Android Device Back out of the Android fetch process.
Cancel Entry Command Get XML from Android Device > List XML Files Back out of the Android fetch process.
Change Prompt Command Main Window Modify the prompt sent to the AI model.
Clear Command Main Window Clear the Map/Diagram/Tree view data currently held and displayed.
Clear Command AI API Key Entry Clear the Map/Diagram/Tree view data currently held and displayed.
Clear Command Map / Diagram / Tree View Toolbar Clear the Map/Diagram/Tree view data currently held and displayed.
Close Command Add Scene Closes this window without changing anything.
Close Command Item Layout Designer Stop firing anything on this event.
Close Command Edit History Closes this window without changing anything.
Close Command Edit Scene Closes this window without changing anything.
Close Command Edit Scene > Picker Closes this window without changing anything.
Close Command Edit Scene > Show When Closes this window without changing anything.
Close Command Edit Scene > Variable Closes this window without changing anything.
Close Command Map / Diagram / Tree View Toolbar > Find/Replace Closes this window without changing anything.
Close Command Get XML from Android Device > List Helper Tasks Closes this window without changing anything.
Close Command Add Scene > Picker Closes this window without changing anything.
Close Command Add Scene > Show When Closes this window without changing anything.
Close Command Add Scene > Variable Closes this window without changing anything.
Close Tabs On Exit Option Main Window When enabled, clicking 'Exit' also closes the main MapTasker window and any Map/Diagram windows/tabs it opened.
Collapse Command Map / Diagram / Tree View Toolbar Collapse every Project down to its title bar.
Colors Tab Main Window select colors for various elements of the display.
Compare Files Command Main Window Compare another XML file against the loaded one: what was added, removed, renamed and changed.
Dark Mode Option Main Window Switch the GUI between light and dark appearance.
Debug Tab Main Window Display Runtime Settings option and turn on Debug mode.
Delete Command Add Scene Remove the object being edited from the loaded XML.
Delete Command Item Layout Designer Remove the object being edited from the loaded XML.
Delete Command Edit Scene Remove the object being edited from the loaded XML.
Delete Command Edit Task Remove the object being edited from the loaded XML.
Delete Profile Command Edit Profile Deletes only this Profile.
Delete Task Command Edit Task Deletes this Task and every reference to it: it is removed from the Tasks of every Project that owns it, and from any Profile that runs it as its Entry/Exit Task.
Detail Level Pulldown Main Window 0 = least detail, 5 = most detail.
Display Conditions Option Main Window Enables the display of Profile Conditions (e.g.
Display Directory Option Main Window Enables the display of the Project/Profile/Task/Scene Directory in the output.
Display Help Command Main Window Display this help text.
Display Prettier Output Option Main Window Enables the display of aligned text in the output.
Display Tasker Preferences Option Main Window Enables the display a breakdown of the Tasker system Preferences in the output.
Display TaskerNet Info Option Main Window Enables the display of TaskerNet Descriptions in the output.
Done Command Item Layout Designer Closes this dialog, keeping what was edited in it.
Duplicate Command Add Scene Make a copy of the selected Scene element.
Duplicate Command Item Layout Designer Make a copy of the selected Scene element.
Duplicate Command Edit Scene Make a copy of the selected Scene element.
Edit History Command Main Window List every change made to the loaded XML this session, newest first.
Edit Profile Command Main Window Modify the object currently selected in the pulldowns above.
Edit Project Command Main Window Modify the object currently selected in the pulldowns above.
Edit Scene Command Main Window Modify the object currently selected in the pulldowns above.
Edit Task Command Main Window Modify the object currently selected in the pulldowns above.
Enabled Option Edit Project Disables the Project in the loaded backup, right now -- like Rename, this takes effect immediately rather than waiting for a save, and Cancel does not undo it.
Exit Command Main Window Exit the program (quit).
Expand Command Map / Diagram / Tree View Toolbar Expand every collapsed Project.
Export Profile Command Edit Profile Saves this Profile as a standalone .prf.xml file on this computer.
Export Project Command Edit Project Saves this Project, and everything in it -- every Profile and Task -- as one standalone file.
Export Scene Command Edit Scene Saves this Scene, with all of its elements, as one standalone .scn.xml file -- the same format Tasker's own Scene export produces.
Export Task Command Edit Task This will save the Task directly to your current drive.
Extended Option Main Window Display an extended list of ALL available models.
Find Tab Map / Diagram / Tree View Toolbar > Find/Replace (Map and Diagram only) Ask the loaded configuration a question rather than searching the text on screen: every Task performing a given action, every Profile a given trigger fires, everything naming a given app or Scene.
Find Command Map / Diagram / Tree View Toolbar > Find/Replace (Map and Diagram only) Ask the loaded configuration a question rather than searching the text on screen: every Task performing a given action, every Profile a given trigger fires, everything naming a given app or Scene.
Find/Replace Command Map / Diagram / Tree View Toolbar 'Find/Replace' asks the loaded configuration a question rather than searching the text on screen: every Task performing a given action, every Profile a given trigger fires, everything that names a given app or Scene.
Font Optionmenu Pulldown Main Window This is a list of all of the fonts available on your system, monospaced ones first and marked as such.
Get Android Help Command Main Window Display the help for fetching the XML file from your Android device.
Get Local XML File Command Main Window Fetch XML from a local drive on this computer.
Get XML from Android Device Command Main Window Fetch XML from an Android device.
Health Check Command Main Window Scan the loaded XML for broken references, unreferenced Tasks, Profiles and Scenes, and naming problems.
Help Command Map / Diagram / Tree View Toolbar The diagram is clickable:
Hide Task Details Under Twisty Option Main Window When enabled, Task details are hidden under a twisty (expand/collapse) control in the output.
Import Into Tasker Command Add Profile > Add Task > Save To Android This puts the Task straight into Tasker's live configuration on the Android device.
Import Into Tasker Command Add Profile > Save To Android This copies the Profile to the device and opens Android's 'Open with...' chooser for it.
Import Into Tasker Command Add Task > Save To Android This puts the Task straight into Tasker's live configuration on the Android device.
Import Into Tasker Command Edit Profile > Add Task > Save To Android This puts the Task straight into Tasker's live configuration on the Android device.
Import Into Tasker Command Edit Profile > Save To Android This copies the Profile to the device and opens Android's 'Open with...' chooser for it.
Import Into Tasker Command Edit Project > Save To Android This copies the Project -- and every Profile and Task in it -- to the device and opens Android's 'Open with...' chooser for it.
Import Into Tasker Command Edit Scene > Save To Android This sends the Scene -- and every Task its elements fire -- to the Android device under its own name, into /Tasker/scenes, and opens Android's 'Open with...' chooser for it.
Import Into Tasker Command Edit Task > Save To Android This puts the Task straight into Tasker's live configuration on the Android device.
Indent Option Pulldown Main Window Set the indentation amount for If/Then/Else blocks.
Just Display Everything! Option Main Window Enables the display of Conditions, TaskerNet Info, Preferences, the Directory, and Prettier Output.
Landscape Option Edit Scene This Scene has no landscape layout of its own (its size is -1).
Landscape Option Add Scene This Scene has no landscape layout of its own (its size is -1).
Landscape Option Item Layout Designer This Scene has no landscape layout of its own (its size is -1).
Landscape Option Scene Preview Window Turn the screen on its side and let the layout re-flow into it.
List Helper Tasks Command Get XML from Android Device Lists the 'MapTasker ...' Tasks this program has installed on the Android device, and says which are left over from an earlier version.
List Unnamed Items Option Main Window Include unnamed Profiles and Tasks in the four pulldowns above.
List XML Files Command Get XML from Android Device List the XML files found on the Android device so you can select one rather than typing its location.
Narrow to Project Pulldown Map / Diagram / Tree View Toolbar > Find/Replace Hidden under a scope, for the reason the Find tab's own gives.
Notify Timeout Optionmenu Pulldown Main Window How long a pop-up message stays on screen before it disappears.
Ok Command Add Profile > Add Task Keeps what this dialog holds and closes it.
Ok Command Add Profile Keeps what this dialog holds and closes it.
Ok Command Add Project Keeps what this dialog holds and closes it.
Ok Command Add Task Keeps what this dialog holds and closes it.
Ok Command Edit Profile > Add Task Keeps what this dialog holds and closes it.
Ok Command Edit Profile Keeps what this dialog holds and closes it.
Ok Command Edit Scene Keeps what this dialog holds and closes it.
Ok Command Edit Task Keeps what this dialog holds and closes it.
Ok Command Get Local XML File Keeps what this dialog holds and closes it.
OK Command AI API Key Entry Keeps what this dialog holds and closes it.
Ok Command Action Condition Keeps what this dialog holds and closes it.
Ok Command Add Scene Keeps what this dialog holds and closes it.
Only the matching text Option Map / Diagram / Tree View Toolbar > Find/Replace Off means the argument is SET to the new value; on means only the matched text inside it changes.
Open View In New Window Option Main Window When enabled, each Map/Diagram request opens in its own new window/tab, so you can keep earlier ones up alongside it to compare.
Palette Command Edit Scene Pick one of Material's own colour roles.
Palette Command Add Scene Pick one of Material's own colour roles.
Pick Command Add Profile > Add Task Choose from the Applications named in the loaded configuration.
Pick Command Add Profile Fill all three fields in from the loaded configuration.
Pick Command Add Task Choose from the Applications named in the loaded configuration.
Pick Command Edit Profile > Add Task Choose from the Applications named in the loaded configuration.
Pick Command Edit Profile Fill all three fields in from the loaded configuration.
Pick Command Edit Scene Pick a Material icon.
Pick Command Edit Task Choose from the Applications named in the loaded configuration.
Pick Command Add Scene Pick a Material icon.
Pick a Task Pulldown Add Profile > Add Task Pick a Task which will be called by this action.
Pick a Task Pulldown Add Task Pick a Task which will be called by this action.
Pick a Task Pulldown Edit Profile > Add Task Pick a Task which will be called by this action.
Pick a Task Pulldown Edit Task Pick a Task which will be called by this action.
Picker Command Edit Scene Pick from the Scene's environment and global variables.
Picker Command Add Scene Pick from the Scene's environment and global variables.
Preview Command Edit Scene Draws this Scene as a picture in the main window -- including the components you have added or changed here but not yet saved.
Preview Command Map / Diagram / Tree View Toolbar > Find/Replace Display the Scene being edited as it will appear.
Preview Command Add Scene Draws this Scene as a picture in the main window -- including the components you have added or changed here but not yet saved.
Profiles Per Line Pulldown Map / Diagram / Tree View Toolbar (Diagram only) The number of Profiles drawn side-by-side on a single line.
Redo Command Main Window Reapply the change most recently backed out by 'Undo'.
Rename Command Edit Profile Prompts for a new name and applies just that to the loaded backup, right now.
Rename Command Edit Profile > Rename Give the object being edited a new name.
Rename Command Edit Project Prompts for a new name and applies it to the loaded backup, right now.
Rename Command Edit Project > Rename Give the object being edited a new name.
Rename Command Edit Scene Tasks address this element by name (Element Text, Element Position, ...
Rename Command Edit Scene > Rename Give the object being edited a new name.
Rename Command Edit Task Prompts for a new name and applies just that to the loaded backup, right now.
Rename Command Edit Task > Rename Give the object being edited a new name.
Rename Command Add Scene Tasks address this element by name (Element Text, Element Position, ...
Rename Command Item Layout Designer Tasks address this element by name (Element Text, Element Position, ...
Rename Command Add Scene > Rename Give the object being edited a new name.
Rename Command Item Layout Designer > Rename Give the object being edited a new name.
Replace Command Map / Diagram / Tree View Toolbar > Find/Replace (Map and Diagram only) Ask the loaded configuration a question rather than searching the text on screen: every Task performing a given action, every Profile a given trigger fires, everything naming a given app or Scene.
Replace Tab Map / Diagram / Tree View Toolbar > Find/Replace (Map and Diagram only) Ask the loaded configuration a question rather than searching the text on screen: every Task performing a given action, every Profile a given trigger fires, everything naming a given app or Scene.
Report Issue Command Main Window Report any issues and/or suggestions to the developer.
Reset Command Map / Diagram / Tree View Toolbar Back to the whole diagram: no zoom, nothing folded, nothing filtered.
Reset Options Command Main Window Reset all of the options to their default values, including colors, font used, and other settings.
Reset to Default Colors Command Main Window Restore every color to its default value.
Run Analysis Command Main Window Submit the selected Project/Profile/Task and prompt to the selected model.
Save As File Command Add Profile > Add Task > Save To Android This will write the Task as a standalone file onto the Android device, under /Tasker/tasks.
Save As File Command Add Profile > Save To Android This will write the Profile as a standalone file onto the Android device, under /Tasker/profiles.
Save As File Command Add Task > Save To Android This will write the Task as a standalone file onto the Android device, under /Tasker/tasks.
Save As File Command Edit Profile > Add Task > Save To Android This will write the Task as a standalone file onto the Android device, under /Tasker/tasks.
Save As File Command Edit Profile > Save To Android This will write the Profile as a standalone file onto the Android device, under /Tasker/profiles.
Save As File Command Edit Project > Save To Android This will write the Project, and everything in it, as a standalone file onto the Android device, under /Tasker/projects.
Save As File Command Edit Scene > Save To Android This will write the Scene as a standalone file onto the Android device, under /Tasker/scenes.
Save As File Command Edit Task > Save To Android This will write the Task as a standalone file onto the Android device, under /Tasker/tasks.
Save Results Command Map / Diagram / Tree View Toolbar > Find/Replace Save the 'Find/Replace' results to a text file.
Save To Android Command Add Profile > Add Task Write the object back to your Android device.
Save To Android Command Add Profile This will write the Profile as a standalone file onto your Android device, under /Tasker/profiles -- it does not import it into Tasker's live configuration.
Save To Android Command Add Task Write the object back to your Android device.
Save To Android Command Edit Profile > Add Task Write the object back to your Android device.
Save To Android Command Edit Profile This will write the Profile as a standalone file onto your Android device, under /Tasker/profiles -- it does not import it into Tasker's live configuration.
Save To Android Command Edit Project This will write the Project, and everything in it -- every Profile and Task -- as a standalone file onto your Android device, under /Tasker/projects -- it does not import it into Tasker's live configuration.
Save To Android Command Edit Scene This will write the Scene as a standalone file onto your Android device, under /Tasker/scenes -- it does not import it into Tasker's live configuration.
Save To Android Command Edit Task This opens a choice of two: write the Task as a standalone file onto your Android device under /Tasker/tasks, or import it straight into Tasker's live configuration.
Save To Current File Command Add Profile > Add Task Saves the entire backup -- every Project, Profile and Task in it, not just this one -- with the new Task added to it, the same way 'Ok' adds it.
Save To Current File Command Add Profile Saves the entire backup -- every Project, Profile and Task in it, not just this one -- with the new Profile added to its Project, the same way 'Ok' adds it.
Save To Current File Command Add Task Saves the entire backup -- every Project, Profile and Task in it, not just this one -- with the new Task added to it, the same way 'Ok' adds it.
Save To Current File Command Edit Profile > Add Task Saves the entire backup -- every Project, Profile and Task in it, not just this one -- with the new Task added to it, the same way 'Ok' adds it.
Save To Current File Command Edit Profile Saves the entire backup -- every Project, Profile and Task in it, not just this Profile -- with this dialog's edits applied, the same ones 'Ok' would keep.
Save To Current File Command Edit Project Saves the entire backup -- every Project, Profile and Task in it, not just this Project -- including every edit made anywhere in this session.
Save To Current File Command Edit Scene Saves the entire backup -- every Project, Profile, Task and Scene in it, not just this Scene -- including every edit made anywhere in this session.
Save To Current File Command Edit Task Saves the entire backup -- every Project, Profile and Task in it, not just this Task -- with this dialog's edits applied, the same ones 'Ok' would keep.
Screen Pulldown Scene Preview Window A Version 2 Scene has no size of its own -- it lays itself out inside whatever screen it is shown on, so there is nothing in the backup file to draw it at.
Search Command Map / Diagram / Tree View Toolbar The 'Search' button will search for and highlight every instance of the case-insensitive string entered in the search box, starting at the top of the data.
Show When Command Edit Scene Pick from the Scene's environment and global variables.
Show When Command Add Scene Pick from the Scene's environment and global variables.
Snap Pulldown Edit Scene Round dragged positions and sizes to this many pixels.
Snap Pulldown Add Scene Round dragged positions and sizes to this many pixels.
Snap Pulldown Item Layout Designer Round dragged positions and sizes to this many pixels.
Snap Pulldown Scene Preview Window Round dragged positions and sizes to this many pixels.
Specific Name Tab Main Window enter a single, specific named item to display...
State Pulldown Edit Scene Dynamic and Select Variable are worked out when the Scene is shown.
State Pulldown Add Scene Dynamic and Select Variable are worked out when the Scene is shown.
Text density Pulldown Scene Preview Window A Scene's element positions are stored in device pixels, but its text sizes are stored in Android's sp units.
Toggle Wrap Command Map / Diagram / Tree View Toolbar Turn line wrapping on or off in the displayed output.
Undo Command Edit Scene Back out the most recent Add/Edit/Delete/Rename change made to the loaded XML.
Undo Command Main Window Take back the last change made to the loaded XML -- an edit, an Add, a Delete or a Rename, in any of the Edit panels.
Undo Command Add Scene Back out the most recent Add/Edit/Delete/Rename change made to the loaded XML.
Undo Command Item Layout Designer Back out the most recent Add/Edit/Delete/Rename change made to the loaded XML.
Upgrade to Latest Version Command New Version Notice Clicking this will launch 'pip install --upgrade maptasker' in the background, and then relaunch MapTasker.
Use Command Add Profile > Add Task > Pick Uses what is entered or selected above, and closes the picker.
Use Command Add Profile > Pick Uses what is entered or selected above, and closes the picker.
Use Command Add Task > Pick Uses what is entered or selected above, and closes the picker.
Use Command Edit Profile > Add Task > Pick Uses what is entered or selected above, and closes the picker.
Use Command Edit Profile > Pick Uses what is entered or selected above, and closes the picker.
Use Command Edit Task > Pick Uses what is entered or selected above, and closes the picker.
Use Selected Command Add Profile > Add Task > Pick Uses what is selected in the list above, and closes the picker.
Use Selected Command Add Task > Pick Uses what is selected in the list above, and closes the picker.
Use Selected Command Edit Profile > Add Task > Pick Uses what is selected in the list above, and closes the picker.
Use Selected Command Edit Task > Pick Uses what is selected in the list above, and closes the picker.
Variable Command Edit Scene Pick from the Scene's environment and global variables.
Variable Command Add Scene Pick from the Scene's environment and global variables.
Variable Xref Command Main Window Trace every %variable in the loaded XML: where each one is set, where it is read, which are read but never set, which are set but never read, and which near-identical names (%MyVar against %Myvar) are likely typos.
Viewlimit Optionmenu Pulldown Main Window Select the maximum number of items to display in the view to be allowed.
What's New? Command New Version Notice Display the changes in the new version.
Zoom In Command Map / Diagram / Tree View Toolbar Zoom in.
Zoom Out Command Map / Diagram / Tree View Toolbar Zoom out.

Main Window

Initializes the main GUI screen layout using NiceGUI with split sidebars.

AI Model

Path: Main Window > AI Model
Kind: Pulldown

Select the model belonging to the AI you wish to use.

Source: guiutils.py line 166

Undo

Path: Main Window > Undo
Kind: Command

Take back the last change made to the loaded XML -- an edit, an Add, a Delete or a Rename, in any of the Edit panels.

This changes what is loaded, not any file: nothing on disk or on the Android device is touched.

Source: guiwins.py line 420

Redo

Path: Main Window > Redo
Kind: Command

Reapply the change most recently backed out by 'Undo'.

Source: guiwins.py line 425

Edit History

Path: Main Window > Edit History
Kind: Command

List every change made to the loaded XML this session, newest first.

Opens Edit History, whose own commands are listed beneath this one.

Source: guiwins.py line 443

Close

Path: Main Window > Edit History > Close
Kind: Command

Closes this window without changing anything.

Source: guiwins.py line 403

Dark Mode

Path: Main Window > Dark Mode
Kind: Option

Switch the GUI between light and dark appearance.

Source: guiwins.py line 11868

Detail Level

Path: Main Window > Detail Level
Kind: Pulldown

0 = least detail, 5 = most detail.

Source: guiwins.py line 11893

Just Display Everything!

Path: Main Window > Just Display Everything!
Kind: Option

Enables the display of Conditions, TaskerNet Info, Preferences, the Directory, and Prettier Output.

Source: guiwins.py line 11906

Display Conditions

Path: Main Window > Display Conditions
Kind: Option

Enables the display of Profile Conditions (e.g. State, Event, etc.) details in the output.

Source: guiwins.py line 11915

Display TaskerNet Info

Path: Main Window > Display TaskerNet Info
Kind: Option

Enables the display of TaskerNet Descriptions in the output.

Source: guiwins.py line 11924

Display Tasker Preferences

Path: Main Window > Display Tasker Preferences
Kind: Option

Enables the display a breakdown of the Tasker system Preferences in the output.

Source: guiwins.py line 11929

Hide Task Details Under Twisty

Path: Main Window > Hide Task Details Under Twisty
Kind: Option

When enabled, Task details are hidden under a twisty (expand/collapse) control in the output.

Source: guiwins.py line 11934

Display Directory

Path: Main Window > Display Directory
Kind: Option

Enables the display of the Project/Profile/Task/Scene Directory in the output.

Source: guiwins.py line 11943

Display Prettier Output

Path: Main Window > Display Prettier Output
Kind: Option

Enables the display of aligned text in the output.

Source: guiwins.py line 11948

Get Local XML File

Path: Main Window > Get Local XML File
Kind: Command

Fetch XML from a local drive on this computer.

The XML fetched will become the current source for MapTasker commands.

Opens Local File Picker, whose own commands are listed beneath this one.

Source: guiwins.py line 11978

Cancel

Path: Main Window > Get Local XML File > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: getfile.py line 50

Ok

Path: Main Window > Get Local XML File > Ok
Kind: Command

Keeps what this dialog holds and closes it. Nothing is written to a file: the change is kept in the loaded configuration, for a save to write out later.

Source: getfile.py line 51

Exit

Path: Main Window > Exit
Kind: Command

Exit the program (quit).

Source: guiwins.py line 11991

Close Tabs On Exit

Path: Main Window > Close Tabs On Exit
Kind: Option

When enabled, clicking 'Exit' also closes the main MapTasker window and any Map/Diagram windows/tabs it opened.

When disabled, 'Exit' shuts down MapTasker but leaves those windows/tabs open.

Source: guiwins.py line 12000

Open View In New Window

Path: Main Window > Open View In New Window
Kind: Option

When enabled, each Map/Diagram request opens in its own new window/tab, so you can keep earlier ones up alongside it to compare.

When disabled, a request reuses that view's existing window/tab, replacing what's in it.

Leave it off unless you want to compare: a brand new window/tab is the one your browser may block, since it gets opened once the view has finished building rather than the instant you click.

Source: guiwins.py line 12016

Health Check

Path: Main Window > Health Check
Kind: Command

Scan the loaded XML for broken references, unreferenced Tasks, Profiles and Scenes, and naming problems.

Results are displayed here and saved to a text file in the current directory.

Source: guiwins.py line 12058

Compare Files

Path: Main Window > Compare Files
Kind: Command

Compare another XML file against the loaded one: what was added, removed, renamed and changed.

Use it to see what a TaskerNet import brought in, what an edit changed, or what is different between two backups.

If the loaded file came from 'Save to Current File', the file it was saved from is offered directly.

Results are displayed here and saved to a text file in the current directory.

Opens Compare Files, whose own commands are listed beneath this one.

Source: guiwins.py line 12081

Cancel

Path: Main Window > Compare Files > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: userintr.py line 242

Variable Xref

Path: Main Window > Variable Xref
Kind: Command

Trace every %variable in the loaded XML: where each one is set, where it is read, which are read but never set, which are set but never read, and which near-identical names (%MyVar against %Myvar) are likely typos.

Searched: Task actions and their conditions, plugin configuration, Profile contexts and Scenes.

Results are displayed here and saved to a text file in the current directory.

Source: guiwins.py line 12107

Clear

Path: Main Window > Clear
Kind: Command

Clear the Map/Diagram/Tree view data currently held and displayed.

Source: guiwins.py line 12129

Specific Name

Path: Main Window > Specific Name
Kind: Tab

enter a single, specific named item to display...

Source: guiwins.py line 12161

Colors

Path: Main Window > Colors
Kind: Tab

select colors for various elements of the display.

Source: guiwins.py line 12166

Analyze

Path: Main Window > Analyze
Kind: Tab

Run the analysis for a Project, Profile, Task or Scene against an Ai model.

Source: guiwins.py line 12167

Debug

Path: Main Window > Debug
Kind: Tab

Display Runtime Settings option and turn on Debug mode.

Source: guiwins.py line 12168

List Unnamed Items

Path: Main Window > List Unnamed Items
Kind: Option

Include unnamed Profiles and Tasks in the four pulldowns above.

Source: guiwins.py line 12242

Edit Project

Path: Main Window > Edit Project
Kind: Command

Modify the object currently selected in the pulldowns above.

Opens Edit Project, whose own commands are listed beneath this one.

Source: guiwins.py line 12272

Enabled

Path: Main Window > Edit Project > Enabled
Kind: Option

Disables the Project in the loaded backup, right now -- like Rename, this takes effect immediately rather than waiting for a save, and Cancel does not undo it.

Source: guiwins.py line 2418

Cancel

Path: Main Window > Edit Project > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 2447

Rename

Path: Main Window > Edit Project > Rename
Kind: Command

Prompts for a new name and applies it to the loaded backup, right now. The Project Name field above is read-only -- this is the only way to change it.

Opens Rename, whose own commands are listed beneath this one.

Source: guiwins.py line 2452

Cancel

Path: Main Window > Edit Project > Rename > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 6909

Rename

Path: Main Window > Edit Project > Rename > Rename
Kind: Command

Give the object being edited a new name.

Source: guiwins.py line 6910

Save To Current File

Path: Main Window > Edit Project > Save To Current File
Kind: Command

Saves the entire backup -- every Project, Profile and Task in it, not just this Project -- including every edit made anywhere in this session. It is written to a new, timestamped copy of the file currently loaded: backup.xml becomes backup_20260728_143005.xml. The file you loaded is never written to, so it is left exactly as it was. The app then switches to the new copy, which becomes the current file for any further editing and saving; saving again replaces the timestamp rather than adding a second one. This writes to this computer only -- nothing is sent to your Android device.

Source: guiwins.py line 2463

Save To Android

Path: Main Window > Edit Project > Save To Android
Kind: Command

This will write the Project, and everything in it -- every Profile and Task -- as a standalone file onto your Android device, under /Tasker/projects -- it does not import it into Tasker's live configuration.

The 'Http Server Example' Tasker Project must be installed and active on the Android device, with the server running.

The Android device must be on the same network, and the IP Address and Port must match its Tasker server settings. No authorization prompt is needed for this.

Opens Save Project To Android, whose own commands are listed beneath this one.

Source: guiwins.py line 2484

Cancel

Path: Main Window > Edit Project > Save To Android > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 2547

Save As File

Path: Main Window > Edit Project > Save To Android > Save As File
Kind: Command

This will write the Project, and everything in it, as a standalone file onto the Android device, under /Tasker/projects.

The IP Address and Port must match the Android device's Tasker server settings.

No authorization prompt is needed for this.

Source: guiwins.py line 2548

Import Into Tasker

Path: Main Window > Edit Project > Save To Android > Import Into Tasker
Kind: Command

This copies the Project -- and every Profile and Task in it -- to the device and opens Android's 'Open with...' chooser for it. Pick Tasker, and its own import screen comes up; you then tap Import to finish, and nothing is imported until you do.

The Project is copied to /Tasker/projects under its own name first and offered from there, so it stays behind under a name you can find -- import it by hand from Tasker if the import screen does not come up. You will be asked before it replaces a file already at that path.

The 'Http Server Example' Tasker Project must be installed and running, and Tasker must be 6.2 or higher.

The device will ask you to authorize MapTasker the first time.

Source: guiwins.py line 2570

Export Project

Path: Main Window > Edit Project > Export Project
Kind: Command

Saves this Project, and everything in it -- every Profile and Task -- as one standalone file.

Source: guiwins.py line 2504

Add Project

Path: Main Window > Add Project
Kind: Command

Create a new object and add it to the loaded XML.

Opens Add Project, whose own commands are listed beneath this one.

Source: guiwins.py line 12281

Cancel

Path: Main Window > Add Project > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 2356

Ok

Path: Main Window > Add Project > Ok
Kind: Command

Keeps what this dialog holds and closes it. Nothing is written to a file: the change is kept in the loaded configuration, for a save to write out later.

Source: guiwins.py line 2357

Edit Profile

Path: Main Window > Edit Profile
Kind: Command

Modify the object currently selected in the pulldowns above.

Opens Edit Profile, whose own commands are listed beneath this one.

Source: guiwins.py line 12291

Pick

Path: Main Window > Edit Profile > Pick
Kind: Command

Fill all three fields in from the loaded configuration.

Opens App Entry Picker, whose own commands are listed beneath this one.

Source: guiwins.py line 943

Use

Path: Main Window > Edit Profile > Pick > Use
Kind: Command

Uses what is entered or selected above, and closes the picker.

Source: guiwins.py line 721

App not listed?

Path: Main Window > Edit Profile > Pick > App not listed?
Kind: Command

Fetch the full list of installed applications from your Android device. What is listed now is only what this configuration already names.

Opens Fetch Applications From Android Device, whose own commands are listed beneath this one.

Source: guiwins.py line 842

Cancel

Path: Main Window > Edit Profile > Pick > App not listed? > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 686

Cancel

Path: Main Window > Edit Profile > Pick > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 916

Add Task

Path: Main Window > Edit Profile > Add Task
Kind: Command

Create a new object and add it to the loaded XML.

Opens Add Task, whose own commands are listed beneath this one.

Source: guiwins.py line 1805

Pick a Task

Path: Main Window > Edit Profile > Add Task > Pick a Task
Kind: Pulldown

Pick a Task which will be called by this action.

Source: guiwins.py line 554

Pick

Path: Main Window > Edit Profile > Add Task > Pick
Kind: Command

Choose from the Applications named in the loaded configuration.

Opens App Picker, whose own commands are listed beneath this one.

Source: guiwins.py line 1065

Use

Path: Main Window > Edit Profile > Add Task > Pick > Use
Kind: Command

Uses what is entered or selected above, and closes the picker.

Source: guiwins.py line 721

Cancel

Path: Main Window > Edit Profile > Add Task > Pick > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 829

Use Selected

Path: Main Window > Edit Profile > Add Task > Pick > Use Selected
Kind: Command

Uses what is selected in the list above, and closes the picker.

Source: guiwins.py line 830

App not listed?

Path: Main Window > Edit Profile > Add Task > Pick > App not listed?
Kind: Command

Fetch the full list of installed applications from your Android device. What is listed now is only what this configuration already names.

Opens Fetch Applications From Android Device, whose own commands are listed beneath this one.

Source: guiwins.py line 842

Cancel

Path: Main Window > Edit Profile > Add Task > Pick > App not listed? > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 686

Cancel

Path: Main Window > Edit Profile > Add Task > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 7364

Ok

Path: Main Window > Edit Profile > Add Task > Ok
Kind: Command

Keeps what this dialog holds and closes it. Nothing is written to a file: the change is kept in the loaded configuration, for a save to write out later.

Source: guiwins.py line 7365

Save To Current File

Path: Main Window > Edit Profile > Add Task > Save To Current File
Kind: Command

Saves the entire backup -- every Project, Profile and Task in it, not just this one -- with the new Task added to it, the same way 'Ok' adds it. It is written to a new, timestamped copy of the file currently loaded: backup.xml becomes backup_20260728_143005.xml. The file you loaded is never written to, so it is left exactly as it was. The app then switches to the new copy, which becomes the current file for any further editing and saving; saving again replaces the timestamp rather than adding a second one. This writes to this computer only -- nothing is sent to your Android device.

Source: guiwins.py line 7374

Save To Android

Path: Main Window > Edit Profile > Add Task > Save To Android
Kind: Command

Write the object back to your Android device.

Opens Save To Android, whose own commands are listed beneath this one.

Source: guiwins.py line 7396

Cancel

Path: Main Window > Edit Profile > Add Task > Save To Android > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 1633

Save As File

Path: Main Window > Edit Profile > Add Task > Save To Android > Save As File
Kind: Command

This will write the Task as a standalone file onto the Android device, under /Tasker/tasks.

The IP Address and Port must match the Android device's Tasker server settings.

No authorization prompt is needed for this.

Source: guiwins.py line 1634

Import Into Tasker

Path: Main Window > Edit Profile > Add Task > Save To Android > Import Into Tasker
Kind: Command

This puts the Task straight into Tasker's live configuration on the Android device. Unlike a Profile, a Project or a Scene, no import screen and no tap on the device are needed -- Tasker's api/import takes a Task directly.

The Task is copied to /Tasker/tasks on the device first and imported from there, so the copy stays behind as a record of exactly what was imported. You will be asked before it replaces a file already at that path.

If Tasker does not report the Task after two attempts, that copy is handed to Android's 'Open with...' chooser instead, so you can import it by picking Tasker.

The 'Http Server Example' Tasker Project must be installed and running, and Tasker must be 6.2 or higher.

The device will ask you to authorize MapTasker the first time.

Source: guiwins.py line 1657

Cancel

Path: Main Window > Edit Profile > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 2181

Delete Profile

Path: Main Window > Edit Profile > Delete Profile
Kind: Command

Deletes only this Profile. Its Entry/Exit Tasks are kept -- a Task is owned by the Project, not by the Profile, and the same Task can be used by other Profiles.

Opens Delete Profile, whose own commands are listed beneath this one.

Source: guiwins.py line 2182

Cancel

Path: Main Window > Edit Profile > Delete Profile > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 6943

Rename

Path: Main Window > Edit Profile > Rename
Kind: Command

Prompts for a new name and applies just that to the loaded backup, right now. Everything else in this dialog stays pending until Ok/Save, and the dialog stays open so you can carry on editing.

Opens Rename, whose own commands are listed beneath this one.

Source: guiwins.py line 2193

Cancel

Path: Main Window > Edit Profile > Rename > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 6909

Rename

Path: Main Window > Edit Profile > Rename > Rename
Kind: Command

Give the object being edited a new name.

Source: guiwins.py line 6910

Ok

Path: Main Window > Edit Profile > Ok
Kind: Command

Keeps what this dialog holds and closes it. Nothing is written to a file: the change is kept in the loaded configuration, for a save to write out later.

Source: guiwins.py line 2205

Save To Current File

Path: Main Window > Edit Profile > Save To Current File
Kind: Command

Saves the entire backup -- every Project, Profile and Task in it, not just this Profile -- with this dialog's edits applied, the same ones 'Ok' would keep. It is written to a new, timestamped copy of the file currently loaded: backup.xml becomes backup_20260728_143005.xml. The file you loaded is never written to, so it is left exactly as it was. The app then switches to the new copy, which becomes the current file for any further editing and saving; saving again replaces the timestamp rather than adding a second one. This writes to this computer only -- nothing is sent to your Android device.

Source: guiwins.py line 2209

Save To Android

Path: Main Window > Edit Profile > Save To Android
Kind: Command

This will write the Profile as a standalone file onto your Android device, under /Tasker/profiles -- it does not import it into Tasker's live configuration.

The 'Http Server Example' Tasker Project must be installed and active on the Android device, with the server running (see the README's Direct XML Retrieval notes).

The Android device must be on the same network, and the IP Address and Port must match its Tasker server settings. No authorization prompt is needed for this.

Opens Save Profile To Android, whose own commands are listed beneath this one.

Source: guiwins.py line 2230

Cancel

Path: Main Window > Edit Profile > Save To Android > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 2285

Save As File

Path: Main Window > Edit Profile > Save To Android > Save As File
Kind: Command

This will write the Profile as a standalone file onto the Android device, under /Tasker/profiles.

The IP Address and Port must match the Android device's Tasker server settings.

No authorization prompt is needed for this.

Source: guiwins.py line 2286

Import Into Tasker

Path: Main Window > Edit Profile > Save To Android > Import Into Tasker
Kind: Command

This copies the Profile to the device and opens Android's 'Open with...' chooser for it. Pick Tasker, and its own import screen comes up; you then tap Import to finish -- nothing is imported until you do.

The Profile is copied to /Tasker/profiles under its own name first and offered from there, so it stays behind under a name you can find -- import it by hand from Tasker if the import screen does not come up. You will be asked before it replaces a file already at that path.

The 'Http Server Example' Tasker Project must be installed and running, and Tasker must be 6.2 or higher.

The device will ask you to authorize MapTasker the first time.

Source: guiwins.py line 2310

Export Profile

Path: Main Window > Edit Profile > Export Profile
Kind: Command

Saves this Profile as a standalone .prf.xml file on this computer.

Source: guiwins.py line 2249

Add Profile

Path: Main Window > Add Profile
Kind: Command

Create a new object and add it to the loaded XML.

Opens Add Profile, whose own commands are listed beneath this one.

Source: guiwins.py line 12300

Pick

Path: Main Window > Add Profile > Pick
Kind: Command

Fill all three fields in from the loaded configuration.

Opens App Entry Picker, whose own commands are listed beneath this one.

Source: guiwins.py line 943

Use

Path: Main Window > Add Profile > Pick > Use
Kind: Command

Uses what is entered or selected above, and closes the picker.

Source: guiwins.py line 721

App not listed?

Path: Main Window > Add Profile > Pick > App not listed?
Kind: Command

Fetch the full list of installed applications from your Android device. What is listed now is only what this configuration already names.

Opens Fetch Applications From Android Device, whose own commands are listed beneath this one.

Source: guiwins.py line 842

Cancel

Path: Main Window > Add Profile > Pick > App not listed? > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 686

Cancel

Path: Main Window > Add Profile > Pick > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 916

Add Task

Path: Main Window > Add Profile > Add Task
Kind: Command

Create a new object and add it to the loaded XML.

Opens Add Task, whose own commands are listed beneath this one.

Source: guiwins.py line 1805

Pick a Task

Path: Main Window > Add Profile > Add Task > Pick a Task
Kind: Pulldown

Pick a Task which will be called by this action.

Source: guiwins.py line 554

Pick

Path: Main Window > Add Profile > Add Task > Pick
Kind: Command

Choose from the Applications named in the loaded configuration.

Opens App Picker, whose own commands are listed beneath this one.

Source: guiwins.py line 1065

Use

Path: Main Window > Add Profile > Add Task > Pick > Use
Kind: Command

Uses what is entered or selected above, and closes the picker.

Source: guiwins.py line 721

Cancel

Path: Main Window > Add Profile > Add Task > Pick > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 829

Use Selected

Path: Main Window > Add Profile > Add Task > Pick > Use Selected
Kind: Command

Uses what is selected in the list above, and closes the picker.

Source: guiwins.py line 830

App not listed?

Path: Main Window > Add Profile > Add Task > Pick > App not listed?
Kind: Command

Fetch the full list of installed applications from your Android device. What is listed now is only what this configuration already names.

Opens Fetch Applications From Android Device, whose own commands are listed beneath this one.

Source: guiwins.py line 842

Cancel

Path: Main Window > Add Profile > Add Task > Pick > App not listed? > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 686

Cancel

Path: Main Window > Add Profile > Add Task > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 7364

Ok

Path: Main Window > Add Profile > Add Task > Ok
Kind: Command

Keeps what this dialog holds and closes it. Nothing is written to a file: the change is kept in the loaded configuration, for a save to write out later.

Source: guiwins.py line 7365

Save To Current File

Path: Main Window > Add Profile > Add Task > Save To Current File
Kind: Command

Saves the entire backup -- every Project, Profile and Task in it, not just this one -- with the new Task added to it, the same way 'Ok' adds it. It is written to a new, timestamped copy of the file currently loaded: backup.xml becomes backup_20260728_143005.xml. The file you loaded is never written to, so it is left exactly as it was. The app then switches to the new copy, which becomes the current file for any further editing and saving; saving again replaces the timestamp rather than adding a second one. This writes to this computer only -- nothing is sent to your Android device.

Source: guiwins.py line 7374

Save To Android

Path: Main Window > Add Profile > Add Task > Save To Android
Kind: Command

Write the object back to your Android device.

Opens Save To Android, whose own commands are listed beneath this one.

Source: guiwins.py line 7396

Cancel

Path: Main Window > Add Profile > Add Task > Save To Android > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 1633

Save As File

Path: Main Window > Add Profile > Add Task > Save To Android > Save As File
Kind: Command

This will write the Task as a standalone file onto the Android device, under /Tasker/tasks.

The IP Address and Port must match the Android device's Tasker server settings.

No authorization prompt is needed for this.

Source: guiwins.py line 1634

Import Into Tasker

Path: Main Window > Add Profile > Add Task > Save To Android > Import Into Tasker
Kind: Command

This puts the Task straight into Tasker's live configuration on the Android device. Unlike a Profile, a Project or a Scene, no import screen and no tap on the device are needed -- Tasker's api/import takes a Task directly.

The Task is copied to /Tasker/tasks on the device first and imported from there, so the copy stays behind as a record of exactly what was imported. You will be asked before it replaces a file already at that path.

If Tasker does not report the Task after two attempts, that copy is handed to Android's 'Open with...' chooser instead, so you can import it by picking Tasker.

The 'Http Server Example' Tasker Project must be installed and running, and Tasker must be 6.2 or higher.

The device will ask you to authorize MapTasker the first time.

Source: guiwins.py line 1657

Cancel

Path: Main Window > Add Profile > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 7092

Ok

Path: Main Window > Add Profile > Ok
Kind: Command

Keeps what this dialog holds and closes it. Nothing is written to a file: the change is kept in the loaded configuration, for a save to write out later.

Source: guiwins.py line 7093

Save To Current File

Path: Main Window > Add Profile > Save To Current File
Kind: Command

Saves the entire backup -- every Project, Profile and Task in it, not just this one -- with the new Profile added to its Project, the same way 'Ok' adds it. It is written to a new, timestamped copy of the file currently loaded: backup.xml becomes backup_20260728_143005.xml. The file you loaded is never written to, so it is left exactly as it was. The app then switches to the new copy, which becomes the current file for any further editing and saving; saving again replaces the timestamp rather than adding a second one. This writes to this computer only -- nothing is sent to your Android device.

Source: guiwins.py line 7097

Save To Android

Path: Main Window > Add Profile > Save To Android
Kind: Command

This will write the Profile as a standalone file onto your Android device, under /Tasker/profiles -- it does not import it into Tasker's live configuration.

The 'Http Server Example' Tasker Project (http://spoo.me/http_svr_example) must be installed and active on the Android device, with the server running (see the README's Direct XML Retrieval notes).

The Android device must be on the same network, and the IP Address and Port must match its Tasker server settings. No authorization prompt is needed for this.

Opens Save Profile To Android, whose own commands are listed beneath this one.

Source: guiwins.py line 7118

Cancel

Path: Main Window > Add Profile > Save To Android > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 2285

Save As File

Path: Main Window > Add Profile > Save To Android > Save As File
Kind: Command

This will write the Profile as a standalone file onto the Android device, under /Tasker/profiles.

The IP Address and Port must match the Android device's Tasker server settings.

No authorization prompt is needed for this.

Source: guiwins.py line 2286

Import Into Tasker

Path: Main Window > Add Profile > Save To Android > Import Into Tasker
Kind: Command

This copies the Profile to the device and opens Android's 'Open with...' chooser for it. Pick Tasker, and its own import screen comes up; you then tap Import to finish -- nothing is imported until you do.

The Profile is copied to /Tasker/profiles under its own name first and offered from there, so it stays behind under a name you can find -- import it by hand from Tasker if the import screen does not come up. You will be asked before it replaces a file already at that path.

The 'Http Server Example' Tasker Project must be installed and running, and Tasker must be 6.2 or higher.

The device will ask you to authorize MapTasker the first time.

Source: guiwins.py line 2310

Edit Task

Path: Main Window > Edit Task
Kind: Command

Modify the object currently selected in the pulldowns above.

Opens Edit Task, whose own commands are listed beneath this one.

Source: guiwins.py line 12310

Pick a Task

Path: Main Window > Edit Task > Pick a Task
Kind: Pulldown

Pick a Task which will be called by this action.

Source: guiwins.py line 554

Pick

Path: Main Window > Edit Task > Pick
Kind: Command

Choose from the Applications named in the loaded configuration.

Opens App Picker, whose own commands are listed beneath this one.

Source: guiwins.py line 1065

Use

Path: Main Window > Edit Task > Pick > Use
Kind: Command

Uses what is entered or selected above, and closes the picker.

Source: guiwins.py line 721

Cancel

Path: Main Window > Edit Task > Pick > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 829

Use Selected

Path: Main Window > Edit Task > Pick > Use Selected
Kind: Command

Uses what is selected in the list above, and closes the picker.

Source: guiwins.py line 830

App not listed?

Path: Main Window > Edit Task > Pick > App not listed?
Kind: Command

Fetch the full list of installed applications from your Android device. What is listed now is only what this configuration already names.

Opens Fetch Applications From Android Device, whose own commands are listed beneath this one.

Source: guiwins.py line 842

Cancel

Path: Main Window > Edit Task > Pick > App not listed? > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 686

Delete

Path: Main Window > Edit Task > Delete
Kind: Command

Remove the object being edited from the loaded XML.

Source: guiwins.py line 1434

Cancel

Path: Main Window > Edit Task > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 1516

Delete Task

Path: Main Window > Edit Task > Delete Task
Kind: Command

Deletes this Task and every reference to it: it is removed from the Tasks of every Project that owns it, and from any Profile that runs it as its Entry/Exit Task. The Profiles themselves are kept.

Opens Delete Task, whose own commands are listed beneath this one.

Source: guiwins.py line 1517

Cancel

Path: Main Window > Edit Task > Delete Task > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 6980

Rename

Path: Main Window > Edit Task > Rename
Kind: Command

Prompts for a new name and applies just that to the loaded backup, right now. Everything else in this dialog stays pending until Ok/Save, and the dialog stays open so you can carry on editing.

Opens Rename, whose own commands are listed beneath this one.

Source: guiwins.py line 1529

Cancel

Path: Main Window > Edit Task > Rename > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 6909

Rename

Path: Main Window > Edit Task > Rename > Rename
Kind: Command

Give the object being edited a new name.

Source: guiwins.py line 6910

Ok

Path: Main Window > Edit Task > Ok
Kind: Command

Keeps what this dialog holds and closes it. Nothing is written to a file: the change is kept in the loaded configuration, for a save to write out later.

Source: guiwins.py line 1541

Save To Current File

Path: Main Window > Edit Task > Save To Current File
Kind: Command

Saves the entire backup -- every Project, Profile and Task in it, not just this Task -- with this dialog's edits applied, the same ones 'Ok' would keep. It is written to a new, timestamped copy of the file currently loaded: backup.xml becomes backup_20260728_143005.xml. The file you loaded is never written to, so it is left exactly as it was. The app then switches to the new copy, which becomes the current file for any further editing and saving; saving again replaces the timestamp rather than adding a second one. This writes to this computer only -- nothing is sent to your Android device.

Source: guiwins.py line 1545

Save To Android

Path: Main Window > Edit Task > Save To Android
Kind: Command

This opens a choice of two: write the Task as a standalone file onto your Android device under /Tasker/tasks, or import it straight into Tasker's live configuration.

The 'Http Server Example' Tasker Project must be installed and active on the Android device, with the server running (see the README's Direct XML Retrieval notes), and Tasker must be 6.2 or higher.

The Android device must be on the same network, and the IP Address and Port must match its Tasker server settings.

The file write needs no authorization prompt; the import asks for one, and you must exit and restart Tasker to see an imported Task in the Tasker UI.

Opens Save To Android, whose own commands are listed beneath this one.

Source: guiwins.py line 1566

Cancel

Path: Main Window > Edit Task > Save To Android > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 1633

Save As File

Path: Main Window > Edit Task > Save To Android > Save As File
Kind: Command

This will write the Task as a standalone file onto the Android device, under /Tasker/tasks.

The IP Address and Port must match the Android device's Tasker server settings.

No authorization prompt is needed for this.

Source: guiwins.py line 1634

Import Into Tasker

Path: Main Window > Edit Task > Save To Android > Import Into Tasker
Kind: Command

This puts the Task straight into Tasker's live configuration on the Android device. Unlike a Profile, a Project or a Scene, no import screen and no tap on the device are needed -- Tasker's api/import takes a Task directly.

The Task is copied to /Tasker/tasks on the device first and imported from there, so the copy stays behind as a record of exactly what was imported. You will be asked before it replaces a file already at that path.

If Tasker does not report the Task after two attempts, that copy is handed to Android's 'Open with...' chooser instead, so you can import it by picking Tasker.

The 'Http Server Example' Tasker Project must be installed and running, and Tasker must be 6.2 or higher.

The device will ask you to authorize MapTasker the first time.

Source: guiwins.py line 1657

Export Task

Path: Main Window > Edit Task > Export Task
Kind: Command

This will save the Task directly to your current drive.

Source: guiwins.py line 1589

Add Task

Path: Main Window > Add Task
Kind: Command

Create a new object and add it to the loaded XML.

Opens Add Task, whose own commands are listed beneath this one.

Source: guiwins.py line 12319

Pick a Task

Path: Main Window > Add Task > Pick a Task
Kind: Pulldown

Pick a Task which will be called by this action.

Source: guiwins.py line 554

Pick

Path: Main Window > Add Task > Pick
Kind: Command

Choose from the Applications named in the loaded configuration.

Opens App Picker, whose own commands are listed beneath this one.

Source: guiwins.py line 1065

Use

Path: Main Window > Add Task > Pick > Use
Kind: Command

Uses what is entered or selected above, and closes the picker.

Source: guiwins.py line 721

Cancel

Path: Main Window > Add Task > Pick > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 829

Use Selected

Path: Main Window > Add Task > Pick > Use Selected
Kind: Command

Uses what is selected in the list above, and closes the picker.

Source: guiwins.py line 830

App not listed?

Path: Main Window > Add Task > Pick > App not listed?
Kind: Command

Fetch the full list of installed applications from your Android device. What is listed now is only what this configuration already names.

Opens Fetch Applications From Android Device, whose own commands are listed beneath this one.

Source: guiwins.py line 842

Cancel

Path: Main Window > Add Task > Pick > App not listed? > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 686

Cancel

Path: Main Window > Add Task > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 7364

Ok

Path: Main Window > Add Task > Ok
Kind: Command

Keeps what this dialog holds and closes it. Nothing is written to a file: the change is kept in the loaded configuration, for a save to write out later.

Source: guiwins.py line 7365

Save To Current File

Path: Main Window > Add Task > Save To Current File
Kind: Command

Saves the entire backup -- every Project, Profile and Task in it, not just this one -- with the new Task added to it, the same way 'Ok' adds it. It is written to a new, timestamped copy of the file currently loaded: backup.xml becomes backup_20260728_143005.xml. The file you loaded is never written to, so it is left exactly as it was. The app then switches to the new copy, which becomes the current file for any further editing and saving; saving again replaces the timestamp rather than adding a second one. This writes to this computer only -- nothing is sent to your Android device.

Source: guiwins.py line 7374

Save To Android

Path: Main Window > Add Task > Save To Android
Kind: Command

Write the object back to your Android device.

Opens Save To Android, whose own commands are listed beneath this one.

Source: guiwins.py line 7396

Cancel

Path: Main Window > Add Task > Save To Android > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 1633

Save As File

Path: Main Window > Add Task > Save To Android > Save As File
Kind: Command

This will write the Task as a standalone file onto the Android device, under /Tasker/tasks.

The IP Address and Port must match the Android device's Tasker server settings.

No authorization prompt is needed for this.

Source: guiwins.py line 1634

Import Into Tasker

Path: Main Window > Add Task > Save To Android > Import Into Tasker
Kind: Command

This puts the Task straight into Tasker's live configuration on the Android device. Unlike a Profile, a Project or a Scene, no import screen and no tap on the device are needed -- Tasker's api/import takes a Task directly.

The Task is copied to /Tasker/tasks on the device first and imported from there, so the copy stays behind as a record of exactly what was imported. You will be asked before it replaces a file already at that path.

If Tasker does not report the Task after two attempts, that copy is handed to Android's 'Open with...' chooser instead, so you can import it by picking Tasker.

The 'Http Server Example' Tasker Project must be installed and running, and Tasker must be 6.2 or higher.

The device will ask you to authorize MapTasker the first time.

Source: guiwins.py line 1657

Edit Scene

Path: Main Window > Edit Scene
Kind: Command

Modify the object currently selected in the pulldowns above.

Opens Edit Scene, whose own commands are listed beneath this one.

Source: guiwins.py line 12335

Picker

Path: Main Window > Edit Scene > Picker
Kind: Command

Pick from the Scene's environment and global variables.

Opens Variable / Show When Picker, whose own commands are listed beneath this one.

Source: guiwins.py line 3147

Close

Path: Main Window > Edit Scene > Picker > Close
Kind: Command

Closes this window without changing anything.

Source: guiwins.py line 3105

Palette

Path: Main Window > Edit Scene > Palette
Kind: Command

Pick one of Material's own colour roles.

Source: guiwins.py line 3197

Pick

Path: Main Window > Edit Scene > Pick
Kind: Command

Pick a Material icon.

Opens Icon, whose own commands are listed beneath this one.

Source: guiwins.py line 3249

Cancel

Path: Main Window > Edit Scene > Pick > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 3346

State

Path: Main Window > Edit Scene > State
Kind: Pulldown

Dynamic and Select Variable are worked out when the Scene is shown.

Source: guiwins.py line 3418

Variable

Path: Main Window > Edit Scene > Variable
Kind: Command

Pick from the Scene's environment and global variables.

Opens Variable / Show When Picker, whose own commands are listed beneath this one.

Source: guiwins.py line 3469

Close

Path: Main Window > Edit Scene > Variable > Close
Kind: Command

Closes this window without changing anything.

Source: guiwins.py line 3105

Show When

Path: Main Window > Edit Scene > Show When
Kind: Command

Pick from the Scene's environment and global variables.

Opens Variable / Show When Picker, whose own commands are listed beneath this one.

Source: guiwins.py line 3769

Close

Path: Main Window > Edit Scene > Show When > Close
Kind: Command

Closes this window without changing anything.

Source: guiwins.py line 3105

Close

Path: Main Window > Edit Scene > Close
Kind: Command

Closes this window without changing anything.

Source: guiwins.py line 3849

Add

Path: Main Window > Edit Scene > Add
Kind: Command

Adds inside the selected component if it can hold children, otherwise directly after it.

Opens Add Element, whose own commands are listed beneath this one.

Source: guiwins.py line 4065

Cancel

Path: Main Window > Edit Scene > Add > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 2756

Undo

Path: Main Window > Edit Scene > Undo
Kind: Command

Back out the most recent Add/Edit/Delete/Rename change made to the loaded XML. This changes what is loaded, not any file.

Source: guiwins.py line 4076

Delete

Path: Main Window > Edit Scene > Delete
Kind: Command

Remove the object being edited from the loaded XML.

Source: guiwins.py line 4129

Landscape

Path: Main Window > Edit Scene > Landscape
Kind: Option

This Scene has no landscape layout of its own (its size is -1).

Source: guiwins.py line 5807

Snap

Path: Main Window > Edit Scene > Snap
Kind: Pulldown

Round dragged positions and sizes to this many pixels.

Source: guiwins.py line 5818

Duplicate

Path: Main Window > Edit Scene > Duplicate
Kind: Command

Make a copy of the selected Scene element.

Source: guiwins.py line 5892

Rename

Path: Main Window > Edit Scene > Rename
Kind: Command

Tasks address this element by name (Element Text, Element Position, ... 18 action codes in all), so renaming it is not a field edit. The Rename dialog lists what depends on the current name and offers to bring those Tasks along.

Opens Rename Legacy Element, whose own commands are listed beneath this one.

Source: guiwins.py line 6099

Cancel

Path: Main Window > Edit Scene > Rename > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 2839

Rename

Path: Main Window > Edit Scene > Rename > Rename
Kind: Command

Give the object being edited a new name.

Source: guiwins.py line 2840

Preview

Path: Main Window > Edit Scene > Preview
Kind: Command

Draws this Scene as a picture in the main window -- including the components you have added or changed here but not yet saved.

A Version 2 layout has no size of its own, so the preview lays it out in a screen you pick, and re-flows it when you change that.

This dialog closes while the preview is up, with everything in it kept; the preview's 'Back to Editor' button brings it back.

It is a representation, not Tasker's own renderer: %variables are named rather than resolved, Material colours come from the baseline palette rather than the device's theme, and images, video and web content are shown as placeholders.

Source: guiwins.py line 6191

Cancel

Path: Main Window > Edit Scene > Cancel
Kind: Command

Closes without saving, and puts this Scene back exactly as it was when this dialog opened -- including anything moved or resized in the Preview.

A Rename is the one thing this cannot take back: it is applied to the loaded backup as it is confirmed, and closes this dialog with it.

Source: guiwins.py line 6558

Ok

Path: Main Window > Edit Scene > Ok
Kind: Command

Keeps what this dialog holds and closes it. Nothing is written to a file: the change is kept in the loaded configuration, for a save to write out later.

Source: guiwins.py line 6587

Save To Current File

Path: Main Window > Edit Scene > Save To Current File
Kind: Command

Saves the entire backup -- every Project, Profile, Task and Scene in it, not just this Scene -- including every edit made anywhere in this session. It is written to a new, timestamped copy of the file currently loaded: backup.xml becomes backup_20260728_143005.xml. The file you loaded is never written to, so it is left exactly as it was. The app then switches to the new copy, which becomes the current file for any further editing and saving; saving again replaces the timestamp rather than adding a second one. This writes to this computer only -- nothing is sent to your Android device.

Source: guiwins.py line 6591

Save To Android

Path: Main Window > Edit Scene > Save To Android
Kind: Command

This will write the Scene as a standalone file onto your Android device, under /Tasker/scenes -- it does not import it into Tasker's live configuration.

The 'Http Server Example' Tasker Project must be installed and active on the Android device, with the server running.

The Android device must be on the same network, and the IP Address and Port must match its Tasker server settings. No authorization prompt is needed for this.

Opens Save Scene To Android, whose own commands are listed beneath this one.

Source: guiwins.py line 6612

Cancel

Path: Main Window > Edit Scene > Save To Android > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 6724

Save As File

Path: Main Window > Edit Scene > Save To Android > Save As File
Kind: Command

This will write the Scene as a standalone file onto the Android device, under /Tasker/scenes.

The IP Address and Port must match the Android device's Tasker server settings.

No authorization prompt is needed for this.

Source: guiwins.py line 6725

Import Into Tasker

Path: Main Window > Edit Scene > Save To Android > Import Into Tasker
Kind: Command

This sends the Scene -- and every Task its elements fire -- to the Android device under its own name, into /Tasker/scenes, and opens Android's 'Open with...' chooser for it.

If Tasker is in that chooser, pick it. A Scene is the one kind Tasker has been seen to refuse when it is handed one, so if it is not there -- or nothing happens -- finish it with Tasker's 'Scenes > Import One Scene' and pick the Scene by name. The file is on the device either way, and the message tells you its name.

You will be asked before it replaces a file already at that path.

The 'Http Server Example' Tasker Project must be installed and running, and Tasker must be 6.2 or higher.

The device will ask you to authorize MapTasker the first time.

Source: guiwins.py line 6746

Export Scene

Path: Main Window > Edit Scene > Export Scene
Kind: Command

Saves this Scene, with all of its elements, as one standalone .scn.xml file -- the same format Tasker's own Scene export produces.

Tasks the Scene's elements run are not included; they belong to their own Project.

Source: guiwins.py line 6631

Add Scene

Path: Main Window > Add Scene
Kind: Command

Create a new object and add it to the loaded XML.

Opens Add Scene Version, whose own commands are listed beneath this one.

Source: guiwins.py line 12344

Cancel

Path: Main Window > Add Scene > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 6331

Reset to Default Colors

Path: Main Window > Reset to Default Colors
Kind: Command

Restore every color to its default value.

Source: guiwins.py line 12378

Cancel

Path: Main Window > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 12451

Change Prompt

Path: Main Window > Change Prompt
Kind: Command

Modify the prompt sent to the AI model.

Opens Change Prompt, whose own commands are listed beneath this one.

Source: guiwins.py line 12493

Cancel

Path: Main Window > Change Prompt > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: userintr.py line 6161

Run Analysis

Path: Main Window > Run Analysis
Kind: Command

Submit the selected Project/Profile/Task and prompt to the selected model.

Source: guiwins.py line 12498

Extended

Path: Main Window > Extended
Kind: Option

Display an extended list of ALL available models.

Note: If the API key is not set for OpenAI or Gemini, then the default model list for the respective AI provider will be displayed.

Note: Not all models have been validated and one or more may return an error on analysis.

Note: Enabling this option for the first time will force the installation of the following modules and all of their dependencies: google-genai, anthropic, openai, ollama

Source: guiwins.py line 12517

Indent Option

Path: Main Window > Indent Option
Kind: Pulldown

Set the indentation amount for If/Then/Else blocks.

The default is '4'.

This affects how the output is formatted in the Map and Diagram views.

Source: guiwins.py line 12626

Viewlimit Optionmenu

Path: Main Window > Viewlimit Optionmenu
Kind: Pulldown

Select the maximum number of items to display in the view to be allowed.

Anything over this amount will stop the generation of the view as a means to throttle the program.

Note: This is only for the 'Map' and 'Diagram' views, not the tree view.

Source: guiwins.py line 12676

Notify Timeout Optionmenu

Path: Main Window > Notify Timeout Optionmenu
Kind: Pulldown

How long a pop-up message stays on screen before it disappears.

'Until dismissed' keeps every message up until you close it, which is useful when a message scrolls past before you can read it.

A few messages set their own longer duration because they list things you have to read -- the Tasks affected by deleting or renaming a Scene element, for instance. Those keep their own timing whatever is chosen here.

Source: guiwins.py line 12717

Reset Options

Path: Main Window > Reset Options
Kind: Command

Reset all of the options to their default values, including colors, font used, and other settings.

The currently loaded XML will be cleared out.

Source: guiwins.py line 12741

Report Issue

Path: Main Window > Report Issue
Kind: Command

Report any issues and/or suggestions to the developer.

This will open a browser window to the GitHub Issues page, and you will need a GitHub account to submit an issue.

Source: guiwins.py line 12774

Font Optionmenu

Path: Main Window > Font Optionmenu
Kind: Pulldown

This is a list of all of the fonts available on your system, monospaced ones first and marked as such.

The font selected will be used in all output.

'Courier' or 'Courier New' is highly recommended for Diagrams to ensure proper connector alignment. A font that is not monospaced will not hold the Diagram's connectors or the output's indentation in line.

Source: guiwins.py line 12814

Get XML from Android Device

Path: Main Window > Get XML from Android Device
Kind: Command

Fetch XML from an Android device.

You must be on the same network as the Android device, and the device must be running and connected.

Opens Get XML From Android Device, whose own commands are listed beneath this one.

Source: guiwins.py line 12843

List XML Files

Path: Main Window > Get XML from Android Device > List XML Files
Kind: Command

List the XML files found on the Android device so you can select one rather than typing its location.

Opens Android XML File List, whose own commands are listed beneath this one.

Source: userintr.py line 2829

Cancel Entry

Path: Main Window > Get XML from Android Device > List XML Files > Cancel Entry
Kind: Command

Back out of the Android fetch process.

Source: guiutils.py line 1662

List Helper Tasks

Path: Main Window > Get XML from Android Device > List Helper Tasks
Kind: Command

Lists the 'MapTasker ...' Tasks this program has installed on the Android device, and says which are left over from an earlier version.

Each one is installed under a versioned name and never replaced -- Tasker's import adds a second Task rather than replacing the first -- so old ones stay behind in your Task list. They do no harm; they are clutter.

Delete the ones it names from Tasker's own Tasks tab. Nothing here can do it for you: Tasker's HTTP API has no way to delete a Task.

Opens Helper Tasks, whose own commands are listed beneath this one.

Source: userintr.py line 2845

Close

Path: Main Window > Get XML from Android Device > List Helper Tasks > Close
Kind: Command

Closes this window without changing anything.

Source: guiwins.py line 6826

Cancel Entry

Path: Main Window > Get XML from Android Device > Cancel Entry
Kind: Command

Back out of the Android fetch process.

Source: userintr.py line 2870

Display Help

Path: Main Window > Display Help
Kind: Command

Display this help text.

Source: guiwins.py line 12875

Get Android Help

Path: Main Window > Get Android Help
Kind: Command

Display the help for fetching the XML file from your Android device.

Source: guiwins.py line 12882

AI API Key Entry

Initialize the NiceGUI dialog container.

OK

Path: AI API Key Entry > OK
Kind: Command

Keeps what this dialog holds and closes it. Nothing is written to a file: the change is kept in the loaded configuration, for a save to write out later.

Source: guiwins2.py line 39

Cancel

Path: AI API Key Entry > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins2.py line 50

Clear

Path: AI API Key Entry > Clear
Kind: Command

Clear the Map/Diagram/Tree view data currently held and displayed.

Source: guiwins2.py line 87

Action Condition

_Prompts for a per-action If condition (Target/Operator/Value) when the action's "If" checkbox is checked -- see render_action_condition_checkbox.

Cancel

Path: Action Condition > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 1128

Ok

Path: Action Condition > Ok
Kind: Command

Keeps what this dialog holds and closes it. Nothing is written to a file: the change is kept in the loaded configuration, for a save to write out later.

Source: guiwins.py line 1132

Add Scene

Builds and opens the Add Scene dialog for a Scene of the kind already chosen in build_add_scene_version_dialog: create it, empty, and attach it to the currently selected Project.

Picker

Path: Add Scene > Picker
Kind: Command

Pick from the Scene's environment and global variables.

Opens Variable / Show When Picker, whose own commands are listed beneath this one.

Source: guiwins.py line 3147

Close

Path: Add Scene > Picker > Close
Kind: Command

Closes this window without changing anything.

Source: guiwins.py line 3105

Palette

Path: Add Scene > Palette
Kind: Command

Pick one of Material's own colour roles.

Source: guiwins.py line 3197

Pick

Path: Add Scene > Pick
Kind: Command

Pick a Material icon.

Opens Icon, whose own commands are listed beneath this one.

Source: guiwins.py line 3249

Cancel

Path: Add Scene > Pick > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 3346

State

Path: Add Scene > State
Kind: Pulldown

Dynamic and Select Variable are worked out when the Scene is shown.

Source: guiwins.py line 3418

Variable

Path: Add Scene > Variable
Kind: Command

Pick from the Scene's environment and global variables.

Opens Variable / Show When Picker, whose own commands are listed beneath this one.

Source: guiwins.py line 3469

Close

Path: Add Scene > Variable > Close
Kind: Command

Closes this window without changing anything.

Source: guiwins.py line 3105

Show When

Path: Add Scene > Show When
Kind: Command

Pick from the Scene's environment and global variables.

Opens Variable / Show When Picker, whose own commands are listed beneath this one.

Source: guiwins.py line 3769

Close

Path: Add Scene > Show When > Close
Kind: Command

Closes this window without changing anything.

Source: guiwins.py line 3105

Close

Path: Add Scene > Close
Kind: Command

Closes this window without changing anything.

Source: guiwins.py line 3849

Add

Path: Add Scene > Add
Kind: Command

Adds inside the selected component if it can hold children, otherwise directly after it.

Opens Add Element, whose own commands are listed beneath this one.

Source: guiwins.py line 4065

Cancel

Path: Add Scene > Add > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 2756

Undo

Path: Add Scene > Undo
Kind: Command

Back out the most recent Add/Edit/Delete/Rename change made to the loaded XML. This changes what is loaded, not any file.

Source: guiwins.py line 4076

Delete

Path: Add Scene > Delete
Kind: Command

Remove the object being edited from the loaded XML.

Source: guiwins.py line 4129

Landscape

Path: Add Scene > Landscape
Kind: Option

This Scene has no landscape layout of its own (its size is -1).

Source: guiwins.py line 5807

Snap

Path: Add Scene > Snap
Kind: Pulldown

Round dragged positions and sizes to this many pixels.

Source: guiwins.py line 5818

Duplicate

Path: Add Scene > Duplicate
Kind: Command

Make a copy of the selected Scene element.

Source: guiwins.py line 5892

Rename

Path: Add Scene > Rename
Kind: Command

Tasks address this element by name (Element Text, Element Position, ... 18 action codes in all), so renaming it is not a field edit. The Rename dialog lists what depends on the current name and offers to bring those Tasks along.

Opens Rename Legacy Element, whose own commands are listed beneath this one.

Source: guiwins.py line 6099

Cancel

Path: Add Scene > Rename > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 2839

Rename

Path: Add Scene > Rename > Rename
Kind: Command

Give the object being edited a new name.

Source: guiwins.py line 2840

Preview

Path: Add Scene > Preview
Kind: Command

Draws this Scene as a picture in the main window -- including the components you have added or changed here but not yet saved.

A Version 2 layout has no size of its own, so the preview lays it out in a screen you pick, and re-flows it when you change that.

This dialog closes while the preview is up, with everything in it kept; the preview's 'Back to Editor' button brings it back.

It is a representation, not Tasker's own renderer: %variables are named rather than resolved, Material colours come from the baseline palette rather than the device's theme, and images, video and web content are shown as placeholders.

Source: guiwins.py line 6191

Cancel

Path: Add Scene > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 6375

Ok

Path: Add Scene > Ok
Kind: Command

Keeps what this dialog holds and closes it. Nothing is written to a file: the change is kept in the loaded configuration, for a save to write out later.

Source: guiwins.py line 6376

Choose An If Variant

Prompts for how much of an If block to insert when the user picks the "If" action in an Add/Edit Task action picker: just the "If", "If" plus a matching "End If", or a full "If"/"Else"/"End If" skeleton -- see taskedit.IF_BLOCK_VARIANTS/add_if_block_to_task.

Cancel

Path: Choose An If Variant > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 1247

Delete Project

Confirms deletion of a Project, offering a choice for what happens to the Profiles/Tasks it owns: moved into "Base" (Keep Contents) or deleted along with it (Delete Contents) -- see projedit.delete_project.

Cancel

Path: Delete Project > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 7013

Delete Scene

Confirms deletion of a Scene.

Cancel

Path: Delete Scene > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 6682

Item Layout Designer

Edit the Scene inside a List or a Spinner, in a designer of its own.

Close

Path: Item Layout Designer > Close
Kind: Command

Stop firing anything on this event.

Source: guiwins.py line 5581

Landscape

Path: Item Layout Designer > Landscape
Kind: Option

This Scene has no landscape layout of its own (its size is -1).

Source: guiwins.py line 5807

Snap

Path: Item Layout Designer > Snap
Kind: Pulldown

Round dragged positions and sizes to this many pixels.

Source: guiwins.py line 5818

Add

Path: Item Layout Designer > Add
Kind: Command

Adds an element on top of the stack, in the middle of the Scene.

Opens Add Legacy Element, whose own commands are listed beneath this one.

Source: guiwins.py line 5826

Cancel

Path: Item Layout Designer > Add > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 2964

Undo

Path: Item Layout Designer > Undo
Kind: Command

Back out the most recent Add/Edit/Delete/Rename change made to the loaded XML. This changes what is loaded, not any file.

Source: guiwins.py line 5833

Duplicate

Path: Item Layout Designer > Duplicate
Kind: Command

Make a copy of the selected Scene element.

Source: guiwins.py line 5892

Delete

Path: Item Layout Designer > Delete
Kind: Command

Remove the object being edited from the loaded XML.

Source: guiwins.py line 5895

Done

Path: Item Layout Designer > Done
Kind: Command

Closes this dialog, keeping what was edited in it.

Source: guiwins.py line 5972

Rename

Path: Item Layout Designer > Rename
Kind: Command

Tasks address this element by name (Element Text, Element Position, ... 18 action codes in all), so renaming it is not a field edit. The Rename dialog lists what depends on the current name and offers to bring those Tasks along.

Opens Rename Legacy Element, whose own commands are listed beneath this one.

Source: guiwins.py line 6099

Cancel

Path: Item Layout Designer > Rename > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 2839

Rename

Path: Item Layout Designer > Rename > Rename
Kind: Command

Give the object being edited a new name.

Source: guiwins.py line 2840

Map / Diagram / Tree View Toolbar

Builds the UI layout for the various text views, including toolbar and scrollable display area.

Zoom Out

Path: Map / Diagram / Tree View Toolbar > Zoom Out
Kind: Command

Zoom out. Ctrl/⌘ and the scroll wheel does the same.

Source: guiwins.py line 7526

Zoom In

Path: Map / Diagram / Tree View Toolbar > Zoom In
Kind: Command

Zoom in. Ctrl/⌘ and the scroll wheel does the same.

Source: guiwins.py line 7534

Collapse

Path: Map / Diagram / Tree View Toolbar > Collapse
Kind: Command

Collapse every Project down to its title bar.

One Project on its own collapses by clicking the top edge of its box.

Source: guiwins.py line 7539

Expand

Path: Map / Diagram / Tree View Toolbar > Expand
Kind: Command

Expand every collapsed Project.

Source: guiwins.py line 7552

Reset

Path: Map / Diagram / Tree View Toolbar > Reset
Kind: Command

Back to the whole diagram: no zoom, nothing folded, nothing filtered.

Source: guiwins.py line 7557

Help

Path: Map / Diagram / Tree View Toolbar > Help
Kind: Command

The diagram is clickable:

Click a Project, Profile, Task or Scene name to be taken to it in the Map.

Shift-click a Task to light up the whole chain of calls it takes part in -- everything it calls, everything that calls it, and the arrows between them.

Right-click any name for the rest: collapse its Project, show only that Project, follow its chain.

Click the ▾ beside a Project to collapse it, and the ▸ to bring it back.

Ctrl (or ⌘) and the scroll wheel zooms. Esc clears a chain.

Source: guiwins.py line 7564

Search

Path: Map / Diagram / Tree View Toolbar > Search
Kind: Command

The 'Search' button will search for and highlight every instance of the case-insensitive string entered in the search box, starting at the top of the data.

It will only show the first 200 instances of the search string.

Click on the line number to go to that line in the text view box.

The 'Clear' button will clear the search results.

Source: guiwins.py line 9008

Clear

Path: Map / Diagram / Tree View Toolbar > Clear
Kind: Command

Clear the Map/Diagram/Tree view data currently held and displayed.

Source: guiwins.py line 9018

Find/Replace

Path: Map / Diagram / Tree View Toolbar > Find/Replace
Kind: Command

'Find/Replace' asks the loaded configuration a question rather than searching the text on screen: every Task performing a given action, every Profile a given trigger fires, everything that names a given app or Scene.

The boxes combine -- pick a trigger and an action to find the Profiles that trigger that way and run a Task that does that.

Results come back as a list of objects; click one to be taken to it.

Opens Find / Replace, whose own commands are listed beneath this one.

Source: guiwins.py line 9027

Narrow to Project

Path: Map / Diagram / Tree View Toolbar > Find/Replace > Narrow to Project
Kind: Pulldown

There is no tooltip on this one; this is the note written beside it in the source.

Hidden under a scope, for the reason the Find tab's own gives.

Source: guiwins.py line 9988

Only the matching text

Path: Map / Diagram / Tree View Toolbar > Find/Replace > Only the matching text
Kind: Option

There is no tooltip on this one; this is the note written beside it in the source.

Off means the argument is SET to the new value; on means only the matched text inside it changes. Both are things people mean by "replace", and which one they meant cannot be guessed from the two boxes above -- so it is asked, in the one place where the answer is visible while the values are being typed.

Source: guiwins.py line 10049

Add it where missing

Path: Map / Diagram / Tree View Toolbar > Find/Replace > Add it where missing
Kind: Option

There is no tooltip on this one; this is the note written beside it in the source.

Tasker leaves out an argument nobody ever set, so this is what makes "give every Flash a Timeout" reach the Flashes that have none. Off by default: adding an argument to a hundred actions is a bigger thing than editing the ones that already have it, and the preview marks every row that is an addition rather than a change.

Source: guiwins.py line 10055

Preview

Path: Map / Diagram / Tree View Toolbar > Find/Replace > Preview
Kind: Command

Display the Scene being edited as it will appear.

Source: guiwins.py line 10545

Replace

Path: Map / Diagram / Tree View Toolbar > Find/Replace > Replace
Kind: Command

(Map and Diagram only) Ask the loaded configuration a question rather than searching the text on screen: every Task performing a given action, every Profile a given trigger fires, everything naming a given app or Scene. Click a result to be taken to it.

Source: guiwins.py line 10546

Find

Path: Map / Diagram / Tree View Toolbar > Find/Replace > Find
Kind: Tab

(Map and Diagram only) Ask the loaded configuration a question rather than searching the text on screen: every Task performing a given action, every Profile a given trigger fires, everything naming a given app or Scene. Click a result to be taken to it.

Source: guiwins.py line 10762

Replace

Path: Map / Diagram / Tree View Toolbar > Find/Replace > Replace
Kind: Tab

(Map and Diagram only) Ask the loaded configuration a question rather than searching the text on screen: every Task performing a given action, every Profile a given trigger fires, everything naming a given app or Scene. Click a result to be taken to it.

Source: guiwins.py line 10763

Find

Path: Map / Diagram / Tree View Toolbar > Find/Replace > Find
Kind: Command

(Map and Diagram only) Ask the loaded configuration a question rather than searching the text on screen: every Task performing a given action, every Profile a given trigger fires, everything naming a given app or Scene. Click a result to be taken to it.

Source: guiwins.py line 10954

Save Results

Path: Map / Diagram / Tree View Toolbar > Find/Replace > Save Results
Kind: Command

Save the 'Find/Replace' results to a text file.

Source: guiwins.py line 10955

Close

Path: Map / Diagram / Tree View Toolbar > Find/Replace > Close
Kind: Command

Closes this window without changing anything.

Source: guiwins.py line 10965

Toggle Wrap

Path: Map / Diagram / Tree View Toolbar > Toggle Wrap
Kind: Command

Turn line wrapping on or off in the displayed output.

Source: guiwins.py line 9044

Profiles Per Line

Path: Map / Diagram / Tree View Toolbar > Profiles Per Line
Kind: Pulldown

(Diagram only) The number of Profiles drawn side-by-side on a single line.

Source: guiwins.py line 9054

New Version Notice

Check if a new version is available and dynamically populate the upgrade container slot inside the right sidebar.

Upgrade to Latest Version

Path: New Version Notice > Upgrade to Latest Version
Kind: Command

Clicking this will launch 'pip install --upgrade maptasker' in the background, and then relaunch MapTasker.

Source: guiutils.py line 1783

What's New?

Path: New Version Notice > What's New?
Kind: Command

Display the changes in the new version.

Source: guiutils.py line 1796

Overwrite Confirmation

Confirms overwriting something that is already there, before anything is written.

Cancel

Path: Overwrite Confirmation > Cancel
Kind: Command

Closes this dialog and keeps nothing it was holding.

Source: guiwins.py line 6864

Scene Preview Window

Toolbar, then the scroll area the canvas is drawn into.

Bounds

Path: Scene Preview Window > Bounds
Kind: Option

Outline every component and name it, the way the designer's tree names it.

Source: guiwins.py line 8316

Actions

Path: Scene Preview Window > Actions
Kind: Option

Show what each component does when tapped, and what it writes to.

Source: guiwins.py line 8329

Landscape

Path: Scene Preview Window > Landscape
Kind: Option

Turn the screen on its side and let the layout re-flow into it.

Source: guiwins.py line 8371

Text density

Path: Scene Preview Window > Text density
Kind: Pulldown

A Scene's element positions are stored in device pixels, but its text sizes are stored in Android's sp units. The number that converts between the two is a property of the phone the Scene is shown on, and is not in the backup file.

So it is set here. Raise it if the text looks too small for its elements, lower it if the text overflows them.

Source: guiwins.py line 8394

Snap

Path: Scene Preview Window > Snap
Kind: Pulldown

Round dragged positions and sizes to this many pixels.

Source: guiwins.py line 8428

Screen

Path: Scene Preview Window > Screen
Kind: Pulldown

A Version 2 Scene has no size of its own -- it lays itself out inside whatever screen it is shown on, so there is nothing in the backup file to draw it at.

Change this to see the layout re-flow. A Flow Row wraps differently, and any 'Show when' written against %sv2_render_width is asking about exactly this.

Source: guiwins.py line 8451

Command-Line Arguments

MapTasker can also be run from a terminal, where these arguments do the same job the settings above do in the window:

maptasker [arguments]
Argument Choices What it does
-ai_model The model to use for Profiles and Tasks Ai analysis.
-android_file File location of Tasker backup file on Android device Example: -a-android_file /Tasker/configs/user/backup.xml Also requires -android_ipaddr and -android_port arguments
-android_ipaddr TCP/IP Address of Android device running Tasker server Example: -android_ipaddr 192.168.0.210 Also requires -android_port and -android_file arguments
-android_port Port number of Android device running Tasker server Example: -android_port 1821 Also requires -android_ipaddr and -android_file arguments
-appearance system, light, dark Display appearance mode: system (default), light, dark Example: -appearance dark
-conditions Display the condition(s) for Profiles and Tasks
-debug Print and log debug information
-detail Level of detail to display: 0 = display simple Project/Profile/Task/Scene names only with no details 1 = display all Task action details for unknown Tasks only 2 = display full Task action name on every Task 3 = display full Task action details on every Task with action details (default) 4 = detail level 3 plus global variables 5 = detail level 4 plus Scene element UI details. Example: '-detail 2' for Task action names only
-directory Display a directory of hotlinks for all Projects/Profiles/Tasks/Scenes.
-e, -everything Display everything: full detail, Profile/Task conditions, TaskerNet information, directory, etc..
-file Directory and file name of Tasker XML file to analyze. Example: -file ~/Downloads/backup.xml
-font Name of monospaced font to use in output (default = 'Courier'). Enter font name of 'help' for a list of valid fonts.
-g, -gui Prompt for (these) settings via the graphical user interface (GUI): This argument overrides all other arguments.
-guiview
-i, -indent Number of spaces to indent Task If/Then/Else Actions (default = 4)
-names bold, highlight, underline, italicize Display all Projects/Profiles/Tasks/Scenes in bold, underlined, italicized and/or highlighted text. Example: names underline italicize
-o, -outline Display configuration outline of Projects, Profiles, Tasks and Scenes, and display the configuraion Map (MapTasker_map.txt) in the default text editor"
-preferences Display Tasker preferences
-pretty Make output prettier (one argument/parameter per line)
-profile Display the details for a specific Profile only.
-project Display the details for a specific Project only.
-reset Reset previously saved arguments...start fresh.
-runtime Display all runtime arguments/settings at the top of the output.
-scene Display the details for a single Scene only (forces minimum of "-detail 3").
-task Display the details for a single Task only (forces minimum of "-detail 3").
-taskernet Display any TaskerNet information for Projects/Profiles.
-twisty Hide Task's details under 'twisty' ➤. Click on twisty to display details.
-v, -version Display the program version and license information.
-view_limit

This page is generated from the MapTasker source by build_command_wiki.py. To refresh it after commands are added or changed:

python "Misc Utilities/build_command_wiki.py" --publish

Clone this wiki locally