MyPomodoro User Doc 2.1.1

Page 1 of 18 myPomodoro User Guide

myPomodoro

Java Desktop Application

myPomodoro User Guide

version 2.1.1


Table of Contents

1. Notes ............................................................................................................................................. 3 1.1 What’s new .............................................................................................................................. 3 1.2 Download ................................................................................................................................ 4 1.3 System requirements ............................................................................................................... 4 1.4 Installation ............................................................................................................................... 4 1.5 Migrating (starting from v2.0) .................................................................................................. 5 1.6 Uninstallation .......................................................................................................................... 5 1.7 Release notes ........................................................................................................................... 5 1.8 Known issues ........................................................................................................................... 6

2. About ............................................................................................................................................. 6 2.1 About myPomodoro ................................................................................................................. 6 2.2 About the Pomodoro Technique® ............................................................................................ 6 2.3 Overview ................................................................................................................................. 7

3. Layout ............................................................................................................................................ 7 3.1 Start Screen ............................................................................................................................. 7 3.2 Menu-Based Navigation ........................................................................................................... 8 3.3 Image-Based Navigation ........................................................................................................... 8 3.4 Keyboard Shortcuts .................................................................................................................. 9 3.5 System Tray ............................................................................................................................. 9

4. Panels ............................................................................................................................................ 9 4.1 Preferences .............................................................................................................................. 9 4.2 Create .....................................................................................................................................10 4.3 Activity List .............................................................................................................................10 4.4 Manager .................................................................................................................................10 4.5 ToDo List .................................................................................................................................10 4.6 Report List ..............................................................................................................................10

5. Usage ............................................................................................................................................11 5.1 Setting Preferences (Preferences Panel) ..................................................................................11 5.2 Creating Activities (Create Panel) ............................................................................................12 5.4 Deleting Activities (Activity List Panel) .....................................................................................13 5.5 Transferring Activities (Manager Panel) ...................................................................................13 5.6 Handling ToDo Tasks (ToDo List Panel) ....................................................................................13 5.7 Overestimating ToDo Tasks (ToDo List Panel) ..........................................................................14 5.8 Handling Interruptions (ToDo List Panel) .................................................................................15 5.9 Merging ToDo Tasks (ToDo List Panel) .....................................................................................15 5.10 Deleting Reports (Report List Panel) ......................................................................................16 5.11 Deleting All Data ...................................................................................................................16 5.12 Exporting Activities/Reports (Activity/Report List Panel) .......................................................16 5.13 Importing Activities/Reports (Activity/Report List Panel) .......................................................17

6. Languages .....................................................................................................................................17 6.1 Adding a language (.jar file only) .............................................................................................17 6.2 Submitting a language file to the community ..........................................................................18


1. Notes

1.1 What’s new

Bug fixing in 2.1.1:

General: o Description field not working properly (ticket #58)

Manager: o Multiple selection not working on jdk 6 (ticket #57)

ToDo List: o Merging improved

New in 2.1:

General: o Better scrolling in tabs o Use of Swing event queue threads (ticket #44) o Oracle Java 7 compatibility o Confirmation message on exit (ticket #45) o Dialog messages centered

Create: o Dynamic list of types, authors and places (also in Edit and Unplanned Panels)

(tickets #34 #37)

Activity: o Ascending date sorting by default

Manager: o (Done/ Estimated) Pomodoros displayed alongside the task’s name o (U) sign displayed alongside unplanned tasks’ name (also in ToDo List Panel) o Multiple selection (ticket #38) o Tasks turn green when finished o Ascending date sorting by default

ToDo List: o Buttons (+/-) to increase/decrease current time o Scroll bar o ‘10-minutes’ System Tray Popup messages (ticket #41) o Unplanned tasks and overestimations correctly accounted and displayed (ticket

#35) o Merging of ToDos

Report List: o Date sorting fixed (ticket #54) + descending date sorting by default

Preferences: o Short length breaks allowed to last up to 15 minutes (ticket #56) o Always On Top option (ticket #41)


1.2 Download

Go to http://sourceforge.net/projects/mypomodoro/ and locate the proper download:

Windows Only: Native Executable (.exe)

All Other OS’s: Java Executable Jar (.jar)

1.3 System requirements

Java Runtime Environment (JRE 6 or 7)

1.4 Installation

You can get the latest version of myPomodoro from http://sourceforge.net/projects/mypomodoro/. Note: if you’re already using myPomodoro, do not install a newer version in the same directory. Databases are likely to be (slightly) incompatible between versions. See Migration section.

Windows: The .exe and .jar will open and run by double click, without any further steps, as long as a current Java Runtime Environment (JRE) is installed.

Mac OS X: Download the .dmg file and drag the myPomodoro Folder into the Applications Folder. myPomodoro will be accessible from LauchPad, if you are running Snow Leopard or Lion, otherwise just open the Applications Folder and open the myPomodoro Folder and click on the myPomodoro application to run. As an alternative, the .jar file will open and run by double click, without any further steps, as long as a current Java Runtime Environment (JRE) is installed. However if the .jar file does not open and gives you an error stating The Java JAR file myPomodoro...jar could not be launched, then do the following steps: 1. Click the Apple Icon and Click Software Update

o Install any Java updates if displayed, if no Java updates are displayed this means you have the current version of the JRE.

2. Open Spotlight and type in Java Preferences o Click on Java Preferences o Under the General Tab, click and drag Java SE to the top o Close Java Preferences Window and myPomodoro will run with a double click

Linux: To run the .jar file on a Linux Platform perform one of the two steps listed below: 1. To open myPomodoro.jar with a double click

o Right click jar o Select Properties o Select Permissions tab o Check the "Allow executing file as program"

http://sourceforge.net/projects/mypomodoro/



OR

o Open terminal o Navigate to the folder containing myPomodoro.jar (ex. $ cd Desktop) o Type in the following

sudo chmod +x mypomodoro.jar THEN

o Right click jar o Select Open with OpenJDK Java Runtime or whatever your Java runtime

is, if it isn't selected already. o Now the OS will remember to open .jar files with your JRE

2. To run myPomodoro.jar from terminal (Will not make the file open with a double-click): o Open terminal

o Navigate to the folder containing myPomodoro.jar (ex. $ cd Desktop) o Type in the following

java -jar myPomodoro.jar

1.5 Migrating (starting from v2.0)

Export activities and reports from old version (see Importing/Exporting Activities).

Import activities and reports export files into new version.

Configure the preferences in the new version according to preferences set in the old version.

Uninstall old version.

1.6 Uninstallation

Stop myPomodoro.

Windows: Remove the .exe or .jar file.

Mac OS X: Remove the .dmg or .jar file.

Linux: Remove the .jar file.

Remove the "pomodoro.db" file.

1.7 Release notes

The application will create a database called "pomodoro.db" in whatever directory you run this application in for the first time.

Never delete this database, unless you want to delete all of your stored data.

Never separate the directories of the database file called "pomodoro.db" from the executable file (.jar or .exe). Doing so will remove the connection of the application to the database and the database will create a new database titled "pomodoro.db" in its new directory the next time it runs. However, you can still recover your data if you do


this, just simply either move the application to the old directory or move the database to the new directory.

Always move the database file "pomodoro.db" with the application when changing directories.

When data is created within the application it is automatically saved.

1.8 Known issues

myPomodoro doesn’t start when some special or accented characters are found in the path.

This version is not compatible with "pomodoro.db" database created with myPomodoro 1.1 or any earlier version.

No difference made between first overestimation and other overestimations for the same activity. The two Diff columns of the Report List refer to the difference between the real Pomodoros and the initial estimation (Diff I) and the overestimation(s) (Diff II).

The sorting of columns gets lost when editing or deleting content (Activity and Report List)

2. About

2.1 About myPomodoro

myPomodoro is a time management tool based upon the time management technique called the Pomodoro Technique® by Francesco Cirillo. The objectives of this software are to automate all the materials and methods used in the Pomodoro Technique®, which are otherwise preformed manually. myPomodoro is fully compliant with the latest specifications of the Pomodoro Technique® (version 1.3). myPomodoro is open-source software, licensed under the GNU General Public License version 3.0 (GPLv3), and available for download at http://sourceforge.net/projects/mypomodoro/. All documentation and images by Phil Karoo are licensed under Creative Commons Attribution Non-commercial license (the mute and sound icons are licensed under Creative Commons Attribution Non-commercial by Brsev). Credits: Phil Karoo and other contributors.

2.2 About the Pomodoro Technique®

The Pomodoro Technique® is a time management technique created by Francesco Cirillo for a more productive way to work and study. This technique eliminates the concept of time by using pure units of work, called Pomodoros, without any interruptions. A traditional Pomodoro is 25 minutes long: 25 minutes of uninterrupted work plus a 5-minutes break. Typical materials used in this technique include: a kitchen timer, a ToDo Today Sheet, an Activity Inventory Sheet, and a Records Sheet. The basic methods used to follow this technique include:

1. Choosing an activity to be accomplished from the Activity Inventory Sheet


http://brsev.deviantart.com/art/Token-128429570


2. Working on a ToDo task until the timer rings 3. Taking a short break until the timer rings 4. Every Set of Pomodoros, taking a longer break until the timer rings 5. At the end of the day, recording all completed ToDo tasks in the Records Sheet

It is highly recommended before using this software to become familiar with the Pomodoro Technique®. To learn more about the Pomodoro Technique®, click on Help in menu bar in the myPomodoro Application and select one of the following from Pomodoro Technique® sub-menu:

Pomodoro Technique® Official Website (redirects to the Pomodoro Technique® Website)

Pomodoro Technique® Official Book (redirects to the Pomodoro Technique® Website)

2.3 Overview

myPomodoro software attempts to automate all of the manual processes and methods of the Pomodoro Technique®, removing the manual processes of writing, marking, transferring and erasing items to and from the various sheets used in the Pomodoro Technique®. However in the process we have had to modify a few things to make it more straightforward. Within our program we have changed the names of the materials used in the Pomodoro Technique® from the following to:

Activity Inventory Sheet Activity List

ToDo Today Sheet ToDo List

Records Sheet Report List

We also have had to create a way to handle activity creation, estimating Pomodoros, capturing real

Pomodoros, transferring activities between sheets, deleting activity and report, creating internal and

external interruptions, voiding Pomodoros, creating unplanned activity creation… which are all

processes used in the Pomodoro Technique®. Since this is indeed an automation of manual tasks, we

have decided to implement a Digital ticking (and ringing) Pomodoro Timer over that of a ticking

Pomodoro Timer. We have also added features to help assist new users such as generating sample

data and the ability to clear the entire database of all activities, ToDo tasks and records. Within each

list view, we have provided a details area so that a user can get more information on a task (author,

description…). The first screen you will see every time you open myPomodoro is the Start Screen,

which is the starting point for you to begin your use of the Pomodoro Technique®.

3. Layout

3.1 Start Screen

The first thing that you will notice at the start of the program is that the application navigational

layout consists of both a Menu-Based Navigation and an Image-Based Navigation. We have also

added navigation by providing the user with Keyboard Shortcuts to some of the features.

The main difference between the three types of navigation is that the Menu-Based Navigation allows

the user to access all features of the application, whereas the Image-Based Navigation and Keyboard


Shortcuts do not. The Keyboard Features provide the user with quick access to common features of

this application. The Image-Based Navigation provides the user with quick access to common

features used in the Pomodoro Technique®. The area below the Navigation Bars is what we call a

panel. On the start screen the panel consists of just our logo, but in other panels they can contain

lists, tables, tabs, text areas, timer, etc.

The other thing that you will notice is the System tray icon (for OS that support the feature). This

allows users to minimize the program.

3.2 Menu-Based Navigation

The Menu-Based Navigation consists of the following menus and submenus:

File o Preferences – Allows users to set the options of the application like the length of

the Pomodoro, short break, and long break times. o New Activity – Allows users to create a new activity. o Exit – Closes the Application

View o Activity List – Same as the Activity Inventory Sheet in the Pomodoro Technique®.

o Manager – Allows users to add activities to the ToDo List from the Activity List.

o ToDo List – Same as the ToDo Today Sheet in the Pomodoro Technique®, in

addition to the Digital Pomodoro Timer.

o Report List - Same as the Records Sheet in the Pomodoro Technique®.

Data o Populate Test Data – Allows first-time users to generate random data to learn

how to use this software in conjunction with the Pomodoro Technique®. o Clear All Data – Allows users to delete all data, but does not delete the database

"pomodoro.db". See also Deleting All Data.

Help o Download User Guide (this document) o Pomodoro Technique®

Pomodoro Technique® Official Website Pomodoro Technique® Official Book

o Report Issues – Redirects users to myPomodoro project’s issues page o Check for Update – Redirects users to myPomodoro project’s download page o About

3.3 Image-Based Navigation

The Image-Based Navigation consists of the following menus:

Create – Allows you to create a new activity.

Activity List – Same as the Activity Inventory Sheet in the Pomodoro Technique®.

Manager – Allows the user to add activities to the ToDo List from the Activity List.


ToDo List – Same as the ToDo Today Sheet in the Pomodoro Technique®, in addition to

the Digital Pomodoro Timer.

Report List - Same as the Records Sheet in the Pomodoro Technique®.

3.4 Keyboard Shortcuts

The current keyboard shortcuts are written below:

Alt + P for Preferences

Alt + C for New Activity (Create)

Alt + A for Activity List

Alt + M for Manager

Alt + T for ToDo List

Alt + R for Report List

Esc for Exit

The shortcuts start with the Alt-Key (except Exit) and end with the letter that corresponds to the

feature being requested. Shortcut hints are also given in the drop down menus.

3.5 System Tray

The application may be minimized in the System Tray by clicking the X icon in the upper right hand corner. A single click on myPomodoro’s System Tray icon restores it. This feature only works for OS that support it.

4. Panels

4.1 Preferences

This panel allows the user to set the preferences of the application. When the user clicks the Save

button the preferences are saved in the database. When the user clicks the Reset button the

preferences are set to the values recommended by the Pomodoro Technique®. In both cases, the

application must be restarted.

The choice of the language has a direct impact on the way the dates and times are formatted and

displayed:

Date: o English (United States): MMM dd yyyy (eg. Sep 06 2011) o Others: dd MMM yyyy (eg. 06 Sep 2011)

Time: o English: hh:mm a (eg. 04:35 PM) o Others: HH:mm (eg. 16:35)

See also Setting Preferences.


4.2 Create

This panel allows the user to create activities (date, title, estimates…). When the user clicks on the

Save button, the activity is added to the Activity List. When the user clicks on the Clear button the

form is reset.

See also Creating Activities.

4.3 Activity List

This panel displays the current Activity List. It allows the user to view details, edit, delete, add

comment and import/export activities.

See also Editing Activities, Deleting Activities and Importing/Exporting Activities.

4.4 Manager

This panel allows the user to move activities from the Activity List to the ToDo List. It allows the user

to view basic details about activities and ToDo tasks.

See also Transferring Activities.

4.5 ToDo List

This panel displays the current ToDo List and allows the user to complete ToDo tasks. It allows the

user to view details, add comment, overestimate, create unplanned activities and ToDo tasks, record

interruptions, merge ToDo tasks, move ToDo tasks to the Report List (complete).

See also Handling ToDo Tasks, Handling Interruptions and Merging ToDo Tasks.

4.6 Report List

This panel displays the current Report List of all completed ToDo tasks. It allows the user to view details, delete, add comment and import/export reports. The columns of the Report List table are:

Date: The date of the last finished Pomodoro.

Time: The time of the last finished Pomodoro.

Title: The name of the task.

Estimated: Overall estimation (Estimated + Overestimated)

Real: The number of finished Pomodoros.

Diff I: Difference with initial estimation (Diff I = Real – Estimated)

Diff II: Difference with overall estimation (Diff II = Real – Estimated – Overestimated)

Type: the type of task


The Accuracy, which is displayed on top of the Report List, is the global success rate: 100% means that the overall estimated Pomodoros of all the tasks were done (Accuracy = Real / (Estimated + Overestimated)). See also Deleting Reports and Importing/Exporting Reports.

5. Usage

5.1 Setting Preferences (Preferences Panel)

Setting the Preferences is actually what users should do when starting myPomodoro for the very first time. There are two ways to open the Preferences Panel:

Click on the File menu and select Preferences in the Menu-Based Navigation.

Press Alt + P

All you have to do is set the preferences and press the Save button:

Pomodoro length: Used by the ToDo List Panel to set the Timer.

Short break length: Used by the ToDo List Panel to set the Timer.

Long break length: Used by the ToDo List Panel to set the Timer.

Max nb pom/activity: Maximum number of Pomodoros per Activity. Used by the Create Panel, Edit Tab (Activity List Panel) and Unplanned Panel (ToDo List Panel) to set the Estimated Pomodoros Combo Box.

Max nb pom/day: Maximum number of Pomodoros per day. Used by the Manager Panel to warm the user when moving activities from the Activity List to the ToDo list.

Nb pom/set: Number of Pomodoros per Set. Used by the ToDo List Panel to set the Timer. Long breaks happen every set of Pomodoros.

Sounds: o Ticking: Enable/Disable ticking. Ticking happens during Pomodoros only. Used by

the ToDo List Panel to set the Timer. o Ringing: Enable/Disable ringing. Ringing happens at the end of Pomodoros and

breaks. Used by the ToDo List Panel to set the Timer.

Language: Used by the application to display messages and format dates. The following option will only appear for OS that support the System Tray feature:

System Tray: o System Tray: Enable/Disable System Tray icon. o Popup message: Enable/Disable System Tray Popup messages.

Always On Top: the application remains on top of others applications. Setting the Preferences requires restarting the application.


5.2 Creating Activities (Create Panel)

Creating an activity is actually the first step the user must do when there is no activity in the Activity List. There are three ways to open the Create Panel:

Click the File menu and select New Activity in the Menu-Based Navigation.

Press Alt + C

Click on the Create Icon from the Image-Based Navigation. All you have to do is fill out the form and press the Save button:

Date: The date when the activity must be done. This field is mandatory.

Title: The name of the activity. This field is mandatory.

Estimated Pomodoros: The number of estimated Pomodoros. This number can be decreased / increased by editing the activity or increased by overestimating the activity as ToDo task. This field is mandatory.

Type: the type of work (eg. management, communication, meeting...). This editable list is pre-filled with existing types. When creating / editing an activity / unplanned activity / report, the list of types is updated. Unused types are removed at restart time.

Author: the name of the author. This editable list is pre-filled with existing authors. When creating / editing an activity / unplanned activity / report, the list of authors is updated. Unused authors are removed at restart time.

Place: the place where the activity takes places. This editable list is pre-filled with existing places. When creating / editing an activity / unplanned activity / report, the list of places is updated. Unused places are removed at restart time.

Description: the description of the activity in case the title isn’t self-explanatory. The activity is automatically added to the Activity List.

5.3 Editing Activities (Activity List Panel)

There are three ways to open the Activity List:

Click the View menu and select Activity List in the Menu-Based Navigation.

Press Alt + A

Click on the Activity Icon from the Image-Based Navigation. All you have to do is edit activities:

1- Select an activity. 2- In the Edit tab, set new values in the form. 3- Click on the Save button.

Activities may also be edited in-line:


1- Double-click on a cell (Title and Type columns only). 2- Set the new value. 3- Press Enter or select another activity.

The activity is automatically updated in the Activity List.

5.4 Deleting Activities (Activity List Panel)

You can either delete activities one by one or all at once. All you have to do is select the activity that you want to delete and click the Delete button (Details Tab). The activity is automatically removed from the Activity List and permanently deleted from the database. Click on the Delete All button to delete all activities at once.

5.5 Transferring Activities (Manager Panel)

The next step you need to do is transfer activities from the Activity List (right-hand side of the Panel) to the ToDo List (left-hand side of the Panel). There are three ways to open the Manager panel:

Click the View menu and select Manager in the Menu-Based Navigation.

Press Alt + M

Click the Manager Icon from the Image-Based Navigation. All you have to do is select the activities you want to transfer to the ToDo List and click on the >>> button. To select multiple activities, hold the CTRL key.

5.6 Handling ToDo Tasks (ToDo List Panel)

The next step is to work on the ToDo tasks. There are three ways to open the ToDo List Panel:

Click the View menu and select ToDo List in the Menu-Based Navigation.

Press Alt + T

Click the ToDo Icon from the Image-Based Navigation. All you have to do is process the ToDo tasks as follows:

1- Select a task. 2- Start the timer (click on the Start button).


3- Do the Pomodoro. You may select a different task to see its details, add a comment or make an overestimation. (optional) In case of internal or external interruption, create an unplanned task. If the interruption is urgent, stop the timer and go to step 1 to process the urgent task. Otherwise, wait for the timer to ring.

4- Case 1: number of Pomodoros done < set of Pomodoros Take a short break. You may select a different task. Wait for the timer to ring, go to step 3 (the timer stops itself if all the Pomodoros of the current task are done). Case 2: number of Pomodoros done = set of Pomodoros Take a long break. You may select a different task. Wait for the timer to ring (the number of Pomodoros done is reset to 0) and go to step 3 (the timer stops itself if all the Pomodoros of the current task are done).

Note 1: the so-called current task is the task which name appears below the timer. Note 2: the so-called selected task is the task that is currently selected in the ToDo list (bold characters). When a task is running, it cannot be changed: its name appears below the timer and on top of the Unplanned tab no matter what task is currently selected. Note 3: when the System Tray Popup message option is on (Preferences), the time is displayed in a popup message every 10 minutes at 05:00, 15:00, 25:00, 35:00... sharp. Exemple: 32-minutes Pomodoro : pop-up messages at 25:00, 15:00 and 05:00. Along with the name of the tasks, icons are used to show Pomodoros and interruptions:

Pomodoro:

Real Pomodoro:

Internal interruption:

External interruption: Code colors are used to present the status on the tasks:

Black: not running

Red: currently running

Green: finished (all the Pomodoros of the task are done) At the end of the day, all you have to do is complete the ToDo tasks (Details Tab). Click on the Complete button: the ToDo task is moved to the Report List. Click on the Complete All button to complete all ToDo tasks at once.

5.7 Overestimating ToDo Tasks (ToDo List Panel)

You can overestimate ToDo tasks at any time. The process of overestimation is:

1- Select a ToDo task.


2- In the Overestimation tab, select the number of Pomodoros you want to add to the current number of estimated Pomodoros.

3- Click on the Save button.

5.8 Handling Interruptions (ToDo List Panel)

While a Pomodoro is running, interruptions must be handled. The process of handling an interruption is:

1- The interruption is urgent: stop the timer (click on the Stop button). This action is called "voiding a Pomodoro".

2- Case 1: the interruption is urgent Create an unplanned task with internal or external interruption and date today.* Case 2: the interruption isn’t urgent Create an unplanned task with internal or external interruption and date in the future.

3- The interruption is urgent: start the new unplanned ToDo task straight away (no break). * Note : Urgent tasks are most likely due to external interruptions The unplanned activity is automatically added to the ToDo List if the date is today; otherwise it is added to the Activity List. It is also marked as unplanned ("U"). Of course, during breaks, you may create unplanned activities that are not interruptions. In that case, simply leave the “Interruption” field empty (default).

5.9 Merging ToDo Tasks (ToDo List Panel)

Some tasks (especially interruptions) doesn’t last one pomodoro. The merging feature allows you to combine multiple ToDos into a new task. Simply select two or more ToDos and set the details of the new task:

the descriptions of the selected ToDos are aggregated in the description field.

behind the scene, the comments are also aggregated.

the pomodoros already done (real) are summed up and set onto the new task (it is made sure that the estimation is, at least, one pomodoro higher).

Note : running and finished ToDos are not allowed for merging. The resulting task is automatically added to the ToDo List if the date is today; otherwise it is added to the Activity List. It is also marked as unplanned ("U"). Selected ToDos are deleted.


5.10 Deleting Reports (Report List Panel)

You can either delete reports one by one or all at once. There are three ways to open the Report List:

Click the View menu and select Report List in the Menu-Based Navigation.

Press Alt + R

Click on the Report Icon from the Image-Based Navigation. All you have to do is select the report that you want to delete and click on the Delete button (Details Tab). The report is automatically removed from the Report List and permanently deleted from the database. Click on the Delete All button to delete all reports at once.

5.11 Deleting All Data

Two options for deleting all data:

Stop the application and delete the Database file titled "pomodoro.db"

Click on the Data menu and select Clear All Data in the Menu-Based Navigation.

5.12 Exporting Activities/Reports (Activity/Report List Panel)

In the Export tab, all you have to do is fill out the form and click on the Export button:

Header: first row of the file U, Date, Time, Title, Estimated, Overestimated, Real, Diff I, Diff II, Internal, External, Type, Author, Place, Description, Comment

File name: the name of the export file. This field is mandatory (if this field is left empty, default name "myPomodoro" is used; if this field contains some special characters not supported by the file system of your Operating System, the export fails).

File format: set of supported file formats. This field is mandatory.

Date pattern: sets of patterns for days, months and years*. These fields are mandatory.

Separator: set of pre-defined separators, plus an empty editable field (this must be a character, not a string). This field is mandatory (if this field is left empty or is not a proper character, default separator "Comma" is used).

* CSV patterns:

Day d 1

dd 01

Month M 1

MM 01

MMM Jan

MMM January


Year yy 01

yyyy 2001

Example: M/dd/yyyy 1/01/2001 The application creates a file with name "<File name>" and extension ".<File format>" in whatever directory you run the application in.

5.13 Importing Activities/Reports (Activity/Report List Panel)

In the Import tab, all you have to do is fill out the form and click on the Import button. The form is the same as the Export form except for the File name field, which is replaced by the File field:

File: the path of the import file. This field is mandatory. Click on the Browse button to search for the import file on the file system.

The format of the import file must be the same as one of the format allowed by the Export feature.

The easiest way to make an import file is to export some tests activities/reports and use the exported file as import file. If the import fails, an error file (error.txt) is created in whatever directory you run the application in. This may help you to figure out what’s wrong with the file.

6. Languages

6.1 Adding a language (.jar file only)

You can add any language you like to myPomodoro as long as it is supported by the Java Runtime Environment (JRE). The steps to add a language are:

1. Quit myPomodoro 2. Open the .jar file with your favorite zip file archiver 3. Browse to org/mypomodoro/labels 4. Extract file "mypomodoro_en_US.properties" onto your file system 5. Look up your language in the list of supported languages (also called "locales"):

http://www.oracle.com/technetwork/java/javase/locales-137662.html 6. Rename the file by replacing "en_US" with your locale

Example: "mypomodoro_en_US.properties" becomes "mypomodoro_hu_HU.properties" 7. Edit the file with your favorite text editor and translate the labels

Example: "FileMenu.Exit=Exit" becomes "FileMenu.Exit=Kijárat" 8. Open the .jar file, browse to org/mypomodoro/labels and paste the file. Close the

archiver

http://www.oracle.com/technetwork/java/javase/locales-137662.html


Then all you have to do is start myPomodoro, open the Preferences Panel, select your language and click on the Save button. Restart the application as instructed.

6.2 Submitting a language file to the community

Best way to submit a new language file:

Create a ticket with summary "New language file: <your language>" and attach the new language file (http://sourceforge.net/p/mypomodoro/tickets)

Many thanks for your contribution!

http://sourceforge.net/p/mypomodoro/tickets

Documents

MyPomodoro User Doc 2.1.1