From 570dbbdd70f955ea171241c4da3c9c3e8565a19c Mon Sep 17 00:00:00 2001
From: tiyn <tiyn@posteo.eu>
Date: Wed, 24 Sep 2025 02:28:32 +0200
Subject: [PATCH] cups: added creation of custom formats for brother printers

---
 wiki/cups.md | 44 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)

diff --git a/wiki/cups.md b/wiki/cups.md
index b50404a..103aa8f 100644
--- a/wiki/cups.md
+++ b/wiki/cups.md
@@ -43,3 +43,47 @@ This is done by appending it the the mentioned connection string and will look l
 `usb://Brother/QL-600?serial=000J1Z140282`.
 The examples using the Brother printer are taken from a
 [dwaves article](https://dwaves.de/2022/07/13/gnu-linux-debian-11-how-to-setup-brother-ql-600-labelprinter/).
+
+### Custom Formats For Brother Printers 
+
+Especially when using continuos-length Brother label printers it can be useful to set up custom
+formats.
+After setting up the CUPS install the package that provides
+`brpapertoollpr_<printer name in cups>` which differs from printer to printer.
+For example when using a Brother QL-600 this command is named `brpapertoollpr_ql600` and on some
+[Linux](/wiki/linux.md) distributions like [Arch Linux](/wiki/linux/arch-linux.md) is provided in a
+package called `brother-ql600`.
+
+To then set up a new custom format run the following command.
+
+```sh 
+brpapertoollpr_<printer name in command> -P <printer name in cups> -n <format name> -w <width> -h <height>
+```
+
+`<printer name in command>` is the part of the command that corresponds to the printer as described
+in the previous sentence.
+`<printer name in cups>` and `<format name>` are the name of the printer already set up and given in
+CUPS and the name chosen for the new format.
+And `<width>` and `<height>` are width and height of the new format both given in millimeters.
+A complete command could look something like the following. 
+
+
+```sh 
+brpapertoollpr_ql600 -P Brother_QL-600 -n "62mmx12mm" -w 62 -h 12
+```
+
+The command to delete a custom format is the following.
+It uses the same variables and names as the command above.
+
+```sh 
+brpapertoollpr_ql600 -P <printer name> -d <format name>
+```
+
+The usage of this command could look similar to the following example.
+
+```sh 
+brpapertoollpr_ql600 -P Brother_QL-600 -d "62mmx12mm"
+```
+
+After setting up the new format it can be selected in the CUPS interface and used with the Brother
+printer it was set up for.