Do not disturb, I'm in the middle of a pomodoro!

pomidor == tomato in Polish

I think I need a visual cue for my coworkers to see if I am busy and would prefer to avoid interruptions. They may get a little distracted every time I start/stop my Pomodoro timer but that's a sacrifice I am willing to make ;>

• to track Pomodoros I use Toggl + Chrome plugin. The plugin starts timer for a Toggl task and automatically stops after 25 minutes.
• this setup polls Toggl API to see if I have an active time entry (i.e. I'm working on something)
• depending on the API query result, a physical 'pomodoro' flag is raised or lowered. I am using a MicroPython board connected through USB (serial) and a servo motor (HXT500). My ultra-professional flag is made from a drinking straw and a piece of paper colored with red isolation tape.
• if you do your own Pomodoro flag you should totally use googly eyes

Here it is in action: https://photos.app.goo.gl/NbSyeTXG1vy9MM5KA

TODO (maybe, someday):

• refactor
• CLI for raising/lowering the flag 'manually'
• Ansible plugin to activate the flag for playbooks which require more attention
• swap Micropython for something cheaper

Oh, if you'd like to run pomidor (tested on Ubuntu 17.10 Linux):

• clone this repo
• create a python3 virtualenv and activate it
• in the terminal, in the main project folder pip install -e .
• cp pomidor.sample.cfg pomidor.cfg (create config file)
• edit pomidor.cfg in your text editor. Set toggl_api_token. Maybe you will have to change device path, maybe not.
• connect servo to your MicroPython board. Useful docs here.
• plug the board to your computer using USB cable. A removable media should mount in your system. Copy the pyb/main.py file to the mounted pyboard. The servo number is hardcoded in the main.py file, as well as other values (angles). You may want to edit it.
• unmount the pyboard and reset it
• in the terminal with virtualenv activated, run pomidor pomidor.cfg or create an environment variable POMIDOR_CFG with the path to your config and run pomidor without params.
• the servo should move after a few seconds if you start/stop a task on Toggl. If wverything works, design your awesome 'busy' flag and attach it to the servo.
• have fun!