This program is not very useful on its own. It's a plugin for EventGhost. EventGhost is an automation tool for MS Windows which listens for events -- whether user-triggered (like the press of a hotkey) or system events (such as the screensaver activating) -- and runs actions you specify. (It's like Tasker for Android, or Cuttlefish for Ubuntu.)
TrayTip is an action plugin (mostly) for EventGhost. It lets you add an action to your macros that shows a pop-up message in the Windows notification area. This message is mostly useful for informing the user of something, but you can also click it to generate an event.
Adding a TrayTip action to your EventGhost macro is no different from most other actions. The configuration dialog prompts you for several items:
The title, message, event suffix, and payload are parsed for python code wrapped in {curly braces}. If you want to include an actual curly brace, you need to double it up, as in "{{".
You can also call
eg.plugins.TrayTip.ShowTip(title, msg, event_name, payload, iconOpt, sound)
directly from a python script action if you wish. The event name and payload
are still optional, and the payload doesn't have to be a string (but is only
parsed for python if it is a string). If iconOpt and sound aren't specified,
they respectively default to the EventGhost icon and sound enabled.
This plugin can generate four different types of event for each notification
shown. In all cases, the event will have the payload you specified, which
can be accesseed from an action by using eg.event.payload.
TrayTip.Show[.event_name]: a new notification is being shown to the user.TrayTip.Hide[.event_name]: the notification is being hidden.TrayTip.TimedOut[.event_name]: the notification went away without being
clicked.TrayTip.Clicked[.event_name]: the user clicked the notification. This is
probably the most useful one to use in your other actions, since it's the
only one that indicates actual user activity.Although the event suffix is technically optional, you should generally give a suffix to each of your TrayTip actions. This way, when an event is triggered, you can easily tell which action caused it by checking the name in the event.
Before version 0.2.0, there was no event name option, and the only way to tell which action generated which tray tip was to check the event payload. This is no longer the case, but the payload field remains in case it is useful.
Official releases of this plugin are being made available at this thread on the EventGhost forums. You can also provide feedback and request support there.
I also accept issues and pull requests from the official GitHub repo for this project, Boolean263/EventGhost-TrayTip.
It would be really useful to create notifications that persist in the Windows 10 Action Center. I haven't found information on how to do that yet.
I'm told you can add buttons to notification pop-ups. That'd be cool too, if I can learn how to make that happen.
%SystemRoot%) in icon paths (thanks topic2k)ShowTip() instead of showTip())