Gomoduino: notify your colleagues when you are on a pomodoro

But what is it?

Gomoduino provides a traffic light-like sign showcasing when you are on available and on a break, and when you are on a pomodoro. It was made on a couple of afternoons as an excuse to learn how D-Bus works.

Potato photos:

<img src="" width="600" /> <img src="" width="600" />

How it works

It works in conjunction with Gnome Pomodoro, a Gnome-Shell application for managing your Pomodoros, with presence awareness, notifications, messaging status changes and more.


Gomoduino is comprised of 2 parts, a Python script, and an Arduino firmware. Gnome Pomodoro showcases its state by D-Bus signals. Gomoduino's Python script connects to D-Bus, parses the signals and relays information about state changes to the Arduino counterpart via serial comm. Then, the simple Arduino firmware changes the LED output so your folks can leave you be on your pomodoros.

Here is the Arduino layout:

<img src="" width="600" />

Here is the Python script usage:

```terminal $ ./ -h usage: [-h] [-d] [-ns]

A script for inputting gnome-pomodoro's state to serial port

optional arguments: -h, --help show this help message and exit -d, --debug show debug messages -ns, --noserial don't try to connect serial port


See docs/ for more info on all of it.


For the Arduino part

Do it with Arduino IDE

(1). $ apt install arduino

or go console style:

(2). Install inotool

a. For Debian based systems: $ sudo apt-get install python-pip b. Install inotool: $ pip install --user inotool (never ever use pip with sudo!) c. Add ~/.local/bin to your PATH

For the Python script:

Debian: $ apt install python-dbus python-serial

Opensuse: $ zypper in dbus-1-python python-pyserial

Also, your user needs to be in the tty and dialout groups:

terminal $ sudo usermod -a -G tty $USER $ sudo usermod -a -G dialout $USER Remember to log off and on again for the changes to take effect.


Arduino part

Do it with Arduino IDE or go console style:

(2). $ cd firmware; ino build; ino upload.

Python part

You might need to change the serial device you are going to connect to.



This work is released under the terms of GPLv3 license. You can find a copy of the GPLv3 license in LICENSE file.


  • [ ] Make a systemd's unit service file for it
  • [ ] Improve host python script
  • [ ] Add time counter BCD display to the microcontroller (currently missing HW, lends welcome)
  • [ ] Make the script a nice python module to install it correctly

Looking for hackers with the skills:

hardware python systemd python3 microcontroller pomodoro

This project is part of:

Hack Week 14 Hack Week 15


  • about 4 years ago: vcuadradojuan liked this project.
  • almost 5 years ago: thutterer liked this project.
  • almost 5 years ago: tonghuix liked this project.
  • almost 5 years ago: tonghuix joined this project.
  • over 5 years ago: PSuarezHernandez liked this project.
  • over 5 years ago: thutterer liked this project.
  • over 5 years ago: dmaiocchi liked this project.
  • over 5 years ago: dwaas liked this project.
  • over 5 years ago: vcuadradojuan started this project.
  • over 5 years ago: vcuadradojuan added keyword "python" to this project.
  • All Activity


    Be the first to comment!

    Similar Projects

    Python bindings for Bosch Sensortec Environmental Cluster (BSEC) library by scabrero

    Project Description

    The BSEC library prov...

    Remote alarm system using RaspberryPi pico for box room by scabrero

    [comment]: # (Please use the project descriptio...

    work on sunxi a64 cpufreq driver (for teres-1, pine64) by mbrugger

    With the teres-1 [1] laptop we have a first arm...

    Learn python, python-gtk3, play with orangepi zero, experiment ili9341 and 20x4 LCD screen by aginies

    Project Description

    Learn python: get dat...

    Script that loads dummy data into HANA database for testing purposes. by rangelino

    [comment]: # (Please use the project descriptio...

    Learn python by building a homepage with Flask by mbrugger

    I thought it would be time to learn a new progr...

    Resurrect NWS CLI project by seanmarlow

    Project Description

    Many years back I cre...

    Build Microservice Architecture with Kubernetes by aqsa_malik

    Project Description

    The aim of the project ...

    Anomaly analyser, predictor for kubernetes(Rancher) by sbabusadhu

    [comment]: # (Please use the project descriptio...

    Cluster Python API by fmherschel

    [comment]: # (Please use the project descriptio...