mozdev.org

mozdev.org - simpletimer: index

Install the current version of Simple Timer (from AMO)
Install older versions of Simple Timer (from AMO)

Change log for latest version Simple Timer 1.9
 (June 30, 2010)


What can
Simple Timer do?

Various clock and timer functions, including:

Detailed description

Downloading this extension places a blue alarm clock icon in your statusbar. You can drag and drop the icon anywhere upon the statusbar. Features are available via a context menu (right-click on icon).

Context menu

Lets examine each menu item in detail

Clock

Displays the time in the format and language (ie. AM/PM) of your locale. In the Options dialog you can toggle on/off the seconds portion of the display, and you can choose to use the 24 hour format if you are in a locale that normally uses a 12 hour clock. Or you can choose to display an Epoch clock,  which displays the number of seconds since Jan 1, 1970 GMT 0:00. There is also an option to append a formatted date to the display. Middle-click displays the icon again. Why would you want a clock when Windows, for example, displays a clock in the taskbar?  Some people like to hide their taskbar!

Notify Me At...

This will display the Notify Me At This Time dialog where you can set a specific time of day to receive a notification. Lets see what it looks like.

As you can see, the upper half "Enter Notification" is where you supply the notification info, while the lower half is a table of existing notifications. You can enter as many notifications as you like.
The fields are:

Description -- an optional field which is displayed when your notification completes (assuming you have enabled a visual alert in the Options dialog), and in the Full tooltip (also enabled in Options dialog).

URL -- an optional field. Click on Bookmark (this feature not available in Thunderbird), to the right of the textbox, to copy your browsers current webpage URL into the textbox. This little bookmarking feature allows you to display a webpage upon completion of the notification. If you have enabled dialog alert in Options dialog, this URL is displayed in the Notification Completed dialog, and clicking on the "Open URL" button will open the associated webpage in a new tab. If instead you have enabled audio and/or popup alert in Options dialog, the webpage is opened in a new tab automatically. In the image above, at 10:00 PM an ebay webpage will be opened when I hope to sneak in a last-minute bid.

Time -- a mandatory field which indicates when the notification is issued. This field will originally show the time when you opened the dialog, in the language and format of your locale. Click on the hours, minutes (and AM/PM if shown) subfields to edit them, using the spin buttons or your keyboard's up and down arrows.
You can set multiple notifications for the same time (for instance, have them open different web pages via Bookmark), but a warning dialog is displayed, and the duplicate entries are highlighted in the table.
You can also set notifications for the same time, but different days (no warning dialog in this case).

Recurring -- an optional field. If left unchecked, this notification is one-time only. If checked, this notification will repeat, as indicated by the value of the dropdown box to the immediate right. You can set a value of Daily, Weekdays (Monday-Friday), Weekends (Saturday-Sunday) or a specific day of the week.

Now you are ready to enter your notification. If you are just entering one notification and don't care to see it entered in the Notifications table, you can click Add/OK button, which adds the notification and dismisses the dialog. If you are going to enter another notification, or just want to see it in the table, click the Add button to the left of the table.

Note that when opening the Notify Me At This Time dialog, any existing notifications are displayed in the Notifications table.

Editing notifications in the Notifications table:

    - Delete button -- after selecting a notification in the table, this deletes it.
    - Del All button -- deletes all notifications.
    - Reset button -- restores the table to the state it was in when opening the dialog.

    - Clicking the Recurring column of the table toggles this field (checkmark) on/off. This also affects the Day column: when Recurring is toggled off, Day becomes blank, when toggled on, Day assumes a value of Daily.

    - Double-clicking any of the other fields allows complete editing by moving the notification info back to the upper-half (Enter Notification) of the dialog. Make your desired edits up there, then click Replace (the label on the Add button changes to Replace during a double-click edit) to replace the notification in the table.

When a notification is set and pending, the alarm clock icon in the statusbar (when displayed) will be red instead of blue. 

Count Up

Starts a count up from zero in the statusbar. Hours, minutes and seconds are displayed. If you left-click the display, the count is paused. Another left-click resumes the count. Middle-click stops the count and displays the alarm clock icon in the statusbar. If you are using the Full tooltip (see Options) the completed time of the last count up is displayed.

Count Down...

This displays the Countdown Time Entry dialog, lets look...

Countdown dialog


As you can see, the upper half "Enter Countdown" is where you supply the countdown info, while the lower half is a table of existing countdown timers. You can set as many timers as you like.
The fields are:

Description -- an optional field which is displayed when your countdown completes (assuming you have enabled a visual alert in the Options dialog), and in the Full tooltip (also enabled in Options dialog).

hrs, mins, and secs - enter your countdown time (less than 24 hours). Use the spin buttons or your keyboard's up/down arrows to set the values.

Recurring - if this checkbox is ticked, the countdown will continually restart immediately upon completion.

Now you are ready to enter your countdown timer. If you are just entering one timer and don't care to see it entered in the Countdown Timers table, you can click Add/OK button, which adds the timer and dismisses the dialog. If you are going to enter another timer, or just want to see it in the table, click the Add button to the left of the table.

Note that when opening the Countdown Timer Entry dialog, any existing timers are displayed in the Countdown Timers table.

Editing timers in the Countdown Timers table:

    -
Delete button -- after selecting a timer in the table, this deletes it.
    - Del All button -- deletes all timers.
    - Reset button -- restores the table to the state it was in when opening the dialog.

    - clicking the Recurring column of the table toggles this field (checkmark) on/off.
   
- double-clicking the Description column of the table allows you to edit. Change focus ( ie. click elsewhere in the dialog) to apply the edit.

If you have a frequently used list of timers, you can save the list (shown in the Countdown Timers table
) by clicking the Save List button. You can then load the list at a later time using the Load List button.


Clicking OK or Add/Ok starts the countdown in the statusbar. The timer which will expire the soonest is displayed in the statusbar. If you have set multiple timers, you can see the current time remaining for them if the appropriate tooltip option was selected (see Options below).

Left-click the statusbar display to pause the countdown, another left-click resumes the countdown (this can be disabled in Options), while middle-click stops the countdown. This only affects the timer that is displayed in the statusbar. If you have other timers set, they are not affected.

If timers are running when you close your browser, they will be automatically restarted when you next open your browser. It will appear as if the timers were running while your browser was closed. You also get a slider alert when reopening your browser, reporting the status of these timers.

The alert you receive when the countdown is completed is set by you in Options. 

Pause/Resume

Pauses or resumes a count up or countdown. Same as left-clicking the time in the statusbar. Note that disabling the pause/resume function via left-click on statusbar display (in Options) does not affect this menu item.   

Stop/Reset

Stops a count up, countdown or clock and displays the alarm clock icon in the statusbar. Same as middle-clicking the time in the statusbar.

Kill Audio Alarm (.ogg)

This item is disabled unless playback of an .ogg audio alarm is in progress. This will stop the playback. Note that if you have enabled dialog notification (see Options->Notifications), closing that dialog when it appears will automatically stop any audio alarm.

Options...

This opens a dialog titled Preferences. There are four tabs, the first is Notifications.

Notifications pane

In Notification Options, you can define what type of alert to receive when a countdown or notification completes. 

If you check "Enable audio notification", the dialog expands to allow you to choose an audio file to play when the timer completes. You can choose one of the preset audio files, or choose your own custom  file. Click on Browse (when Custom is selected) to search your file system. You can use a .wav file or (if you use Firefox 3.5 or better) an .ogg (Ogg Vorbis) file. The .wav file should not be more than a few seconds in duration to play reliably, but an .ogg file can be of any length. Convert your favorite .mp3 to .ogg format and give it a try!
You can preview the audio files by clicking on the listen icon beside each file.

You have two visual alert options, you can select both if you like but probably you will want only one.

If you check "Enable popup notification", the alert will be a small window that slides up from the bottom of the screen, holds there for a few seconds, then slides down.

If you check "Enable dialog notification", the alert will be a small dialog that appears in the center of the screen. This option has the ability to repeat the audio alarm (if enabled) at intervals you can select, up to n times (you select n). If you don't want to repeat the audio alarm leave n set to 0. This option can be useful if you may be away from the computer and you don't want to miss the alert. Note that the interval can be positive or negative. A positive value indicates an interval in minutes, while a negative value indicates an interval in seconds. In the image above, I have set an interval of 3 seconds. This short interval will have the audio alarm simulate a digital clock alarm, repeating every 3 seconds up to 49 times. You should use a very short custom .wav file in conjunction with such a short interval.

If you want to repeat a long .ogg audio alarm, just set some small interval like 1 second (-1). 

If more than one timer expires, you will see multiple dialogs displayed, but only one repeating audio alarm for all of them. Closing a (the) dialog stops the audio alarm.
The completion time is displayed in the titlebar of the dialog.

The second tab of the Preferences dialog is Positioning.

Positioning tab

You can display the icon/timer/clock in the statusbar (default), toolbar or both (just for fun!). Statusbar drag and drop is supported.
Most themes (including the default) will show a vertical red line between statusbar panels, while dragging, to show where the drop will occur if you release the mouse at that time.
To use the toolbar display, select Toolbar here. Then, if this is your first time selecting this, you must drag the SimpleTimer toolbar button (blue alarm clock) from the toolbar button palette to the toolbar. You can use the navigation or bookmarks toolbar. To open the palette, right-click the toolbar and select Customize...

The third tab of the Preferences dialog is Clock.

Clock tab

Set how you want to display the clock on your statusbar/toolbar. There are three sections to this tab:

The fourth tab of the Preferences dialog is Miscellaneous.

Miscellaneous tab

Startup Options --  Select the function to perform automatically at startup.

Event  Logging  --  Tick  the  checkbox  to  enable  logging  of  completed  count ups,  count  downs,  and notifications. The text box will contain the path to a default log file, which is in the SimpleTimer folder within your Firefox profile folder. If you would like to use a different folder,  then click the Browse... button to navigate to, then select, your folder. A file "eventLog.txt" will be created in that folder. The log is a text file encoded as UTF-8. If you want to revert back to the default file, just click the "Reset Default" button. Finally, you can select the number of days to retain a logged item, from 0 to 90 days. A value of zero means do not perform automatic deleting.

Left-click on Icon Action -- Define the action to take when left-clicking on the alarm clock icon.

Pause/Resume --  tick the checkbox  to  disable Pause/Resume, by left-click on statusbar display, of countup/countdown. Pause/Resume still functions via context menu.
 
Tooltip Options -- Choose the type of tooltip to display. The "Full" option will display the date, notifications pending, countdown timers, elapsed time of your current browser session, and the elapsed time of your last Count Up. The "Date only, with clock only" option will display a date tooltip only when the clock is displayed. Date is displayed in the language and format of your locale.


Event log...

Displays the Event log dialog, lets see...

Event log dialog

The event log contains data about your completed count ups, count downs, and notifications. You can change the dimensions of the dialog by dragging its edges. You can also change the width of the tree columns by dragging the little seperators between the column headings. In the upper-right position of the column headings is a small image, which is a column picker. Click on it to display a drop-down list of the tree columns. Use this to hide/show individual tree columns. All of this is "remembered" the next time you open the dialog. If you have set a non-zero value for"Delete log entries after n days" (see Options... above) , entries that meet this criteria are automatically deleted from your log file (this clean up processing occurs when you open the event log dialog). You can also clear the entire log by clicking  the "Clear log" button.
A Status value of "Expired" indicates that this one-time notification or count down "completed" while your browser was closed.
Values of "N/A" means this column is not applicable to this event type.

Visit Home Page

Links to this webpage.

Documentation

A submenu with links to specific topics within this webpage.

About

The About menu item has two tabs, a Credits tab and a Changelog tab (where you can quickly see the changes made to the latest version).

Contact me at grbradt@yahoo.ca with any comments

The simpletimer project can be contacted through the mailing list or the member list.
Copyright © 2000-2014. All rights reserved. Terms of Use & Privacy Policy.