From e6713a2ffbc13ab8c1f41fbf985f832b4342d570 Mon Sep 17 00:00:00 2001
From: Cairn <cairn@pm.me>
Date: Thu, 1 Sep 2022 09:05:59 -0400
Subject: [PATCH] pixterm: add page (#8411)

---
 pages/common/pixterm.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 pages/common/pixterm.md

diff --git a/pages/common/pixterm.md b/pages/common/pixterm.md
new file mode 100644
index 0000000000..ec12084190
--- /dev/null
+++ b/pages/common/pixterm.md
@@ -0,0 +1,21 @@
+# pixterm
+
+> Image printing in the terminal.
+> See also: `chafa`, `catimg`.
+> More information: <https://github.com/eliukblau/pixterm>.
+
+- Render a static image directly in the terminal:
+
+`pixterm {{path/to/file}}`
+
+- Use the image's original aspect ratio:
+
+`pixterm -s 2 {{path/to/file}}`
+
+- Specify a custom aspect ratio using a specific number of [t]erminal [r]ows and [c]olumns:
+
+`pixterm -tr {{24}} -tc {{80}} {{path/to/file}}`
+
+- Filter the output with a [m]atte background color and character [d]ithering:
+
+`pixterm -m {{000000}} -d 2 {{path/to/file}}`