From d6e209418dfbabebe1cfef0ff5498046a70db4b3 Mon Sep 17 00:00:00 2001
From: kj_sh604
Date: Fri, 13 Feb 2026 01:50:53 -0500
Subject: feat: repo files

---
 README.md | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)
 create mode 100644 README.md

(limited to 'README.md')

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a1a5516
--- /dev/null
+++ b/README.md
@@ -0,0 +1,34 @@
+# kjandoc
+
+> i needed something to combine multiple pptx files, i couldn't believe pandoc can't do that, so here's a creative but probably useless attempt at it.
+
+## what it does
+- merges multiple .pptx files into one
+- preserves visual formatting by rendering slides and rebuilding a new deck
+- pandoc-style usage: `kjandoc input1.pptx input2.pptx -o combined.pptx`
+
+## why this exists
+pandoc is great, but it can't concatenate powerpoint decks. 
+
+this uses a headless libreoffice + pdf -> png rendering to get a pixel-perfect merge. 
+
+the tradeoff is the output slides are images (not editable shapes).
+
+## usage
+```bash
+# pandoc-style usage
+./kjandoc input1.pptx input2.pptx -o combined.pptx
+
+# tweak quality
+./kjandoc input1.pptx input2.pptx -o combined.pptx --dpi 150
+```
+
+## deps
+- python3
+- libreoffice
+- poppler (pdftoppm)
+- python deps in requirements.txt
+
+## notes
+- output size is larger (images)
+- visuals stay intact for the most part
\ No newline at end of file
-- 
cgit v1.2.3