mobtime

An interactive timer built on top of mob.sh that automates keyboard switching during mob programming sessions.

1. Clone this project

git clone https://github.com/Julien-Fischer/mobtime.git

2. Run the installation wizard

./install.sh

A mobtime session typically involves two steps:

1. mobstart to start driving:
2. Stop driving. You can either type:
   • mobnext to pass the keyboard to someone else, or
   • mobdone to end the mob session

• Bash
• Git
• mob.sh
• Java Runtime Environment (JRE) 21
• Maven (when installing mobtime for the first time)

This software was designed for Linux, and was primarily tested on Debian 12 and Kubuntu 24.

• --start (Command) Start a new driving session
  • --duration (Option) Set session duration in minutes (15 by default). Accepts: any positive integer
  • --auto-next (Option) Automatically execute mob next when time runs out
  • --focus (Option) Set the focus mode (normal by default). Accepts: normal, chill, zen
  • --reset (Option) Reset the activity timer to the specified --duration (15 by default)
  • --log-level (Option) Set the log level (INFO by default). Accepts: DEBUG, INFO, ERROR
• --mini (Option) Minimize the GUI
• --location (Option) Set GUI location (north by default). Accepts: center, north, north-east, east, south-east, etc...
• --user-name (Option) Set a username for this session (Driver by default)

• mobstart Start a driving session with default duration
• mobstart 7 Start a 7-minute driving session
• mobstart --auto-next Automatically execute mobnext when time runs out
• mobstart --duration=7 --focus=zen --location=north-east --mini Start a 7-minute driving session in Zen mode with a minimalist UI. The timer will be displayed in the top-right corner of the screen.

Special thanks to Dr. Simmon Harrer & Josen Christ for their outstanding work on mob.sh.

Deep gratitude to my colleagues at Datanumia for our exciting mob programming sessions: Josian Chevalier, Thierry Lav, Elie Guedj, Amine Chaari, Rym Ben-Ali, and Sébastien Lamps.

mobtime is available under the MIT License.