Pomodoro Timer for Cinnamon 2.x, 1.8.x

English

The Pomodoro technique is used to boost productivity and this applet provides an easy way to use the technique right on your desktop. Read more about the technique here: http://en.wikipedia.org/wiki/Pomodoro_Technique.

Applet page

http://cinnamon-spices.linuxmint.com/applets/view/131

Installation

In order to install cinnamon-pomodoro you have to execute the following steps:

• You need SoX play to play sound files, it is pre-installed on Linux Mint / Ubuntu, you can easily check:

$ which play
$ man play

If you do not have it, you will need to install it for your distribution, for Debian it is:

$ sudo apt-get install sox

• Clone the repository and install the files into the Cinnamon applet directory:

    $ git clone [email protected]:gfreeau/cinnamon-pomodoro.git
    $ cp -r cinnamon-pomodoro/[email protected] ~/.local/share/cinnamon/applets

• Alternatively, if you don't have GIT installed you can just download zip file:

    $ wget https://github.com/gfreeau/cinnamon-pomodoro/archive/master.zip -O cinnamon-pomodoro.zip
    $ unzip cinnamon-pomodoro.zip
    $ cp -r cinnamon-pomodoro/[email protected] ~/.local/share/cinnamon/applets

• You may need to restart Cinnamon, press ALT-F2 and enter 'r'
• Finally, enable the applet by going to Menu->Settings->Applets and selecting Pomodoro
• Get productive!

Installing an existing translation

• To install an existing translation file, you need to move or copy the .mo file located in the "cinnamon-pomodoro/[email protected]/po" folder to your local locales folder "~/.local/share/locale/LOCALE_ID/LC_MESSAGES"
• The file name must be the same as the applet UUID with the .mo extension : [email protected]

Example for the french translation file

$ mv ~/.local/share/cinnamon/applets/[email protected]/po/[email protected]_fr.mo ~/.local/share/locale/fr/LC_MESSAGES/[email protected]

It is possible that the "locale" folder doesn't exists in "~/.local/share", in this case create the required folder tree ("locale/YOUR_LOCALE_ID/LC_MESSAGES") before using the command above

• You may need to restart Cinnamon, press ALT-F2 and enter 'r'
• Enjoy the french translation :)

Make a translation

$ cd po
$ msginit

You can also specify the locale and pot file:

$ msginit --locale=fr [email protected]

• Edit the newly created .po file and change msgstr to translated text.
• Please add your translations to the original owner repository.
• Use cinnamon-json-makepot to test your translations.
• You can also use msgfmt to create a .mo file from the .po file.

---

Français

La technique Pomodoro est utilisée pour booster la productivité et cette applet vous permet de l'utiliser d'une façon simple et intuitive, directement sur votre bureau Cinnamon. Pour en savoir plus sur la technique Pomodoro, je vous invite à consulter la page Wikipedia.

Page de l'applet

http://cinnamon-spices.linuxmint.com/applets/view/131

Installation

Afin d'installer l'applet, il vous faut suivre les étapes suivantes :

• Vous devez installer "SoX play" afin de pouvoir lire les fichiers sons, celui-ci est préinstallé sur Linux Mint et Ubuntu, vous pouvez facilement le vérifier :

$ which play
$ man play

Si vous ne l'avez pas, vous allez devoir l'installer pour votre distribution, pour Debian il vous suffit de taper la commande suivante dans votre terminal :

$ sudo apt-get install sox

• Clonez le repository et installez les fichiers dans le répertoire des applets de Cinnamon :

    $ git clone [email protected]:gfreeau/cinnamon-pomodoro.git
    $ cp -r cinnamon-pomodoro/[email protected] ~/.local/share/cinnamon/applets

• Sinon, si vous n'avez pas GIT installé, vous pouvez simplement télécharger le fichier zip :

    $ wget https://github.com/gfreeau/cinnamon-pomodoro/archive/master.zip -O cinnamon-pomodoro.zip
    $ unzip cinnamon-pomodoro.zip
    $ cp -r cinnamon-pomodoro/[email protected] ~/.local/share/cinnamon/applets

• Vous pourriez avoir à redémarrer Cinnamon, pour cela appuyez sur "ALT + F2", tapez "r" et validez
• Pour finir, activez cette applet en vous rendant sur Menu->Préférences->Applets et en sélectionnant Pomodoro
• Soyez productif !

Installer une traduction existante

• Pour installer un fichier de traduction existant, vous avez besoin de déplacer ou copier le fichier .mo situé dans le repertoire "cinnamon-pomodoro/[email protected]/po" vers votre répertoire local de localisations "~/.local/share/locale/LOCALE_ID/LC_MESSAGES"
• Ce fichier doit être nommé avec l'UUID de l'application et porter l'extension .mo : [email protected]

Exemple avec le fichier de traduction pour la langue française

$ mv ~/.local/share/cinnamon/applets/[email protected]/po/[email protected]_fr.mo ~/.local/share/locale/fr/LC_MESSAGES/[email protected]

Il est possible que le répertoire "locale" n'existe pas dans "~/.locale/share", dans ce cas, créez la structure de répertoire requise ("locale/VOTRE_LOCALE_ID/LC_MESSAGES") avant d'utiliser la commande ci-dessus.

• Vous pourriez avoir à redémarrer Cinnamon, pour cela appuyez sur "ALT + F2", tapez "r" et validez
• Profitez de la traduction française ! :)

Créer une traduction

$ cd po
$ msginit

Vous pouvez aussi spécifier la localisation et le fichier .pot :

$ msginit --locale=fr [email protected]

• Editez le nouveau fichier .po créé et changez "msgstr" avec votre chaîne de texte traduite.
• S'il vous plait, ajoutez vos traductions sur le repository du créateur de l'applet.
• Vous pouvez utiliser cinnamon-json-makepot pour tester vos traductions.
• Vous pouvez également utiliser msgfmt pour créer un fichier .mo à partir d'un fichier .po.