Skip to content

Generated Output

mctinker edited this page Nov 15, 2026 · 13 revisions

Generated Output Files

The files MapTasker writes, and what each one is for. XML files are not listed.

'Current folder' is the folder MapTasker was started from. 'Settings folder' is the one the operating system sets aside for this user's settings: Library/Application Support on macOS, APPDATA on Windows, XDG_CONFIG_HOME or .config on Linux. 'Output folder' is the one set by the Output Folder setting, Documents/MapTasker unless you have chosen another.

Generated by tools/misc/build_generated_files_doc.py from the source. Run it again rather than editing this page by hand.

Views

The map and the diagram themselves, and what the 'Export' button writes.

File Written to Produced by What it holds
MapTasker.html Output folder Every run that displays the map The mapping of your Tasker configuration. It is opened in your default browser as a new tab.
MapTasker_Diagram_Export.md/json/pdf Output folder Diagram view > Export The Diagram view exported as Markdown, JSON or PDF, one file per format.
MapTasker_Map.txt Output folder The Diagram view, or the '-outline' runtime option A textual diagram of the configuration, displayed in your default text editor. Turn text wrapping off and use a monospace font when viewing it, or the columns will not line up.
MapTasker_Map_Export.md/json/pdf Output folder Map view > Export The Map view exported as Markdown, JSON or PDF, one file per format.
MapTasker_Map_Reddit.txt Output folder Map view > Export > Export for Reddit What the Map shows, written as Tasker's own text and indented as a Reddit code block, ready to paste into a post on r/tasker. The same text is put on the clipboard.

Reports

One per command that saves its results. Each is stamped with the date and time it was written, so a run never overwrites the one before it.

File Written to Produced by What it holds
MapTasker_Analysis_date_time.txt Output folder 'Run (AI) Analysis' The analysis the AI model returned for your configuration.
MapTasker_Battery_date_time.txt Current folder -- What keeps the phone busy, Project by Project -- see batteryaudit.py.
maptasker_check_in.txt Current folder -- Not yet described -- see build_generated_files_doc.py.
MapTasker_Compare.txt Output folder 'Compare Files' What differs between two configurations.
MapTasker_Compatibility_date_time.txt Output folder 'Compatibility Check' > Save Report What in the loaded file does not work on a chosen Tasker version, or an older Android, and what behaves differently there.
MapTasker_Find_date_time.txt Output folder 'Find' > 'Save Results' The saved results of a search.
MapTasker_Fix_date_time.txt Output folder 'Fix Findings' What the repairs changed. Kept apart from the Health Check report because that one says what is wrong and this one says what was done about it.
MapTasker_Flowchart_date_time.txt Output folder 'Task Flow' The flowchart drawn for a single Task.
MapTasker_HealthCheck_date_time.txt Output folder 'Health Check' What the check found wrong with the configuration.
MapTasker_Monitor.txt Output folder 'Live Run Monitor' > Save Log What the Live Run Monitor saw on the device: each Profile that became active or inactive and each Task that started or finished, with the time to the millisecond.
MapTasker_NewPhone_Checklist_date_time.txt Output folder 'New-Phone Checklist' > Save Report What is left to set up on a new phone after restoring the backup -- plugins and apps to install, special access to grant, global variables to enter and Profiles to enable -- with what has been ticked off.
MapTasker_Notes.json Current folder -- The user's own notes and tags on Projects, Profiles and Tasks -- see objnotes.py. Kept in the current directory, beside the settings and the Task tests, and never in the backup, so that Tasker never sees them.
MapTasker_Outbound_date_time.txt Current folder -- The inventory of everything the configuration reaches outside itself with -- see outbound.py.
MapTasker_PluginRetirement_date_time.txt Output folder 'Plugin Retirement Advisor' > Save Report The plugins the loaded file uses that Tasker now does itself, the built-in that takes over from each and since which Tasker version, and where the plugin is used.
MapTasker_ProjectDependencies_date_time.txt Output folder 'Project Dependencies' > Save Report Which Projects use Tasks, Scenes and global variables that live in other Projects, with every place that uses each, and what deleting each Project would leave dangling.
MapTasker_Refactor_date_time.txt Output folder 'Refactor' The preview a refactoring operation was applied from, or declined.
MapTasker_Replace_date_time.txt Output folder 'Find' > 'Replace' The preview of a replacement: what would change, before anything does.
MapTasker_Resources_date_time.txt Output folder 'Missing Resources' > Save Report The files, folders, images, sounds, Scenes and apps the configuration uses that the device did not have, with every place that uses each.
MapTasker_TaskerNet_date_time.txt Output folder 'TaskerNet Updates' > 'Save Report' What the author of a TaskerNet share changed since the version you have, and how your copy compares with the published one.
MapTasker_TaskFlow_date_time.txt Output folder 'Task Flow' Every Task's If/Else/For/Goto structure, linted.
MapTasker_TaskTests.json Current folder -- The Task test cases the user has saved -- see taskcases.py. Kept in the current directory, beside the settings.
MapTasker_TaskTests.txt Current folder -- The saved report of a run of them.
MapTasker_Timeline_date_time.txt Output folder 'Timeline' What has changed in your own configuration since an earlier snapshot. It is the comparison report under another name, so that 'what changed since Tuesday' does not land on top of a comparison of two separate files.
MapTasker_Trend_date_time.txt Current folder -- Not yet described -- see build_generated_files_doc.py.
MapTasker_VarXref_date_time.txt Output folder 'Variables Xref' Every variable, and everywhere it is set and read.
Tasker Current folder -- Not yet described -- see build_generated_files_doc.py.
trend_metrics Current folder -- Not yet described -- see build_generated_files_doc.py.

Settings and remembered state

What MapTasker carries from one run to the next. Deleting any of these costs you the setting, not the configuration.

File Written to Produced by What it holds
.maptasker.pkl Current folder Older versions only Where the AI API keys used to be kept. It is no longer written; a leftover one is moved into the system password store and removed. Hidden.
.maptasker_changelog.txt Current folder The version check The change log fetched for a newer version, kept so it can be shown without fetching it again. Hidden.
.maptasker_last_run.txt Current folder Every run The date of the last run, so that a once-a-day check happens once a day. Hidden.
.MapTasker_RunCount.txt Current folder Every run How many times MapTasker has been run. Hidden.
.MapTasker_Settings.pkl Current folder Older versions only A second settings file that never held anything. It is no longer written, and a leftover one is deleted unopened. Hidden.
MapTasker_API_Keys.json Settings folder Saving an AI API key Only written on a machine with no system password store. Otherwise the keys go to the Keychain on macOS, Credential Manager on Windows, and GNOME Keyring or KWallet on Linux, and this file is never created.
MapTasker_Apps.json Current folder 'App not listed?' The Application list fetched from the device, kept between runs and keyed by device. Nothing is lost if you delete it; it is fetched again.
MapTasker_NewPhone.json Current folder 'New-Phone Checklist' ticks Which items of the New-Phone Checklist you have ticked off, kept between runs. Never part of the backup. Delete it, or use Clear ticks, to start the next phone.
MapTasker_Resources.json Current folder 'Missing Resources' What the last check of the device found, per device, so the Health Check can report it without going to the phone. Nothing is lost if you delete it; the check is run again.
MapTasker_Settings.toml Current folder Every run Your saved program settings. You can edit it, but do not change a field's format -- an integer turned into a text string, say. Incorrect values are ignored.
taskernet_catalogue.json Inside 'MapTasker_Timeline' 'TaskerNet Updates' > 'Find Links' TaskerNet's public listing of shares, kept for a week so that finding links does not read the whole listing again each time. Delete it and it is fetched again.
taskernet_links.json Inside 'MapTasker_Timeline' 'TaskerNet Updates' Which TaskerNet share each linked Project, Profile, Task or Scene came from, and the version of it you have. Only the share's address is kept, never your configuration. Delete it and the links are lost; they can be made again.

Folders

Made by MapTasker where they are needed, and recreated if you delete them.

File Written to Produced by What it holds
MapTasker_Backups Beside the file being saved Any save that would overwrite a file A copy of a file taken just before a save would overwrite it, with only the ten newest kept per file. Nothing is copied if there is nothing at the target path. Old copies are removed for you, and you can delete single copies or the whole folder at any time without breaking anything -- it is recreated the next time a save needs it.
MapTasker_Timeline Current folder 'Timeline' The history of your configuration, used to track what has changed. The thirty most recent differing configurations are kept, each one compressed.
taskernet_baselines Inside 'MapTasker_Timeline' 'TaskerNet Updates' A compressed copy of each linked share as its author published it, kept as the version you have so that the next update can say what the author changed.

Android

Written on the device by the Tasker helper Tasks, and read back by MapTasker over the HTTP API.

File Written to Produced by What it holds
maptasker_apps.txt Android device, 'Tasker/' 'MapTasker Get Apps' The device's installed applications: package, name and activity.

Diagnostics

Only written when something is being looked into.

File Written to Produced by What it holds
.maptasker_error.txt Current folder A failed parse How a parse failed, written so the window that asked for it can report the error rather than lose it. Hidden, and removed once it has been read.
buildit.log Current folder The '-debug' runtime option The messages from checking Tasker's state and event codes against its own list. Only written with '-debug', and added to rather than replaced.
maptasker_debug.log Current folder The '-debug' runtime option A trace log for program debugging. It is only created with '-debug', and a runtime error tells you to look here.
trace_log.txt Current folder A developer's trace A line-by-line trace of the program running. Nothing in a normal run writes it: it exists only when the trace hook in the source is switched on by hand, and it is cleared each time MapTasker starts.

Tasker helper Tasks

Not files, but the other half of the Android story: each helper Task is added to Tasker through the HTTP API the first time you use the feature that needs it, and only if a Task of that name is not already there. The 'vx' is a version, such as 'v2'. They are what write the files in the Android table above.

Task What it does
MapTasker Get Apps vx Gets the device's installed apps -- package, name, activity -- and matches each app name to its own package.
MapTasker List Files vx Lists the files on the device. It replaces the old 'MapTasker List' TaskerNet Profile.
MapTasker List Tasker Objects vx Lists all Projects, Profiles, Scenes and Tasks in one run.
MapTasker Backup For ID Check vx Runs Tasker's Data Backup so ids can be checked after an import. The backup is only held in memory and is deleted from the device.
MapTasker Run Task vx Runs one of your Tasks by name and returns what it returned, passing %par1 and %par2 through. 'Run On Android' uses it for names Tasker's HTTP server cannot look up, such as '$Taskaroo'.

Each kind of import has a Task that opens the file: MapTasker Open Profile vx, and the same for Project, Scene and Task. (Earlier versions also installed a MapTasker Send ... vx for each; it did not work and was removed. If your phone still has them, the List Helper Tasks button names them as leftovers you can delete.)

Clone this wiki locally