ugol / pomodoro Goto Github PK

Time management for your Mac

Home Page: http://pomodoro.ugolandini.com

AppleScript 0.50% Objective-C 96.21% Ruby 0.13% C 2.42% HTML 0.74%

pomodoro's Introduction

--------
Pomodoro
--------

Pomodoro is an antiprocrastination application that helps in Getting Things Done. 
It is a simple but effective way to manage your time and to boost your productivity to higher levels. 
Can be used for programming, studying, writing, cooking or simply concentrating on something important.
 
You can find more informations on the Pomodoro Technique on http://www.pomodorotechnique.com/
Updates, source code, new releases, manual and fixes on http://pomodoro.ugolandini.com

----------
Developers
----------

Project lead: Ugo Landini
Active Developers: Ugo Landini, Pascal Bihler
Retired Developers: 
 
-------
License
-------
This code is released under BSD license (see License.txt for details) and contains other OSS BSD licensed code:
Growl framework: http://growl.info/
BGHud Appkit: http://code.google.com/p/bghudappkit/

This software contains Waffle Software licensed code:
Shortcut Recorder: http://wafflesoftware.net/shortcut/

Matt Gemmell licensed code:
MGTwitterEngine: http://svn.cocoasourcecode.com/MGTwitterEngine/

Sound samples come from http://www.freesound.org and are licensed under Creative Commons http://creativecommons.org/licenses/sampling+/1.0/

--------------
Building notes
--------------


1) Remove Code signing identity if present (should not, but sometimes I push it back)

Xcode 4.3+ (tips from @sashalaundy):	
1) Product > Edit Scheme
2) At top set Scheme to "Pomodoro" and Destination to "My Mac __-bit"
3) On left select Archive
4) Type in Archive Name "Pomodoro"
5) Hit OK
6) Product > Archive - Xcode builds and then opens Organizer with archive selected
7) Hit Distribute
8) Choose Export as "Application"

Xcode 4:
1) Build a copy for archiving: Product menu -> Build for -> Build for Archiving
2) Open the organizer: Window menu -> Organizer
3) Create a copy of the application: Hit the Share button in the Organizer
4) Choose "Application" from the drop-down menu, and then save it to your Applications folder. 

Xcode 3: (not actively maintained)
1) Should work, but I don't maintain it anymore.

-------
Twitter
-------
If you want to use Twitter integration, you must have a consumerKey and a secretKey for oAuth/xAuth authentication. You must obtain the secrets from twitter site and then add them in src/TwitterSecrets.h 

#define _consumerkey @"your key" 
#define _secretkey @"your other key"

If you are not interested in Twitter, just don't activate the twitter integration.

------------------------------
Thanks, in no particular order
------------------------------
Everaldo for the gorgeous new icons
Pedro Murillo
Michael Bedward
Dieter Vermandere
Paul Schmidt
Sina Samangooei <[email protected]> for debugging (and fixing!)
Alexander Klimetschek
Konrad Mitchell Lawson
Stefano Linguerri for the initial graphic design 
Giulio Cesare Solaroli for the old icons
Luca Ceppelli
Roberto Turchetti
Sergio Bossa 
Andrew Rimmer
Timothy Davis
Simone Gentilini
Francesco Mondora
Michele Mondora
Andy Palmer
Brandon Murray
Valiev Omar
Alexander Willner 
C.Kuehne 
R.Altimari
P.Bihler

pomodoro's People

Contributors

Stargazers

Watchers

Forkers

stuffmc russkle thisivan johnhampton virginiais4lovers lodestone leohackin trawor daveclarke pbihler davidpombar jfred marcusramberg rcuza vgrichina a-bx icasablanca mkb frankquake mlgoodson hrp jwang roryokane zellux joshsee lastobelus mcamiano suwdo avanderberg rogeriopradoj derky1202 sightforbacq andypalmer carlesso kav sni-services janv andreafrancia robynthegeek onevcat peeja stefanoverna pitkali smarr shahor pmetzger nielsm vrybas toddq jerryharrison ltvolks du-song dohoang1102 fungibleclouds temperatio netikular erburrell jmjeong markux wdmchaft musha68k brunogama odogono francof partlyhuman shadowing koteus sveneruso studgeek andreyvit magicfuture andynormancx thekimistrylab vvhh2002 jackmc1047 feralbob h3adache liangxiao diegoceccarelli puchupala ahharvey nwest hyacinth yosimasu ndh netis-be theirix cmmht trnl luismadrigal adrianmiranda tapickell zerotao ga29fol harcek kaktusth husseinmorsy joncchen mieky nanaimostudio

pomodoro's Issues

I can't type into the Pomodoro description

I can only paste or delete text ...

What am I missing?

Optional pomodoro autorestart

Make an option to autorestart a pomodoro at the end of the break

Make the pomodoro icon on status bar moveable

Way to find out current pomodoro name on demand

I would like to be able to find out the current pomodoro name any time the timer is running (perhaps as a tooltip when you hover over the menu icon -- I'll leave the implementation details up to you though!)

Currently, the pomodoro name isn't anywhere to be found (as far as I can tell anyway) until it appears in the log after it successfully completes. I sometimes find myself further distracted by thinking about what I WAS supposed to be doing when I momentarily (not long enough to void the pomodoro) get distracted by something else.

Thanks!

Optional irregularly shaped window

that shows pomodoro. Some users don't like the status bar only timer

To regulate sound volume for ticking

Ticking may help:)
But main sound volume output in Preferences is not enough. It good for Skype, music, what ever but not for ticking

Mono icons

All my menubar items are B&W except for Pomodoro. I opened up the images and tweaked them to be B&W as well. It would be good if this was an option, just like Dropbox has an option for Leopard style icons.

regression: AppleScript support seems to have in 0.28

It works in 0.27, but when I upgrade to 0.28, none of my applescript commands run.

Sticky start message

In "Preferences / Growl / Start" add a checkbox "Make sticky" so Growl can leave the start message always visible and we don't lose focus of what we are supposed to be doing.

Instant start!

Ok, often I'm working on the same project for a number of pomodoros and I just want to be able to Start Pomodoro with a shortcut, but without having to insert/confirm a pomodoro name. So I suggest we have another shortcut - a quickstart shortcut - that just starts a pomodoro with the last selected/entered name/description without the annoying extra confirmation keypress/mouse click being required.

Thanks

David

Re-order items for quick access in the menu

It makes no sense to have the pomodoro control items (start, reset, interrupt, resume) down in the menu, they are the ones that need quick access. About, preferences and stats are less central, they can be further down in the menu and require a bit of scanning to locate.

See the bluetooth/airport menus, or the google notifier for comparison.

Update availability should not be notified during a pomodoro

...rather it should wait until the next break to do the notification, otherwise it creates it's own interruption! :)

Volume control

Volume control for:

for ticking
for speech
for ringing

Option to remove visualization of time in the menu item (next to the tomato)

I would like the option to turn off the time displayed in the menu item (but leave the little tomato). I find that I start procrastinating around the end of a timer if I can see how much time is left.

It might be good to have two options

one to turn on/off the time in the menu item when a pomodoro is running
another option to turn on/off the time in the menu item when a break is running since I usually want to know how much time left I have in a break incase I want to walk away from my desk for something.

As another thought, when the visualization of time is disabled, perhaps hovering over the tomato could reveal the time remaining.

Mute all sounds option doesn't

The "Well done!" notification still sounds even when the "Mute all sounds" option is selected. (Note that this is an important feature for me -- when I don't mind my pomodoro sounding aloud I use a real kitchen timer.

I18n

Pomodoro needs to be internationalized: Italian, German, French, etc.

Handle interruptions according to "the book"

Here are some suggestions for the improvement of interruption handling in Pomodoro.app:

Allow the user to declare an interruption without stopping the timer (in other words, allow a setting of "zero seconds" for the duration of an interruption). This is in accordance with the principle that "a pomodoro is indivisible (atomic)."
Have one keyboard shortcut for internal interruptions ("apostrophes" in the book) and another for external interruptions ("dashes").
In the statistics pane, display the number of internal and external interruptions for each individual pomodoro. Even better, also include the absolute (clock) time of each interruption. This would allow me to figure out, in the long term, when I'm most focused (least internal interruptions), when I'm most vulnerable to external distractions, how much my concentration is affected by the lunch break, which tasks most challenge my attention span, etc. This would be valuable information for fine-tuning my daily schedule, my lunch breaks, and the order of task execution. (According to the book, such visualization and analysis of daily performance is always done at the end of the day).

Thank you!

[POST DELETED BY AUTHOR]

[UPDATE: PLEASE DISREGARD THIS POST. THE REQUESTED FEATURE IS ALREADY IMPLEMENTED.]

In the current implementation, the volume of the counter's tick can only be adjusted by means of the MacOS master volume setting. This makes it impossible to have, for instance, a relatively quiet Pomodoro ticker in the background and a relatively loud radio station, or other audio app, in the foreground.

A volume slider for the Pomodoro app would indeed be great!

Thank you.

Scriptable start

It'd be nice if a script can control the start of a pomodoro with a given text description, so that we can easily link pomodoro to other gtd(-alike) apps.

maybe two approaches:

via AppleScript: tell application "pomodoro" to start "Copy the cat"
via a custom URL handler: pomodoro://start?descrption=Copy%20the%20cats

Cut/copy/paste/select all keys in "Start Pomodoro" dialog

It would be really handy to have these keys work as expected in the Start Pomodoro dialog. For example, it's common to have a Pomodoro for a task that is listed in another program, so copy/paste is a natural thing to try.

Remember the last X pomodoro descriptions

It would be nice if the last X descriptions were available as a combo box: at present it reminds only the last description, but it may happen that during the day you deal with several taks related to a few projects (my educated guess is that 10-15 is OK: not too many nor too few).

Animated icons

change icons for different pomodoro states

Fix Paypal donate links

... certificate broken in all the pages (only the link in the home page works)

Improve stats

nr of pomodoros per task
interruptions and other data for every pomo
make easy filtering/seraching
exporting of CSV data

Unable to update from 0.28 to 0.31

After download, update fails with a 'The update is improperly signed' error

Can't paste into 'Insert Pomodoro description' dialog

Choose an audio device for notifications/speech

I have a high-quality USB DAC for music, and sending Pomodoro's audio output to this device isn't ideal. Using SoundSource, I can select separate output devices for regular audio and system sounds -- could Pomodoro be made to (perhaps optionally) output to the "System" audio stream, along with regular system notifications?

Cannot update to 0.31

After downloading an error message appears:
The update is improperly signed.

Scriptability

Make the pomodoro scriptable: it must be possible from applescript to receive notifications and act consequently

Pomodoro Planning

What about having a feature to plan daily pomodoros before starting them?

[]s

Add tagging support

Add tags to pomodoro for easy filtering

Pomodoro name

Modal dialog asking for pomodoro name before the pomodoro starts. Make it optional in the Preferences panel

Sounds Stop Working After Waking Up From Sleep

Three quick things:

The ticking sounds will stop working after waking up from Sleep and I would have to restart Pomodoro Desktop to have it working again.
It would be very nice if there is some elementary tracking in the stats page, such as: Pomodoro completed today, yesterday, average, etc.
The uploaded source code on github won't compile :(

Select File buttons in Scripts preference pane don't allow me to select any script

It's all grayed out, .scpt files, .script, and .applescript. It won't let me select anything. (0.27 and 0.28)

I can run scripts via this:

run script ("/Users/timcharper/PomodoroStart.scpt" as POSIX file)

Perhaps the file selection dialog could just insert a script like that in? Would do it myself, but I can't get the application to compile :S

Manual "break" timer

I tend to play a little fast and loose with the pomodoro technique, and often work slightly over the pomodoro timer to finish up a loose thread before taking a break. Also, I might let my break go a minute or so longer occasionally. Thus, I have the "auto break" timer turned off.

All that, so I could say: it would be nice if there was an option to manually start/stop the break timer, similar to how the primary pomodoro timer works.

ScrollView instead of Textfields

Substitute Textfields for growl/speech notifications with Scrollviews

Global hotkey

Make hotkeys user selectable (and save in User Default Preferences)

Condense Menubar Display

Pomodoro currently displays the remaining time even when not in use. It would be nice to have an option to hide the time display unless in use. This would have the benefit of freeing up valuable menubar space.

Taking this further, it would also be a nice feature to have an option to remove the countdown altogether, simply changing the color of the pomodoro to indicate when the halfway mark has been reached and perhaps when 5 or 2 minutes remain. Alternatively, instead of changing colors, it could be possible to rely on growl notifications. If this option were to be enabled hovering the mouse over the pomodoro icon could display the remaining time.

Thank you for the great application, the above is simply a suggestion for making it even better.

Ability to change preferences while Pomodoro is running

I appreciate it goes against the principle of a Pomodoro to be changing the application preferences when you should be focusing on something else, but the very first pomodoro may be to get the preferences right!

Basically, it is a pain that you have to start the pomodoro to get a real feeling of whether the sounds and volumes work, but then you have to stop it in order to go to the preferences to change things a little.

So, please allow preferences changes during a pomodoro.

Visual notification

It would be useful to have a visual break when the pomodoro is over. Otherwise with the "Mute all sounds" option you don't notice that the pomodoro is over!

Sparkle setup

Implement sparkle setup preferences tab

Editable comboboxes

Make time and other values user editabl in comboboxes to have completely user defined pomodoro durations and breaks

Programmable notification for last n-minutes

Can be useful have a programmable notifications for the last n-minutes.
Example
Notify (voice/growl/other) every five minutes during the last twenty minutes

select all in Pomodoro Name field

adding select all would be damn handy, since its actually kinda hard to see the hilight on the field and im forever overwriting this

Previously interrupted and resetted pomodoro interrupts new restarted pomodoro

Hi! Thanks for great app!

Reproduce the bug/anomaly like this:

Start new pomodoro
Interrupt it.
Within 45s:
Reset the pomodoro.
Start a new one
BUG: 45s after step 2) the new pomodoro is canceled.

/Daniel

Reset to default values

Put a button in Prefs panel to reset to default values

Pomodoro autostart

Make an option in the preferences panel to make pomodoro autostart at user login

Pomodoro icon to be back and replace a watch icon

To many watches on my bar and no pomodoro. Why?
Red pomodoro is unique.

Add Mute option to menubar menu

It would be handy to have the option to mute all sounds coming from Pomodoro.app if you need to use your computer's speakers for working, but without the distraction of the Speech module, rings, etc. (but still want that enabled for when you're using headphones). The visual notifications (Growl) will still work, so you'll still know when the pomodoro ends, etc.

Dialog window should allow copy/paste

A dialog window pops up to ask what the current activity is. Currently it seems that normal operating system key combinations are disabled in this popup, e.g. cmd-A, cmd-C, cmd-V do not work.

In order to integrate better with other systems (such as CulturedCode's Things) it would be nice to copy/paste Todo items.