Package: taskee
taskeeis a command-line tool for monitoringGoogle Earth Enginetasks that can send notifications to your phone or computer to let you know when your tasks finish.Features🔍 MonitorGoogle Earth Enginetasks created with the Python API and/or the Javascript Code Editor💻 Native notifications for Linux, Mac, and Windows:speech_balloon: Mobile push notifications for Android:tv: Built-in CLI dashboardSetuppipinstalltaskeeRun the setup steps below as needed.Earth Engine(required)Set up aGoogle Earth Engineaccount. If you haven't authenticated Earth Engine before, you'll be asked to do so the first time you runtaskee.Pushbullet(optional)If you want to receive mobile notifications (Android only), you'll need to create or connect an account withPushbullet, download the app on your device(s), and install thePushbullet Python APIusingpip install pushbullet.py.
  Once Pushbullet is installed and you're logged in, go to yourAccount Settings, create an Access Token, and copy the API key. The first time you runtaskeewith apushbulletnotifier, you'll need to enter your API key. That key will be stored locally so you don't have to enter it again.notify-send(Linux only)Linux users may need to installnotify-sendto enablenativenotifications. Iftaskeeis not working with thenativenotifier, runsudo apt install libnotify-bin.Usagetaskeeoffers a few different commands which you can see by runningtaskee --help.Usage:taskee[OPTIONS]COMMAND[ARGS]...MonitorEarthEnginetasksandsendnotificationswhentheychangestates.Examples$taskeetest$taskeetasks$taskeestartlog$taskeestartdashboardfailedcompleted-npushbullet-i0.5

Options:--versionShowtheversionandexit.--helpShowthismessageandexit.

Commands:startStartrunningthenotificationsystem.tasksDisplayatableofcurrentEarthEnginetasks.testSendtestnotifications.Starting taskeeThetaskee startcommand initializes and runs the notification system. It will continue running until you cancel it, periodically checking your Earth Engine tasks and sending you notifications.taskee startrequires one argument:mode.Choosing a ModeThere are two modes thattaskee startcan run in:dashboardandlog.dashboardshows a live-updating dashboard that makes it easy to visually keep track of your tasks and events.taskeestartdashboardlogis designed to be run in the background and prints minimal logs as events occur.taskeestartlogFiltering EventsThere are a lot of possible events that can happen to Earth Engine tasks. The list below describes the events recognized bytaskee.EventDescriptioncreated:seedling: A new task is submitted.started:herb: A task starts processing.attempted:fallen_leaf: An attempt fails and the task is restarted.completed:evergreen_tree: A task finished successfully.failed:fire: A task fails to complete.cancelled:axe: The user cancels the task.error:exclamation:taskeecrashes.By default,taskeewill notify you oferrorsandcompletedorfailedtasks, but you can specify which events to watch for by listing them when you launchtaskee. For example:taskeestartdashboardfailedattemptedcancellederrorYou can also useallas a shortcut andtaskeewill notify you of all events.taskeestartdashboardallSelecting NotifiersBy default,taskeewill use thenativenotification system built into your computer's operating system.If you want notifications on other devices, set up Pushbullet and then select it with the-n --notifieroption.taskeestartdashboard--notifierpushbulletLike with events, you can useallas a shortcut andtaskeewill send bothnativeandpushbulletnotifications.taskeestartdashboard-nallOther OptionsYou can set how often tasks are re-checked (in minutes) using the-i --interval_minsoption.taskeestartdashboard-i10Note:taskeedoesn't set a minimum interval, but if updates occur too frequently you may run into rate limits for Earth Engine or Pushbullet.ExampleUsing what we learned above, let's set uptaskeeto start running inlogmode, check forcancelledorcompletedtask events, send us notifications usingpushbullet, and update every30minutes.taskeestartlogcancelledcompleted-npushbullet-i30Other CommandsAside from running the notification system,taskeehas a few more commands that may be helpful.Task SummariesThetaskscommand checks your Earth Engine tasks once, giving you a snapshot of your current tasks in a nice, readable table.taskeetasksTest NotificationsThetestcommand sends a mock notification to any notifiers selected with the-n --notifieroption. You can use this to make sure notifications are set up and working.taskeetest-nnative