Stopwatch for Cinnamon
This is a very simple to use Stopwatch Applet which can have multiple instances in the panel. In its basic form it is controlled completely by clicking the Applet - the first click starts it and it displays an increasing time, the second click pauses it and a third click resets it ready for the next time. The display starts with minutes and seconds and maintains a constant width, for example two minutes and 7 seconds is 02:07 to avoid jitter. If the time exceeds one hour it goes to 01:02:03, over a day and the days are displayed in the tooltip. To aid knowing the status at a glance it is grey when Ready, green when Running and orange when Paused and the tooltip always displays the Heading of the instance, the status, time and what the next click does.
It is useful to have a very simple timer quickly and permanently available in the panel, in particular if you are operating on internet connections where you are paying by the minute such as the satellite links I sometimes use. It is complementary to the The Network Usage Monitor Applet (NUMA) enables one to continuously display the speed and data usage on a selected interface when charges are for data usage. The styling is consistent with NUMA and my Battery Applet with Monitoring and Shutdown (BAMS) providing a monitoring suite for mobile users. There are of course many other stand alone uses.
The Settings Screen can be reached from the right click menu as well as System Settings -> Applets. It enables you to:
- Set the refresh interval - use a slow refresh if you have multiple active counters and/or a slow machine - the default is every two seconds, one second is more pleasing as it gives a continuous count.
- Provide a meaningful heading (title) for the counter which is displayed in the first part of the tooltip - useful for identification if you have multiple instances of counters - default is Stopwatch.
- Change the mode from the default sequence on clicking of 'start -> pause -> reset' to 'start -> pause -> continue -> pause -> continue etc'. In this continuous mode mode one needs the Right Click (Context) Menu to reset the counter.
- Provide Option to display the Heading in the applet body as well as count.
- Enable some experimental functions
The Right Click (Context) menu has options to:
- Start the counter - only for completeness
- Pause the counter - only for completeness
- Reset the counter - required in 'continuous mode'
- Continue counting from the count before pausing - as per the continuous mode.
- Continue counting as if it had not been interrupted - mainly useful if you have clicked and paused by mistake!
- Edit Counter Heading
- Open the Settings Screen from within the Applet
Expand a drop down Housekeeping and System menu which also allows:
- Viewing the Version and Change log
- Opening the Help file
- Open and edit the stylesheet.css file (Advanced users)
- Opening the Gnome System Monitor - this allows one, for example, to check the processor overheads in running multiple instances at high refresh rates on a low powered machine.
And that is about it - the help file is hopefully redundant as there is always full information when you hover over options on the Settings screen or the Applet itself.
There is one additional attribute. The applet was not only intended to be useful in its own right but is also intended to provides a 'tutorial' framework for other more complex applets with many sections of code reusable and fully commented. One useful example is that it provides a sample Settings Screen and a 'standard' right click (context) menu which opens the Settings Screen and a Housekeeping submenu accessing help and a version/update files (which live in the applet folder). It also shows how to run the gnome system monitor program in case you want to find out how much machine power this applet is using at various update rates. Items with a ++ in the comment are not specific to this applet and may be useful for re-use.
- If you run over a day the days are only shown in the tooltip and the Applet has a red background to warn you rather than extend the size of the Applet.
- This Help file can be edited to include your own notes but may be overwritten if a new version is loaded.
- The styling can be changed and there is 'persistence' mechanism described in the stylesheet.css file itself.
- Ideas and code has been provided by by @100k (Łukasz Dobrowolski) for the major modifications in v 2.2.0
- Thanks are given for the contributions from @collinss and @Odyseus to help harmonise the menus in all my applets with other applets and for support and suggestions from @jazhicks at various times.
- l10n support is thanks to ideas from @Odyseus, @lestcape and @NikoKrause
Although comments and suggestions are always welcome any contributions which are contemplated should follow discussion. Changes can have many unintended consequences and the integrity of the applet is paramount. Unsolicited Pull Requests will never be authorised other than for urgent and critical bug fixes, changes by the Cinnamon Team and translation support.
- Download from Cinnamon Spices
- Unzip and extract folder stopwatch@pdcurtis to ~/.local/share/cinnamon/applets/
- Enable the applet in Cinnamon Settings -> Applets
- You can also access the Settings Screen from Cinnamon Settings -> Applets
Last significant update: 30th October 2019
- Adds Multiversion to fix bug when new version used with Cinnamon 3.6 and earlier - reverts to earlier version
- Adds an option in Configure... to display Counter Heading in Panel.
- New single line layout for Start, Pause, Reset, Continue and Continue from Start Time in Context Menu
- Adds ability to edit Counter Heading in Context menu as well as Configure..
- Adds option in Configure... to add experimental functions such as an ability to modify time by buttons in Context (right click) Menu - a possible precursor to a flexible timer function
- Implements changes proposed by @100k (Łukasz Dobrowolski)in #2648 and uses code provided by him to implement his suggestions.
- Minor changes in stylesheet.css to match the other applets in the suite..
- Closes #2648
- Update stylesheet.css to better match Cinnamon 4.0 System Styles.
- Use xdg-open in place of gedit or xed to allow use on more distros
- CHANGELOG.md added to applet with a symblic link from UUID - CHANGELOG.md is now displayed on Cinnamon Spices web site.
- CHANGELOG.md is a simplified version of the existing changelog.txt
- Applet updated so CHANGELOG.md is displayed from context menu.
- README.md in UUID is now symbolic link from UUID
Improved translation (l10n) Support:
- UUID set from metadata.uuid so no need for explicit definition.
- new _() function now checks for system translations if a local one not found.
- l10n support based on ideas from @Odyseus, @lestcape and @NikoKrause
- Bug corrected - typo of a comma, not stop.
- Use of this.UUID = metadata.uuid removed.
- Version numbering harmonised with other Cinnamon applets and added to metadata.json so it shows in 'About...'
- icon.png copied back into applet folder so it shows in 'About...'
Changes resulting from cinnamon-spices-applets switch to Github and new Cinnamon Spices Web Site
- Change helpfile to use README.md instead of help.txt in applet folder
- Remove icon.png and help.txt from applet folder
- Released 01-02-2017
Changes for Mint 18/Cinnamon 2.8
- Use Cinnamon version to choose text editor (gedit -> xed) to view changelog, help etc
- Pick up Cinnamon Version from environment variable CINNAMON_VERSION rather than settings window
Modifications for Cinnamon 2.0
- Add cinnamonVersion to settings to allow Cinnamon Version to be specified and thus inhibit extra settings menu entry
- Inhibit counter updates after counter removed from panel
- Added radiused border to background colours and made them configurable via a stylesheet (stylesheet.css in the applet folder).
- Changed from red background when days greater than 1 to a red border so one still knows if it is paused or counting.
- Extra menu item added to open stylesheet.css
- Released 04-09-2013
- Initial version tested with cinnamon 1.8
- Released 01-09-2013