tippex 0.0.1__tar.gz

tippex-0.0.1/.gitignore

@@ -0,0 +1,5 @@
+.venv/
+__pycache__/
+.DS_Store
+*.pdf
+dist/

tippex-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dannyfriar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tippex-0.0.1/PKG-INFO

@@ -0,0 +1,50 @@
+Metadata-Version: 2.5
+Name: tippex
+Version: 0.0.1
+Summary: The simplest possible PDF text editor, for macOS
+Project-URL: Homepage, https://github.com/dannyfriar/tippex
+Author-email: dannyfriar <dfriar93@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Environment :: MacOS X
+Classifier: Operating System :: MacOS
+Classifier: Topic :: Office/Business
+Requires-Python: >=3.9
+Requires-Dist: pymupdf>=1.24
+Description-Content-Type: text/markdown
+
+# Tippex
+
+The simplest possible PDF text editor, for macOS.
+
+## Install
+
+```
+uv tool install tippex
+```
+
+or `pipx install tippex`, or `uv pip install tippex` into an environment of your choice.
+
+Without uv or pipx:
+
+```
+curl -fsSL https://raw.githubusercontent.com/dannyfriar/tippex/main/install.sh | sh
+```
+
+## Use
+
+```
+tippex path/to/file.pdf
+```
+
+A browser tab opens showing the PDF. Click any line of text and type over it.
+
+The first time you press **Save…** (or ⌘S), the macOS Save dialog asks where to put the file, suggesting `file-tippexed.pdf` next to the original. After that, **Save** (⌘S) writes to the same file, and **Save As…** (⇧⌘S) picks a new one. The banner under the toolbar always shows where the file is saved, with a link to show it in Finder. Press Ctrl+C in Terminal to quit.
+
+The first run creates a local `.venv` and installs [PyMuPDF](https://pymupdf.readthedocs.io/).
+
+## Limitations
+
+- Edited lines are redrawn in Helvetica (bold if the original was bold) at the original size and color.
+- Editing is one line at a time; long replacements don't wrap.
+- Scanned PDFs have no text layer, so there is nothing to edit.

tippex-0.0.1/README.md

@@ -0,0 +1,35 @@
+# Tippex
+
+The simplest possible PDF text editor, for macOS.
+
+## Install
+
+```
+uv tool install tippex
+```
+
+or `pipx install tippex`, or `uv pip install tippex` into an environment of your choice.
+
+Without uv or pipx:
+
+```
+curl -fsSL https://raw.githubusercontent.com/dannyfriar/tippex/main/install.sh | sh
+```
+
+## Use
+
+```
+tippex path/to/file.pdf
+```
+
+A browser tab opens showing the PDF. Click any line of text and type over it.
+
+The first time you press **Save…** (or ⌘S), the macOS Save dialog asks where to put the file, suggesting `file-tippexed.pdf` next to the original. After that, **Save** (⌘S) writes to the same file, and **Save As…** (⇧⌘S) picks a new one. The banner under the toolbar always shows where the file is saved, with a link to show it in Finder. Press Ctrl+C in Terminal to quit.
+
+The first run creates a local `.venv` and installs [PyMuPDF](https://pymupdf.readthedocs.io/).
+
+## Limitations
+
+- Edited lines are redrawn in Helvetica (bold if the original was bold) at the original size and color.
+- Editing is one line at a time; long replacements don't wrap.
+- Scanned PDFs have no text layer, so there is nothing to edit.

tippex-0.0.1/pyproject.toml

@@ -0,0 +1,33 @@
+[project]
+name = "tippex"
+dynamic = ["version"]
+description = "The simplest possible PDF text editor, for macOS"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [{ name = "dannyfriar", email = "dfriar93@gmail.com" }]
+dependencies = ["pymupdf>=1.24"]
+classifiers = [
+    "Operating System :: MacOS",
+    "Environment :: MacOS X",
+    "Topic :: Office/Business",
+]
+
+[project.urls]
+Homepage = "https://github.com/dannyfriar/tippex"
+
+[project.scripts]
+tippex = "tippex:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+path = "tippex.py"
+
+[tool.hatch.build.targets.wheel]
+only-include = ["tippex.py"]
+
+[tool.hatch.build.targets.sdist]
+include = ["tippex.py", "README.md", "LICENSE"]

tippex-0.0.1/tippex.py

@@ -0,0 +1,201 @@
+"""Tippex: minimal PDF text editor for macOS. Usage: tippex file.pdf"""
+import base64, json, subprocess, sys, threading, urllib.parse, webbrowser
+from http.server import BaseHTTPRequestHandler, HTTPServer
+from pathlib import Path
+
+import pymupdf
+
+__version__ = "0.0.1"
+
+SRC = None  # the PDF being edited; set in main()
+ORIGINAL = None  # its bytes; edits always apply to this, so saving over SRC is safe
+OUT = None  # chosen via the Save dialog on first save
+ZOOM = 1.5
+
+# Correction-fluid brush painting a white stroke.
+LOGO = """<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32">
+<path d="M3 27.5c5-3.5 9-1 15-5" fill="none" stroke="#9aa4b2" stroke-width="5.5" stroke-linecap="round"/>
+<path d="M3 27.5c5-3.5 9-1 15-5" fill="none" stroke="#fff" stroke-width="3.5" stroke-linecap="round"/>
+<g transform="translate(18.5 21.5) rotate(45)">
+<rect x="-3.2" y="-21" width="6.4" height="12" rx="2" fill="#e8413a"/>
+<rect x="-3.2" y="-21" width="2" height="12" rx="1" fill="#ff7a70"/>
+<rect x="-2.9" y="-9.5" width="5.8" height="3" fill="#c9ced6"/>
+<path d="M-2.6 -6.5h5.2c0 3.2-1.2 5.6-2.6 6.8c-1.4-1.2-2.6-3.6-2.6-6.8z" fill="#fff" stroke="#9aa4b2" stroke-width=".8"/>
+</g></svg>"""
+FAVICON = "data:image/svg+xml," + urllib.parse.quote(LOGO)
+
+
+def lines(page):
+    for block in page.get_text("dict")["blocks"]:
+        for line in block.get("lines", []):
+            spans = [s for s in line["spans"] if s["text"].strip()]
+            if spans:
+                yield line["bbox"], "".join(s["text"] for s in line["spans"]), spans[0]
+
+
+def build_page():
+    doc = pymupdf.open(stream=ORIGINAL)
+    html = []
+    for pno, page in enumerate(doc):
+        png = base64.b64encode(page.get_pixmap(matrix=pymupdf.Matrix(ZOOM, ZOOM)).tobytes("png")).decode()
+        boxes = []
+        for i, (bbox, text, span) in enumerate(lines(page)):
+            x0, y0, x1, y1 = (v * ZOOM for v in bbox)
+            boxes.append(
+                f'<input data-p="{pno}" data-i="{i}" value="{escape(text)}" data-orig="{escape(text)}" '
+                f'style="left:{x0}px;top:{y0}px;width:{x1 - x0 + 40}px;height:{y1 - y0}px;font-size:{span["size"] * ZOOM * 0.9}px">'
+            )
+        html.append(f'<div class="page"><img src="data:image/png;base64,{png}">{"".join(boxes)}</div>')
+    return TEMPLATE.replace("{{LOGO}}", LOGO).replace("{{FAVICON}}", FAVICON).replace("{{NAME}}", escape(SRC.name)).replace("{{PAGES}}", "".join(html))
+
+
+def escape(s):
+    return s.replace("&", "&amp;").replace('"', "&quot;").replace("<", "&lt;")
+
+
+def ask_save_path():
+    """Show the native macOS Save dialog. Returns a Path, or None if cancelled."""
+    default = OUT or SRC.with_name(SRC.stem + "-tippexed.pdf")
+    q = lambda v: json.dumps(str(v), ensure_ascii=False)
+    script = [
+        "activate",
+        f'set f to choose file name with prompt "Save edited PDF as:" default name {q(default.name)} '
+        f"default location (POSIX file {q(default.parent)})",
+        "POSIX path of f",
+    ]
+    r = subprocess.run(["osascript", *(a for line in script for a in ("-e", line))], capture_output=True, text=True)
+    if r.returncode:
+        if "-128" in r.stderr:  # user pressed Cancel
+            return None
+        raise RuntimeError(r.stderr.strip())
+    path = Path(r.stdout.strip())
+    return path if path.suffix.lower() == ".pdf" else path.with_name(path.name + ".pdf")
+
+
+def save(edits, path):
+    doc = pymupdf.open(stream=ORIGINAL)
+    for pno in {e["p"] for e in edits}:
+        page = doc[pno]
+        page_lines = list(lines(page))
+        todo = [(page_lines[e["i"]], e["text"]) for e in edits if e["p"] == pno]
+        for (bbox, _, _), _ in todo:
+            page.add_redact_annot(bbox, fill=False)
+        page.apply_redactions(images=pymupdf.PDF_REDACT_IMAGE_NONE, graphics=pymupdf.PDF_REDACT_LINE_ART_NONE)
+        for (bbox, _, span), text in todo:
+            c = span["color"]
+            color = ((c >> 16) / 255, ((c >> 8) & 255) / 255, (c & 255) / 255)
+            bold = "bold" in span["font"].lower()
+            page.insert_text(span["origin"], text, fontsize=span["size"], fontname="hebo" if bold else "helv", color=color)
+    doc.save(path, garbage=3, deflate=True)
+
+
+class Handler(BaseHTTPRequestHandler):
+    def do_GET(self):
+        self.reply(build_page().encode(), "text/html")
+
+    def do_POST(self):
+        global OUT
+        body = json.loads(self.rfile.read(int(self.headers["Content-Length"])))
+        if self.path == "/reveal":
+            subprocess.run(["open", "-R", str(OUT)])
+            return self.reply(b"{}", "application/json")
+        try:
+            path = OUT
+            if path is None or body["saveAs"]:
+                path = ask_save_path()
+                if path is None:
+                    return self.reply(json.dumps({"cancelled": True}).encode(), "application/json")
+            save(body["edits"], path)
+            OUT = path
+            result = {"path": str(path)}
+        except Exception as e:
+            result = {"error": str(e)}
+        self.reply(json.dumps(result).encode(), "application/json")
+
+    def reply(self, body, ctype):
+        self.send_response(200)
+        self.send_header("Content-Type", ctype + "; charset=utf-8")
+        self.end_headers()
+        self.wfile.write(body)
+
+    def log_message(self, *args):
+        pass
+
+
+TEMPLATE = """<!doctype html><meta charset="utf-8"><title>Tippex – {{NAME}}</title><link rel="icon" href="{{FAVICON}}">
+<style>
+body{margin:0;background:#888;font-family:-apple-system,sans-serif}
+header{position:sticky;top:0;z-index:9;background:#222;color:#fff;padding:10px 16px;display:flex;gap:12px;align-items:center;flex-wrap:wrap}
+header .grow{flex:1}
+.brand{display:flex;align-items:center;gap:8px;font-weight:700;font-size:17px;letter-spacing:.3px}
+.brand svg{width:30px;height:30px}
+.dim{color:#aaa}
+button{font-size:15px;padding:6px 16px}
+#dest{position:sticky;top:52px;z-index:8;background:#fffbe6;color:#333;padding:8px 16px;font-size:13px;border-bottom:1px solid #e5d98a;word-break:break-all}
+#dest a{margin-left:8px;color:#06c}
+.page{position:relative;width:max-content;margin:20px auto;box-shadow:0 2px 10px #0006}
+.page img{display:block}
+.page input{position:absolute;box-sizing:border-box;border:1px solid transparent;background:transparent;color:transparent;padding:0;font-family:Helvetica,Arial,sans-serif;outline:none}
+.page input:hover{border-color:#39f8}
+.page input:focus,.page input.changed{background:#fff;color:#000;border-color:#39f}
+</style>
+<header>
+  <span class="brand">{{LOGO}}Tippex</span><span class="dim">{{NAME}}</span>
+  <span class="grow"></span>
+  <span id="status" class="dim"></span>
+  <button id="save">Save…</button><button id="saveas" hidden>Save As…</button>
+</header>
+<div id="dest">Not saved yet. You'll choose where to save the first time you press Save.</div>
+{{PAGES}}
+<script>
+let savedPath = null, dirty = false;
+const $ = id => document.getElementById(id);
+const setDirty = d => { dirty = d; $('status').textContent = d ? 'Unsaved changes' : (savedPath ? 'All changes saved' : ''); };
+
+document.querySelectorAll('.page input').forEach(el => el.addEventListener('input', () => {
+  el.classList.toggle('changed', el.value !== el.dataset.orig);
+  setDirty(true);
+}));
+
+async function save(saveAs) {
+  const edits = [...document.querySelectorAll('input.changed')].map(el => ({p: +el.dataset.p, i: +el.dataset.i, text: el.value}));
+  $('status').textContent = savedPath && !saveAs ? 'Saving…' : 'Choose where to save…';
+  const r = await (await fetch('/save', {method: 'POST', body: JSON.stringify({edits, saveAs})})).json();
+  if (r.cancelled) return setDirty(dirty);
+  if (r.error) return $('status').textContent = 'Error: ' + r.error;
+  savedPath = r.path;
+  $('dest').innerHTML = 'Saving to <b></b> <a href="#">Show in Finder</a>';
+  $('dest').querySelector('b').textContent = savedPath;
+  $('dest').querySelector('a').onclick = e => { e.preventDefault(); fetch('/reveal', {method: 'POST', body: '{}'}); };
+  $('save').textContent = 'Save';
+  $('saveas').hidden = false;
+  setDirty(false);
+}
+$('save').onclick = () => save(false);
+$('saveas').onclick = () => save(true);
+document.addEventListener('keydown', e => {
+  if (e.metaKey && e.key.toLowerCase() === 's') { e.preventDefault(); save(e.shiftKey); }
+});
+addEventListener('beforeunload', e => { if (dirty) e.preventDefault(); });
+</script>"""
+
+def main():
+    global SRC, ORIGINAL
+    if len(sys.argv) != 2 or sys.argv[1] in ("-h", "--help"):
+        sys.exit("Usage: tippex file.pdf")
+    SRC = Path(sys.argv[1]).expanduser().resolve()
+    if not SRC.is_file():
+        sys.exit(f"No such file: {SRC}")
+    ORIGINAL = SRC.read_bytes()
+    server = HTTPServer(("127.0.0.1", 0), Handler)
+    url = f"http://127.0.0.1:{server.server_port}/"
+    print(f"Editing {SRC.name} at {url}\nPress Ctrl+C to quit.")
+    threading.Timer(0.3, webbrowser.open, [url]).start()
+    try:
+        server.serve_forever()
+    except KeyboardInterrupt:
+        pass
+
+
+if __name__ == "__main__":
+    main()