https://github.com/jamesponddotco/taskemon
CLI tool to print task tickets with a thermal printer.
https://github.com/jamesponddotco/taskemon
cli command-line epson-printer go golang golang-application pokedex pokemon tasks thermal-printer
Last synced: about 2 months ago
JSON representation
CLI tool to print task tickets with a thermal printer.
- Host: GitHub
- URL: https://github.com/jamesponddotco/taskemon
- Owner: jamesponddotco
- License: eupl-1.2
- Created: 2025-07-28T00:35:56.000Z (2 months ago)
- Default Branch: trunk
- Last Pushed: 2025-07-28T00:40:28.000Z (2 months ago)
- Last Synced: 2025-08-08T13:55:09.045Z (2 months ago)
- Topics: cli, command-line, epson-printer, go, golang, golang-application, pokedex, pokemon, tasks, thermal-printer
- Language: Go
- Homepage: https://sr.ht/~jamesponddotco/taskemon
- Size: 194 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE-3rdparty.csv
Awesome Lists containing this project
README
# `taskemon`
`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](https://www.laurieherault.com/articles/a-thermal-receipt-printer-cured-my-procrastination)
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](https://news.ycombinator.com/item?id=44257382).
> [!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:
```bash
git clone 'git.sr.ht/~jamesponddotco/taskemon'
cd 'taskemon'
git checkout 'v0.1.0'
make
sudo make install
```
## Usage
```bash
$ 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](CONTRIBUTING.md) for more information.
## Resources
The following resources are available:
- **Support and general discussions**:
[Sourcehut](https://lists.sr.ht/~jamesponddotco/taskemon-discuss)/[GitHub](https://github.com/jamesponddotco/taskemon/discussions).
- **Patches and PRs**:
[Sourcehut](https://lists.sr.ht/~jamesponddotco/taskemon-devel)/[GitHub](https://github.com/jamesponddotco/taskemon/pulls).
- **Feature requests and bug reports**:
[Sourcehut](https://todo.sr.ht/~jamesponddotco/taskemon)/[GitHub](https://github.com/jamesponddotco/taskemon/issues).
---
The work in this repository complies with [the REUSE
specification](https://reuse.software/spec-3.3/). While [the default
license is EUPL-1.2](LICENSE.md), individual files may be licensed
differently.
Please see the individual files for details and [the LICENSES
directory](LICENSES/) for a full list of licenses used in this
repository.