CircularLabels 1.0.1

CircularLabels

This is a simple console application that supports A4 sheets of 7 by 10 circular self adhesive labels like the ones you can buy here.

Background

As a homebrewer I always intend to put fancy labels on my bottles, that holds details about the brew, links to Untappd and what have we...

In reality, I often find my refrigerator full of unlabeled bottles perhaps with different color lids, but often only with a different shade of content to identify my homebrews.

Then I learned about the little round labels that fit on the lid and was no big deal to apply when bottling day was up.

Obviusly I could just put a few letters on the label with a pen, but being a passionate programmer, I had to come up with a solution to use my laser printer to put something on my labels.

I typically end up with say 42 bottles in a batch. I would rather not spend an entire sheet of 70 labels each time, hence the application supports conservation of resources. On a new sheet of labels I would make the application produce 42 labels, and on next brewday, I could reuse the first sheet along with a new sheet asking the application to skip the 42 used labels and produce 42 new labels. The application then uses the remaining 28 labels on the first sheet and 14 on the second sheet.

Installation

Prerequisites

This requires that you have dotnet 6 or later (Runtime should suffice) installed.

Install the application with this command:

dotnet tool install CircularLabels --global

Usage

From a command line, simply type:

CircularLabels.exe --help

and the following help-screen will be displayed:

CircularLabels v.1.0.0.0
Usage: CircularLabels.exe [OPTIONS]
Builds a PDF with circular labels on an A4 sheet with 7 x 10 labels.

Options:
  -i, --image=VALUE          Path to .png .jpeg or .bmp image to put on labels.
  -t, --text=VALUE           Text to put on labels. (lines can be separated by
                               pipe | character)
  -s, --skip=VALUE           Number of labels to skip.
  -n, --number=VALUE         Number of labels to print.
  -o, --output=VALUE         Output filename.
  -p, --placeholder          Show adjustment placeholders.
  -h, --help                 show this message and exit

So if you have an image called BeerSanta.png in the Images directory, you cold type:

CircularLabels.exe -i ".\Images\BeerSanta.png" -t "My Beer|Christmas|2022" -o Labels.pdf -s 12 -n 20

which would produce a pdf using 20 labels and skipping the first 12:

Big kudos to Marcin Ziąbek for his excelent work with QuestPDF and the folks behind SkiaSharp