Timer with Notifications 1.0.2

UUID: timer-notifications@markbokil.com
Score: 26


A simple timer app with a countdown in minutes. It is modeled after a kitchen timer. I wanted something easy to remind myself to get up every hour and stretch. To jazz it up a little the timer can play a sound, flash a message, open the applet menu, or plaster a confirmation dialog on the screen -- hard to miss. You can display several notifications at once, such as displaying the confirmation dialog while playing an alarm sound. The app defaults to just a message, the app menu being popped open, and a minutes countdown label on the panel. The label can be disabled in config.js

To set the sound, message, or confirm dialog edit the ~/.local/share/cinnamon/applets/timer-notifications@markbokil.com/config.js file. You can right-click applet to edit the config file. Select right-click Restart Cinnamon to reload the applet after editing.


To Install

0) Add sox play if you want sound capability: sudo apt-get install sox

1) Extract to ~/.local/share/cinnamon/applets

2) Enable the applet in cinnamon settings

3) Restart Cinnamon if you change the config.js file. Right-click applet > Restart


Next features 1.0.3:

  • Add GUI for options and save to gsettings schema avoiding config.js approach.

1.0.2 - centered confirm dialog text, added restart to right-click menu, fixed 3 min preset error, added panel label countdown
1.0.1 -  added run, stop, alarm states to icon, added 3 min. tea time, centered dialog button with CSS, tweaked slider code to reset icons timer/on off if dragged to zero, added right-click edit menu.
1.0.0 - stable release.

About The Author


I work on bridging together computers with psychology. I have a  passion for Linux and cool technology. I previously worked on Firefox extensions, JSP, PHP and Flash Actionscript. I live in the Boston area. If you want to contact me you can reach me at mark[dot]bokil[at]gmail.com


  1. damnemo says:

    9 months ago

    Hi, this app not work for me, i have debian squeeze 7.2 cinnamon two error: - the sound not play (i try to change line338-> 'play' with 'mpg123', i install this) - and notify-send (it's possible with zenity?) Please how can i do for this? Thanks

  2. rhill says:

    11 months ago

    Around line 128 of applet.js, there is a call to a non-existing function: this._initContextMenu(); This cause the applet to be stuck in the tray even when applet is deseselected from Applets selector.

  3. sujitnag says:

    1 year ago

    I use linux mint 13 cinnamon 1.6.7. I do, 0) Add sox play if you want sound capability: sudo apt-get install sox 1) Extract to ~/.local/share/cinnamon/applets But not available in cinnamon setting applet list. then I add it on /usr/share/cinnamon/applets but still , not available in cinnamon setting applet list. help me.

  4. mrmfldmn says:

    1 year ago

    Great applet, thanks! I couldn't get sound to work so far though :-( Exchanging line 338 with jdgallag's suggestion did not solve the issue. Manjaro 0.8.4, sox installed and working. Any ideas? Help would be appreciated.

  5. postNuKe says:

    1 year ago

    Perfect, i was needing it when I'm cooking and I'm putting in front of my pc ;)

  6. jdgallag says:

    1 year ago

    Hello, to get sound to work, I had to change line 338 from "Util.spawnCommandLine("play " + this.SoundPath); to "Util.spawnCommandLine("play " + AppOptions.SoundPath);

  7. RedGhost says:

    1 year ago

    @mbokil Thank you so much for this wonderful and useful applet ! I appreciate the time and work you have put into it. It has been such a great tool for me... Thanks again.

  8. mbokil says:

    1 year ago

    I will take a look at panel issues this week. I am on vaca and have some time to release an upgrade. -Mark

  9. Orb-miser says:

    1 year ago

    Nice little applet but found 2 issues with it using Mint Cinnamon 14. 1) Will not allow you to move it in panel edit mode it sticks to where it appears. Un-tick it and restart cinnamon and is gone. restarting and selecting shows in same position and can't move it. 2) Un-selcting in Applets doesn't remove it automatically like others. Requires a Cinnamon restart to go away. Fix these two issues and would be happy to use on a regular basis. But needs to conform to my alignment of applet use. .

  10. mathrick says:

    1 year ago

    I was going to leave a comment before I saw that @goldfish_23 described exactly my problem. For completeness' sake, I will mention this is Cinnamon 1.6.7 running on Nadia, with two panels layout.

  11. mrdarksys says:

    1 year ago

    Russian Language does not supported. )= I edited config file (in UTF-8) and change "Time Up!" on "????? ??????!", but message appears with unreadable symbols when alarm is triggered.

  12. goldfish_23 says:

    1 year ago

    Hi Mark, Thanks for developing this applet. I love the idea, however it's not working as intended. I cannot move the applet's location on the panel. Right clicking doesn't bring up options if the timer has been started until Cinnamon is restarted. The applet isn't removed after removing using Add/remove Applets until Cinnamon is restarted. I agree the artwork is good and the idea is well executed but something is very wrong. I hope it can be fixed. If there is anything I can do to assist please advise. :) Best Wishes, goldfish #23

  13. robertvpitt says:

    1 year ago

    thank you very much: this is one wonderfull script-plain and simple idea: your digital art is crystal clear :)

  14. eitland says:

    1 year ago

    Hi, and thanks! Just wanted to mention what I think is a good source of inspiration for any timer app: http://www.mediaatelier.com/Alarms/ Description: Pull down from app (mac, menu on top) while pressing the left mouse button sets a count down sets an increasingly long countdown. Click on the app and it shjow you a timeline where you can add multiple reminders on a timeline. (There is more to it but these two are the important ones I think.) (To justify my suggestion of downright copying the features: If Alarms was available on Cinnamon I guess I'd happily pay another 12$ to the original author. : )

  15. mbokil says:

    1 year ago

    @heniquefm, I think there might be a small bug in the Timer applet. Let me see if I can reproduce it and I will upload a fix by around 8/18. -mark

  16. henriquefm says:

    1 year ago

    Hi, thanks for the applet, it's really useful. I have two minor issues though. Whenever I add the timer, the calendar applet is pushed to outside the screen: http://i.imgur.com/nmWIx.png - when I remove the timer, the calendar comes back. And every time I remove the timer using the "Cinnamon Settings - Applets" window, it doesn't go away. I have to restart cinnamon to remove it. I tested with other applets and the timer seems to be the only one with these issues. I think there's a bigger chance that these are problems with cinnamon rather than with your applet, but I'm just guessing. If you want some more info, I'll be happy to help. Henrique

  17. mbokil says:

    2 years ago

    I will see what I can do about adding seconds. There is already a pomodoro extension on gnome shell. I will take a look at it and see if I can do a new fork of the current timer. Keeping them separate is probably best.

  18. MiguelAngel says:

    2 years ago

    Hi: great applet, congrats, justa a suggestion... could you be able to make a preset in which the times counts down 25 minutes and after that expires makes an advise and right away starts counting down another 5 minutes?? It is related to a task management system called pomodoro technique and you could rename it so people will be able to know that we can use it for our work managament. On gnome there were applets called pomodoro that did this and I think that having an integration with your applet would be wonderfull and usefull for other uses. I would do it myself but have no clue on coding... lame. Cheers

  19. winnerer says:

    2 years ago

    Not bad, but it would be better if it has shown minutes and seconds in popup not only minutes.

  20. mbokil says:

    2 years ago

    @cgrantmccool you would need to add a separate doTimePreset2xx method for each new time you add. If you can't get it to work let me know and I can customize it for you. Email me directly at mark[dot]bokil[at]gmail[dot]com. I will see what I can do about finishing up the settings GUI to make it easier to change.

  21. cgrantmccool says:

    2 years ago

    Thank you for your work, very useful and very needed applet. I'm respinning LM13 Cinnamon to work for the high school and college debate communities and a timer with sound/pop-up messages has been a missing piece in our transition away from Gnome 2.x Mate has simply not been working out as an option for us and so Cinnamon has been a project I've watched closely. As ergosys said, however, a better way to change the presets would be very useful. As it is, my customization of it loses the entire menu and kills all functionality with the timer. Trying to change it around to be 3, 4, 5, 6, 7, 8, 9 and 10 minute pre-set times to co-incide with Speech and Debate speech, cross-examination, rebuttal and preparation time pre-sets. When trying to change the presets, all goes broken. Still, the slider means its usable, and that's good enough for me!

  22. mbokil says:

    2 years ago

    @ergosys - Next version will have a settings dialog, text fields, and buttons.

  23. ergosys says:

    2 years ago

    It would be useful to be able to configure the presets. Currently you have to edit the code to have any kind of funky preset. But otherwise, works very well, thanks!

  24. mbokil says:

    2 years ago

    @mdyter your welcome. They were good ideas. I find the app much more useful now.

  25. mdyter says:

    2 years ago

    @mbokil Thank you for your work !

  26. mbokil says:

    2 years ago

    @mdyter app has 3 icons now: run, stop, alarm on. Also I added a countdown label for the panel. It can be turned off in config. Right-click Edit, right-click Restart.

  27. mbokil says:

    2 years ago

    I think I have decided on a 3 state icon: stopped, running, and time expired (alarm). The visual feedback should make it more useful.

  28. mbokil says:

    2 years ago

    The timer should be relatively accurate. It uses the system time and then has a background timer thread which compares the current time to timer start time on a one second loop. I should give credit to @dalcde. The system time idea came from his code. I wanted something a little more practical I can use at both work and home. I will probably add a 3 min. preset since that is a good tea steeping time.

  29. mbokil says:

    2 years ago

    @Oyabunbaba - that's a good idea. I will try it. That is why feedback is really helpful. I was getting ready to sketch out complicated desings and then fireup Inkscape, which I can barely use. Negative version is much more practical. The icon is not mine but comes from clipart. I just fixed it in inkscape so it is symbolic like and the background is transparent.

  30. Oyabunbaba says:

    2 years ago

    Hi, practical applet, thx. This icon looks actually good, so what about negative version of present icon ;) ?

  31. mbokil says:

    2 years ago

    Two icons I can do. Sybolic icons are not supposed to have color so I would have to make another icon which looks like it has gone off. If anyone wants to contribute fireup Inkscape and edit the SVG icon in the folder. I have run out of design ideas for icons. I can probably get an optional countdown label next the icon too. Any icon ideas?

  32. mdyter says:

    2 years ago

    Could you please make 2 types of icons, one then the timer is on and another when is off?