PYSTOPWATCH(1)							PYSTOPWATCH(1)



NAME
       pystopwatch - a stopwatch written in python with a clock and two count‐
       down functions that can minimize to the tray


SYNOPSIS
       pystopwatch &


DESCRIPTION
       pytopwatch is a simple GUI stopwatch emulator with 4 modes:


       Current Time
	      This mode shows the current system time by default  but  may  be
	      adjusted	by the user. To shift the time, press stop, adjust the
	      time accordingly, then press start. "Reset" will reset the  time
	      to the system time.


       Stopwatch
	      This  mode  measures  the	 time  that  has  passed  since it was
	      started.


       Countdown Timer A
	      This mode will count down a given amount of time, e.g.  15  min‐
	      utes. When the time is up, it will trigger the alarm.


       Countdown Timer B
	      This mode will count down to a given time, e.g. 18:00 (6:00 PM).
	      It will also trigger the alarm when the time is reached.



       Left-clicking the tray icon will toggle minimizaion to the  tray	 while
       right-clicking  will  display a menu to access the preferences and help
       dialogues as well as quit  the  application.  This  menu	 can  also  be
       accessed by right-clicking the display frame in the main window.


PREFERENCES
       alarm command
	      If  set,	the  alarm  command will be executed when the alarm is
	      triggered. See the section below for examples.


       alarm text
	      If set, a window will pop up in the center of  the  screen  with
	      this text when the alarm is triggered. The control sequence "%t"
	      will be replaced with the current time as displayed  in  pyStop‐
	      watch. To display a literal "%t", use "%%t".

	      If  the  alarm  text  begins  with "#!", the rest of the text is
	      interpretted as a command and its output will  be	 used  as  the
	      alarm  text.  For	 example, "#!date" would display the output of
	      the "date" command in the alarm text popup window.


       The rest of the options should be self-explanatory.


ALARM COMMAND EXAMPLES
       Always add an ampersand ("&") to the end of your alarm command to back‐
       ground  the  process, otherwise pyStopwatch will lock while waiting for
       the command to finish. Here are some examples of what can be done  when
       the alarm is triggered:


       mpg123 /path/to/some_song.mp3 &
	      play some_song.mp3

       flite "some text to be spoken" &
	      have flite say something

       feh /path/to/some_img.jpg &
	      display some_img.jpg

       /path/to/some/script &
	      run a script or other command


AUTHORS
       Xyne



				   JULY 2010			PYSTOPWATCH(1)