---

MapTasker

Display the Tasker Project/Profile/Task/Scene hierarchy on a PC/MAC/LINUX machine based on Tasker's backup or exported XML file

This is an application in support of Tasker that is intended to run on a desktop running Windows, OS X or Linux (see Note 1).

I found that my Tasker Projects/Profiles/Tasks/Scenes were becoming unmanageable, and my phone was too small to navigate over my Projects, Profiles, Tasks and Scenes. So I wrote a Python program for my desktop to provide a complete map of my entire configuration based on my Tasker backup XML file that I saved to my local desktop drive.

Over time, I refined the map by providing many additional options.

The Tasker backup or other Tasker exported XML can either be manually uploaded to your PC/Mac/Linux/cloud drive, or this program can retrieve it directly from your Android device (see Note 2).

Features

• Your choice of output detail level, from a summary overview to a very detailed level of your configuration.
• Display just a single Project, Profile, or Task.
• Include/exclude Profile and Task conditions: States, Events, etc.
• Just stream everything and/or make the output "pretty" by aligning all of the fields.
• Change the appearance: select 'light', or 'dark' or use the 'system' default.
• Output using your favorite monospaced font, and accent Project, Profile and Task names by making them italicized, bold, highlighted and/or underscored.
• Modify the colors associated with various aspects of the output to suit your mood.
• Include TaskerNet descriptions and/or Tasker preferences.
• For complex configurations, optionally include a dictionary of hotlinks to your Projects, Profiles, Tasks and Scenes.
• Display a diagram of your entire Tasker configuration.
• Command line or GUI interface.
• Use exported XML or fetch the XML directly from your Android device for the configuration mapping.
• Save and restore commonly used runtime settings.
• Ai Analysis option to analyze a specific Project, Profile or Task using either the server-based ChatGPT or the local-based Llama (via Ollama) supported models.*
• Display results directly within the GUI: (Configuration) Map View, Tree View, and Diagram View.*
• Automatic update detection and optional installation of new versions.*

    * Available via the GUI only.

Program Dependencies

- Python version v3.11 (see Note 4) or higher and Tkinter 8.6 or higher

- TKinter 8.6 or higher (see Note 3)

- Tasker full or partial full backup or other exported Tasker XML file

  You will be prompted to locate and identify your Tasker exported XML file (e.g. backup.xml) on your desktop, created by Tasker version 5 or version 6. Optionally, you can retrieve it directly from your Android device (see Note 2).

- Ai Analysis

  This requires a valid ChatGPT API key if using the server-based analysis (See Note 5).

Installation

• Install MapTasker by entering the following command into the Terminal:

  python -m pip install maptasker -U

• To install it into a virtual environment, enter the following command into Terminal:

  • cd xxx, where 'xxx' is a directory into which you want to set up the virtual environment:
  • python -m venv venv
  • source {directory path to 'xxx'}/venv/bin/activate
  • pip install maptasker

• To install it from GitHub:

  • get the zip file by clicking on the 'Code' pull-down menu,
  • select 'Download ZIP',
  • save it into a new directory (e.g. /your_id/maptasker) and
  • uncompress it into that directory.
  • pip install -r requirements.txt ...to first install the prerequisites

Usage

• Enter the command:

  maptasker -option1 -option2 ...

   See below for runtime options.

• If running from the sourced GITHUB zip file, then do the following to run the program:

  python main.py -option1 -option2 ...to run Map-Tasker

• Get started with the GUI: maptasker -g

Program Output

• “MapTasker.html”

  This file will be written to your runtime/current folder, which will be opened in your default browser as a new tab. It will contain the mapping of your Tasker configuration.

• “MapTasker_Map.txt”

  This file will be written to your runtime/current folder as a result of running with the runtime option '-outline'. It will contain a textual diagram of the configuration. It will be displayed in your default text editor. Ensure that 'text-wrap' is off and a monospace font is used when viewing this map in the text editor.

• "MapTasker_Settings.toml"

  This file contains your saved program settings. You can modify this file but care should be taken not to change the field formats (e.g. do not change an integer to a text string). Incorrect values will be ignored.

• "MapTasker_Analysis.txt"

  This file will be created if you run the Ai analysis from the GUI, which holds the response from the analysis. It will be displayed in a separate window along with the GUI.

• "maptasker.log"

  This is a trace log file used for program debugging and will only be created if '-debug' is specified in the runtime options.

More: [Runtime Options]   [Runtime Option Examples]   [Sample Output]

License

This program is licensed under the MIT License.

Notes

1

Windows 11 has been tested and verified to work. Limitations:

• If a conflict arises during installation of 'psutil', then do the following:

  • 'pip uninstall psutil'
  • 'pip install psutil==5.9.8'
  • 'pip install maptasker'

• Notepad does not treat spacing correctly for the configuration diagram (MapTasker_Map.txt). Install an app such as "Typepad" and set it as your default app for opening 'txt' files.

2

To retrieve the Tasker XML file directly from your Android device, you must have the following prerequisites:

• Both the desktop and Android devices must be on the same local network.

• The 'Http Server Example' Tasker Project must be installed and active on the Android device, and the server must be running (see Android notification: "HTTP Server Info..."). Make sure to run the "launch" Task and enter your Google Drive ID.

• The TaskerNet profile, MapTasker List, must be imported into Tasker for the 'List XML Files' button to work in the GUI. You can also first preview this app on TaskerNet.

• Once the XML has been retrieved from your Android device, it is not necessary to keep retrieving it unless it has changed since it is automatically saved on your desktop.

3

To determine the version of Tkinter you are using, run the following command from Terminal:

 'python -m tkinter'

If having problems getting Tkinter to version 8.6, try the following:

• uninstall python
• 'brew install tcl-tk'
• reinstall python

If still having Tkinter version problems, refer to this StackOverflow post.

Python installations that use 'pyenv' version management, take note: tcl-tk has been upgraded to version 9 (brew install tcl-tk), which may cause an error when importing tkinter. If this error occurs:

• If running python 3.11.10 or lower, then the new tcl-tk is not recognized and you will get an import error for 'tkinter'. Issue the commands (in the order specified):\n
  • 'brew uninstall tcl-tk',\n
  • 'pyenv uninstall 3.11.xx'\n
  • 'brew install tcl-tk8'\n
  • 'pyenv install 3.11:latest'\n
• if running python 3.12.4, upgrade to 3.12.7 (the latest): 'pyenv install 3.12:latest'\n
• Python version 3.13.0 works fine with the new tcl-tk.\n

4

If you are unable to upgrade to Python version 3.11 or higher, an older version of MapTasker is still available for Python version 3.10, via the command:

'pip install maptasker==2.6.3'

With this older version, you will not get the benefits offered by the newer version. Refer to Changelog for details.

5

Ai analysis is available through the GUI only. You can run an analysis using a single Project, Profile or Task only. Support is available for server-based OpenAi (ChatGPT) and local-based Llama models.

To-Do List (in no particular order)

• Auto Update Feature

• Fix output column alignment

• Support Windows 11

• Add a runtime option for more pretty output

• Add AI support to analyze Profiles and Tasks

• Save and restore the AI analysis window location

• Add color to the Map View in the GUI

• Add name attributes (highlight, bold, italicize, underline) to the Map View in the GUI

• Display progress bar for diagram view

• Add 'Search' and 'Word Wrap' to the Map view.

• Add 'Search' to the Diagram view.

• Support additional plugins

• Map remaining Tasker preferences

Privacy Statement

No information whatsoever is captured and sent via the network to myself or any other third party, other than that listed below (Network Traffic).

When reporting an error, you will most likely be asked to provide the output log file from the error and your XML file, both of which will be solely used to debug the program and then immediately deleted.

Network traffic is as follows:

• Local LAN traffic when fetching XML directly from your Android device.
• On startup, check against pypi.com to determine if a new release is available.
• Update the program from pypi.com (via 'pip) if 'Upgrade' is selected in the GUI.
• Read file 'maptasker_changelog.json' from 'https://github.com/mctinker/Map-Tasker' if "What's New" is selected in the GUI.
• Use chatgpt.com when using AI analysis with any of the OpenAi models.
• New local Ai models will be loaded from 'https://ollama.com/library'.

Known Issues

• An upgrade to Tcl-tk verison 9 (brew install tcl-tk) may cause an error when importing tkinter. If this occurs, upgrade to the latest available verion of Python: e.g. if running python 3.12.4, upgrade to 3.12.7 (the latest).
• Task actions that are specific to Android 15 have not yet been mapped, and will display as such.
• Open Issue: The background color may not be correct if using the Firefox browser in light mode if the system default is dark mode.
• Open Issue: The Map view Project/Profile/Task/Scene names with icons are not displaying correctly in the Map view if using highlighting (underline, etc.).

Contributions

Taskometer

©Connor Talbot 2021 for Clippy

Tom Schimansky for CustomTkinter

Akash Bora for CTkColorPicker and XYFrame

Ollama and OpenAi

Anonyo Noor for cria