Timer with Notifications 1.0.2

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


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. marko_a says:

    3 months ago

    This needs a "Test Sound" option so I can determine loudness. Ideally test sound would display output from terminal. It's incredibly frustrating to figure out why sound doesn't work and have to wait 1 minute and then get no sound or error. To make sound work: 1) Use no spaces anywhere in path. Rename your files and folders to remove all spaces 2) Installing sox is not enough. You'll get "play FAIL formats: no handler for file extension `mp3'". You need to run this command: sudo apt-get install libsox-fmt-all sox Then test it in terminal by typing play /path/to/file.mp3 If it doesn't work, it might play other formats out of the box, like incredibly disk-space wasting wav format.

  2. Russelll says:

    3 months ago

    Cool Applet, Thanks. I came here because I thought the sox (play) sound notification wasn't working. I figured it out on my own eventually and just wanted to write it down here in case it helps anyone else: The config.js file allows you to specify Soundpath. However, I eventually realised that the "quotes" here do not get parsed to sox so that if your filename has spaces or other weird characters you WILL need to do escape sequences\ to make it work. Most of my sound files are titled this way. A simple workaround for me that I thought of was to just to do a symlink to the file I wanted in my home directory: ~$ ln -s "/media/Long + $illy Music Filename.ogg" cinnamon-alert.ogg This works great. It doesn't work for mp3. Try anything you are testing calling sox yourself: play cinnamon-alert.ogg I even thought I could make a script that randomly places a sound file from a list as the symlink so i can vary the sound my timer makes... but I haven't done it yet. Cheers :-)

  3. neuromancer says:

    9 months ago

    Great job. Thanks for this app. It's pretty essential for studying. The window prompt is such a good idea.

  4. DoTheEvo says:

    2 years ago

    90% what I was looking for 10% is my need for occasional long-term alarm so maybe if theres still some development, adding tiny, inconspicuous, button for some long term alarm menu, where there would be just a calendar app with sliders for hours and minutes... that would make it 100% in my book also maybe showing seconds on mouse over?

  5. damnemo says:

    3 years 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

  6. rhill says:

    3 years 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.

  7. sujitnag says:

    3 years 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.

  8. mrmfldmn says:

    3 years 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.

  9. postNuKe says:

    3 years ago

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

  10. jdgallag says:

    3 years 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);

  11. RedGhost says:

    3 years 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.

  12. mbokil says:

    3 years ago

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

  13. Orb-miser says:

    4 years 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. .

  14. mathrick says:

    4 years 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.

  15. mrdarksys says:

    4 years 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.

  16. goldfish_23 says:

    4 years 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

  17. robertvpitt says:

    4 years ago

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

  18. eitland says:

    4 years 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. : )

  19. mbokil says:

    4 years 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

  20. henriquefm says:

    4 years 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

  21. mbokil says:

    4 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.

  22. MiguelAngel says:

    4 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

  23. winnerer says:

    4 years ago

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

  24. mbokil says:

    4 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.

  25. cgrantmccool says:

    4 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!

  26. mbokil says:

    4 years ago

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

  27. ergosys says:

    4 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!

  28. mbokil says:

    4 years ago

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

  29. mdyter says:

    4 years ago

    @mbokil Thank you for your work !

  30. mbokil says:

    4 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.

  31. mbokil says:

    4 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.

  32. mbokil says:

    4 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.

  33. mbokil says:

    4 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.

  34. Oyabunbaba says:

    4 years ago

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

  35. mbokil says:

    4 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?

  36. mdyter says:

    4 years ago

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