Repository navigation
Generated Output
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.pyfrom the source. Run it again rather than editing this page by hand.
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. |
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. |
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. |
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. |
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. |
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. |
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.)