Skip to main content

Displays and manages Pymodoro session states via i3blocks.

Project description

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.

  1. 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
    
  2. 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
    
  3. 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.

  4. 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.

Changelog

Version 0.1.0 (2017-04-25)

First public release.

  • Displays a Pymodoro session state with i3blocks.
  • Start and stop sessions by clicking on a blocklet.

Project details


Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pymodoro-i3blocks, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size pymodoro-i3blocks-0.1.0.tar.gz (9.9 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page