From 4d1b8df2e38f448575a88b0c182bec288a7e14c3 Mon Sep 17 00:00:00 2001
From: randogoth <kflux@posteo.de>
Date: Wed, 4 Feb 2026 18:26:50 +0200
Subject: [PATCH] docs(printing): reduce default drivers

---
 docs/printing.md           | 57 ++++++++++++++++++++++++++++++++++++++
 modules/system/printer.nix | 24 +---------------
 2 files changed, 58 insertions(+), 23 deletions(-)
 create mode 100644 docs/printing.md

diff --git a/docs/printing.md b/docs/printing.md
new file mode 100644
index 0000000..5a309ec
--- /dev/null
+++ b/docs/printing.md
@@ -0,0 +1,57 @@
+# Printing
+
+This repo enables the CUPS printing service via `modules/system/printer.nix`, but it does **not** bundle any
+printer driver packages by default.
+
+## Opt into drivers from a host file
+
+Add driver packages to `services.printing.drivers` in your host module. Example:
+
+```nix
+# hosts/my-host.nix
+{ pkgs, ... }:
+
+{
+  services.printing.drivers = [
+    pkgs.gutenprint
+  ];
+}
+```
+
+## Driver packages (cheat sheet)
+
+Generic / common:
+
+- `pkgs.gutenprint` — various printer drivers
+- `pkgs.gutenprintBin` — various binary printer drivers
+- `pkgs.cups-filters`
+- `pkgs.cups-browsed`
+
+Brother:
+
+- `pkgs.brgenml1cupswrapper`
+- `pkgs.brgenml1lpr`
+- `pkgs.brlaser`
+
+Canon:
+
+- `pkgs.cnijfilter2` — Canon Pixma drivers
+
+Epson:
+
+- `pkgs.epson-escpr`
+- `pkgs.epson-escpr2`
+
+HP:
+
+- `pkgs.hplip`
+- `pkgs.hplipWithPlugin` — proprietary plug-ins
+
+Lexmark:
+
+- `pkgs.postscript-lexmark`
+
+Samsung:
+
+- `pkgs.samsung-unified-linux-driver`
+- `pkgs.splix` — drivers for Samsung Printer Language printers
diff --git a/modules/system/printer.nix b/modules/system/printer.nix
index bcaeab6..5143b7d 100644
--- a/modules/system/printer.nix
+++ b/modules/system/printer.nix
@@ -1,27 +1,5 @@
 { pkgs, ... }:
 
 {
-  services.printing = {
-    enable = true;
-    drivers = [
-      # The generic CUPS and Gutenprint drivers usually suffice for most printers
-      # Uncomment the drivers for your printer brand in case these don't work
-
-      # pkgs.brgenml1cupswrapper # Brother printer drivers
-      # pkgs.brgenml1lpr # Brother printer drivers
-      # pkgs.brlaser # Brother laser printer drivers
-      # pkgs.cnijfilter2 # Canon Pixma drivers
-      pkgs.cups-filters
-      pkgs.cups-browsed
-      # pkgs.epson-escpr # Epson printer drivers
-      # pkgs.epson-escpr2 # Newer Epson printer drivers
-      pkgs.gutenprint # Various printer drivers
-      pkgs.gutenprintBin # Various binary printer drivers
-      # pkgs.hplip # HP printer drivers
-      # pkgs.hplipWithPlugin # HP printer drivers with proprietary plug-ins
-      # pkgs.postscript-lexmark # Lexmark printer drivers
-      # pkgs.samsung-unified-linux-driver # Samsung printer drivers
-      # pkgs.splix # Drivers for Samsung Printer Language printers
-    ];
-  };
+  services.printing.enable = true;
 }