About
The tool pymodoro-i3blocks lets you easily manage your Pymodoro sessions from within your status bar via i3blocks.
pymodoro-i3blocks is licensed under the Apache License version 2.0.
Get pymodoro-i3blocks
Released snapshots of the software are available for Download from GitHub, and are also distributed through the Python Package Index.
As free software, you can get a copy of the Source Code as well if you prefer.
Installation
To fetch the source files, build, and install it on your machine, the usage of pip is recommended:
pip install pymodoro-i3blocks --process-dependency-links
Arch Linux
A pymodoro-i3blocks Package can be found in the Arch User Repository (AUR). The AUR Helper Yaourt provides an easy way to install the application from the package:
yaourt -S pymodoro-i3blocks
Configuration
To get the application up and running, only few settings are required. The following instructions assume, that you have installed and properly configured i3blocks as well as Pymodoro.
-
Add Pymodoro as a blocklet to i3blocks, which displays the progress of your Pymodoro session. When no session is active, the blocklet will be hidden. An example is given below.
[pymodoro] command=/usr/bin/pymodoro-i3blocks --daemon interval=persist format=json
-
Add another blocklet that allows you to control your Pymodoro sessions. The instance property of the blocklet should match with the one of your Pymodoro configuration.
[pymodoro-control] command=/usr/bin/pymodoro-i3blocks instance=/run/user/1000/pymodoro_session interval=once format=json
-
Optionally modify the examples above, to match them to your preferred style. The usual i3blocks properties apply.
Please note that some of them may be overridden by pymodoro-i3blocks, e.g., the color of the session blocklet. At this time, this behavior cannot be changed without altering the program code. Feel free to request additional configuration options when needed.
-
Restart i3blocks. You should see the control blocklet afterwards.
Blocklet Usage
Click with your left mouse button on the pymodoro-control blocklet to start a new Pymodoro session. A right click ends the session.
Help and Support
If you have found a problem with the software, please check the Issue Tracker and file a report. Feedback and contributions are appreciated as well.
Contact
You can contact me by email at dev@roettger-it.de.