Tomato.C

A pomodoro timer written in pure C.

How to Install • How to Use • Controls and Preferences • The Pomodoro Method • To-do • Dependencies • Contribute • License

💾 How to Install

Note: a good practice is to clone the repo at $HOME/.local/src/

$ git clone https://github.com/gabrielzschmitz/Tomato.C.git
$ cd Tomato.C
$ sudo make install

🚀 How to Use

Just type it in the terminal:

$ tomato

Tip: For the best terminal resolution use setsid (the geometry depends on your font size):

$ setsid -f "$TERMINAL" -g 33x21 -c tomato -e tomato

🕹️ Controls and Preferences

Use the following keys to control the application:

• Arrows or VIM Keys: To moviment and select;
• ENTER: To select;
• CTRL+X: To return to the main menu wherever you are;
• ESC or Q: To quit.

You can configure the following settings:

• Pomodoros Amount;
• Work Time;
• Short Pause Time;
• Long Pause Time.

🍅 The Pomodoro Method

The technique basically consists of using a timer to break down work into intervals, follow the steps:

1. Get a to-do list;

2. Start Tomato.C and focus on a single task for 25 minutes straight until notification pops up;

3. Then record what you completed and enjoy a 5 minutes break;

4. After 4 pomodoros (steps 2 and 3), take a longer, 30 minutes break;

5. Restart.

Note: the timers and the amount of pomodoros can be changed by the user.

📝 To-do

• Make a welcome screen
• Rewrite using ncurses
• Implement input controls
• Implement user options
• Make it auto center
• Implement save current state
• Implement mouse support
• Implement simple note taking (maybe using a nvim instance)

⚓ Dependencies

It only needs gcc to compile, ncurses as the graphic library, dunst to show notifications and a Nerd Font for the icons.

🤝 Contribute

Feel free to contribute to the project, the only requirement is to follow the commit tittle pattern:

• File-Related-Emoji Tittle

📜 License

This software is licensed under the GPL-3 license.