Homebox Label Generator

Opinionated label generator for homebox.

This is different from the built-in label generator in homebox, as it generates labels with a different design.

Design

QR code on the left. Next to that: asset name. At the bottom: asset id and contact info. Between the asset name and the asset id, there is space for you to pencil something in. What else do you need?

Usage

1. Clone this repo and install the dependencies with bun: bun i
2. Create a empty labels folder in the root of this project.
3. Create a config.json file in the root of this project with the following content:

{
	"username": "...",
	"password": "...",
	"contact": "...",
	"homebox": "https://.../",
	"assets": [1, 2, 3, 4]
}

The contact field can be anything you want, it will be displayed on the bottom of the label.

The homebox field should be the URL to your homebox instance with a trailing slash (IMPORTANT).

The assets field should be an array of asset IDs (ex. asset ID #001-234 becomes just 1234) that you want to generate labels for, they can be in any order you want them to be in, it doesn't matter. If an asset has a quantity of more than 1, it will automatically insert that many labels for that asset. Please note that you may not generate more than 33 labels at once. If you are generating more than 33 labels, all labels after the 33rd will have a part of the QR code cut off, rendering them unusable.

4. Run with bun run main.ts
5. You can now print the A4 sheet at labels/A4_sheet.png and cut out the labels.