CircularLabels 1.0.1

.NET 6.0
dotnet tool install --global CircularLabels --version 1.0.1
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest # if you are setting up this repo
dotnet tool install --local CircularLabels --version 1.0.1
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=CircularLabels&version=1.0.1
nuke :add-package CircularLabels --version 1.0.1


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.


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.




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

Install the application with this command:

dotnet tool install CircularLabels --global


From a command line, simply type:

CircularLabels.exe --help

and the following help-screen will be displayed:

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

  -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:

sample pdf

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

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed. 
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last updated
1.0.1 128 10/29/2022
1.0.0 113 10/29/2022