Skip to content

jamesponddotco/taskemon

Repository files navigation

taskemon

A photo of a board with several tasks printed and displayed.

taskemon is a very simple CLI tool that prints daily task tickets on a thermal printer, complete with a QR code that links to a random Pokémon as a "reward" for motivation. Basically, it's part of a process that helps you apply feedback loops to your tasks.

I was inspired by this article by Laurie Hérault which explains how understanding the science of video games helped them "cure" their procrastination—you're encouraged to read the article for a better understanding. The Pokémon part came from this comment by PaulHoule on Hacker News.

Important

taskemon only supports the Epson TM-T20II thermal printer via USB right now, and was only tested on macOS Sequoia. Patches or PRs to support other models or networked printers are welcome!

Features

  • Prints styled task tickets with owner, category, and task description.
  • Generates a QR code linking to a random Pokémon Pokédex entry, or, rarely, a fun surprise.
  • Supports the Epson TM-T20II thermal printer via USB out of the box.

Installation

From source

First install the dependencies:

  • Go 1.24 or above.
  • make.
  • libusb

Then, clone the repository, switch to the latest stable tag, compile, and install:

git clone 'git.sr.ht/~jamesponddotco/taskemon'
cd 'taskemon'
git checkout 'v0.1.0'
make
sudo make install

Usage

$ taskemon --help
Usage of taskemon:
  -owner string
        the person responsible for the task
  -task string
        the task description

Contributing

Anyone can help make taskemon better. Check out the contribution guidelines for more information.

Resources

The following resources are available:


The work in this repository complies with the REUSE specification. While the default license is EUPL-1.2, individual files may be licensed differently.

Please see the individual files for details and the LICENSES directory for a full list of licenses used in this repository.