Skip to content

Latest commit

 

History

History
43 lines (39 loc) · 1.67 KB

README.md

File metadata and controls

43 lines (39 loc) · 1.67 KB

pom

Simple pomodoro timer for macOS using shell commands and Mac automation alerts. By default, the timer runs four 25 minute work sessions interspersed with 5 minute breaks.

Instructions:

The easiest way to install and run this pomodoro timer (using a pipenv1) is:

  1. Open terminal and run:
$ git clone https://github.com/thomasjankovic/pom.git
$ cd pom
$ pipenv shell
(pom) $ python pom.py

Hint: use $ exit to exit the pipenv.
2. To customize the number of working sessions, add -s followed by the desired number of sessions. For example, the following runs three sessions:

(pom) $ python pom.py -s 3
  1. To customize the work session duration, add -w followed by the desired number of minutes. To customize the break duration, add -b followed by the desired number of minutes. For example, the following runs three 50 minute work sessions interspersed with 10 minute breaks:
(pom) $ python pom.py -s 3 -w 50 -b 10
  1. To cancel the entire session at any point, press control+c.

Screenshots:

End of session

End of break

End of timer

Laterbase:

  • Receive command line input for number of sessions.
  • Look into difference between time and datetime libraries. Should probably stick to just one. They seem suited to these particular use cases.
  • Recieve command line input for work session length and break length.
  • Custom alert icons.
  • Specify reqs and use virtual environment.
  • 5 more minutes button.
  • Skip break button.
  • Pause button?

Footnotes:

Footnotes

  1. Use $ sudo -H pip install -U pipenv if pipenv isn't installed on your machine. ↩