Skip to content
taq edited this page Sep 14, 2010 · 4 revisions

Gtracker – Control your Pivotal Tracker stories from the tray bar

This app will show you your Pivotal Tracker projects, stories and tasks and allow you to mark tasks as completed and “walk” through your stories.

Installation

Just type sudo make install on a GNU/Linux system. To remove, type sudo make uninstall.

Usage

To start to use it, just type gtracker and you should see a small icon on your tray bar.

Authentication and configuration

On the first time you run it, Gtracker will ask you for your user name and password. If you have the gnomekeyring Python module installed, it will use the Gnome Keyring to store your information, if not, it will use Gconf to do that.
Clicking on the icon with the mouse right button, you can also configure some items:

  • The interval you want to check for new stories or tasks
  • If you want your stories descriptions using two lines each
  • If you want to insert a separator between each story

And also can start a manual checking.

Working with your stories and tasks

Clicking with the mouse left button, Gtracker will show you a list of your projects, stories and tasks, but have some filters:

  • It will add only projects with stories with some pending actions, not terminated with a ‘Accept’ event
  • Will only allow you to work with stories with estimated points. Unestimated stories will only be shown on the menu.
When refreshing the project list, Gtracker will only update projects with the last activity time different from the last time it checked.

Stories

You can see your project stories clicking on the project menu item. Stories will be shown using the following format (with two rows of text if marked on the configuration, see above):

  • Name
  • Estimated points
  • Owner
  • If present, how many tasks

You can make stories “walk” thought their states:

  • From unstarted or unscheduled to started
  • From started to finished
  • From finished to delivered
  • From delivered to accepted or rejected

If you mark a story as accepted, its menu item will be disabled. If you mark a story as rejected, it will be enabled to be started again.

Tasks

If a story have one or more tasks, you can see them on a submenu attached to the story menu item. When there is a task submenu, you can’t make changes on your story before completing all the tasks, but if a story state is ‘unstarted’ it will change to ‘started’ when mark a task as completed. After completing all the story task, the submenu will disappear and the story menu item will allow you to make changes on the story.

Statistics

Clicking on Statistics (available clicking on icon with the mouse right button) you can have a screen with some statistics about your work with stories on the current session.