🎭Pomodoro Running with ethical hacking tools🎭

Short version: A curses-based Pomodoro that can execute tools (nmap, gobuster, dirb, etc.) detached and save the output to a per-tool log folder.

NOTE

THIS REPO IS STILL IN TESTING, FOR THIS LACK, THERE ARE STILL MANY IMPROVEMENTS TO BE FIXED, FOR INSTALLATION USERS HAVE TO CHANGE THE PATH MANUALLY... (I'm sorry)

Author: ardx

GOAL : idk

I HOPE U R'NOT SKIDS joke dude...😓😓

Key Features

• Curses-based terminal UI with a large clock display (tty-clock style).
• Executes commands detached when a focus session starts (-c/--cmd).
• Saves Pomodoro event logs to CSV.
• Saves tool output to /home/ardx/pomonmap/logs//YYYYMMDDTHHMMSS_.log.
• Wrapper (pomo-cmd-wrapper.sh) for: per-tool subfolders, PID files, header metadata, and an END line when the job completes.
• Flexible duration format support: 25, 10m, 2h, 1:30, etc.
• UI keybindings: SPACE pause/resume, n skip, r reset, q/ESC quit.

installation:

mkdir -p logs
cd pomonmap
chmod 700 /home/{USERNAME}/logs
chmod +x main.py
chmod +x ~/pomonmap/pomonmap/bin/wrapper.sh

logs:

• CSV Pomodoro = /home/{USERNAME}/pomonmap/logs/pomo_clock_log.csv
• Output = /home/{USERNAME}/pomonmap/logs//YYYYMMDDTHHMMSS_<sanitized_cmd>.log
• PID = /home/ardx/pomonmap/logs//YYYYMMDDTHHMMSS.pid

Dir List

TROUBLESHOOTING

• Error parsing duration: If the first argument is not a duration, use -c or place the command after the duration.
• No log output: Check the logs folder permissions and ensure the wrapper/script has write permissions.
• Tool requires root: Run the wrapper in the home-lab VM as root or use sudo for the wrapper with secure sudoers rules.
• Terminal error while job is running: Always use a detached wrapper; do not run interactive tools from the main process.

EXAMPLE

python3 main.py "nmap -Pn 216.239.38.120"
python3 main.py -c "~/bin/pomo-cmd-wrapper.sh nmap -Pn -sC -sV 192.168.56.101"