Skip to content
Taskbar menu RSS feed reader.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
config
menus
widgets
.gitignore
README.md
applet.py

README.md

vaalbara

Taskbar indicator menu multitool made of widgets. Uses Python 2.7, but may at some point be ported to 3.

Requirements

  • pytoml
  • PySide

The Boston Calendar widget needs python_dateutil (dateutil) and bs4 (BeautifulSoup).

Configuration

Vaalbara's config file lives in your OS's equivalent of ~/.vaalbara/config.ini, and uses TOML.

Writing widgets

Widgets must be directories containing an __init__.py that defines main. This main function must accept a Python dictionary of configuration parameters, and must return an XML menu element.

Eventually there might be a DTD. For now:

  • A menu contains text (the text to display) and menu or item elements.
  • An item contains text and optional attributes:
    • An action attribute determines what to do on click. For now, the only implemented action is navigate, which opens the item's url in a web browser.

Widgets that take configuration should also define default, a string containing TOML.

You can’t perform that action at this time.