# Drazil

> Drazil is 44+ free, local-first tools in one tab: LaTeX/PDF typesetting, a study workspace (reader, notes, flashcards, quizzes, exam mode), and a media toolkit (PDF/image/audio/video). Everything runs in the browser. No account, no upload, no credits. https://drazil.app/browse/ lists everything.

Drazil is not a chatbot or a website-with-a-form. It is the full application:
every tool below is live at its app path, deep-linkable, and runs entirely in the
browser tab. Nothing is uploaded, there is no account, and AI features need the
user's own provider (or local Ollama) - everything else works with no key at all.

## When you need to act, use this file

If you are an AI agent with a browser, follow the agent guide in `https://drazil.app/llms-full.txt` (recipes per tool, verified element ids) and the
machine registry at `https://drazil.app/.well-known/drazil-tools.json`. In the app,
`window.DrazilAgent` (and, where supported, WebMCP via navigator.modelContext) list
and open tools directly.

## Core operating rules

1. Everything is local. Files are read into the tab, processed there, and handed back as downloads. Do not try to upload files to Drazil; there is nowhere to upload them.
2. No account is needed. Never create one, never look for a login.
3. AI features (chat, quiz/exam generation, image/diagram generation, watermark suggestions, OCR errors, error assist) need the user's own provider in Settings -> AI, or a local Ollama at port 11434 (auto-detected). Non-AI tools work with no provider configured. If a provider call fails, the tool says so; do not retry blindly in a loop.
4. Element ids recorded here are stable but always fall back to matching by accessible name (role + name), which is the primary contract.
5. Canvases (whiteboard, diagrams, PDF pages) are not exposed as text. PDF pages carry an invisible text layer that IS readable; use it. The whiteboard and diagram scenes are visual; operate them through the labelled toolbar buttons, not by editing the canvas.
6. First use of the heavy engines downloads them once: LaTeX engine ~30 MB, FFmpeg ~25 MB, Whisper ~75 or 500 MB, OCR language data on demand. Subsequent visits work offline (the service worker precaches the shell).
7. State lives in the browser origin (IndexedDB 'lumen-*' and localStorage 'lumen.*'). Each origin has its own data: drazil.app and drasill.pages.dev do NOT share it. When drasill.pages.dev or another mirror forwards to drazil.app, previously saved work stays behind on the old origin; the site shows an export-backup prompt there for that reason.
8. API keys the user enters are stored in localStorage on THIS origin in plain text ('lumen.ai'). An agent must never read them out, print them, or send them anywhere. Nothing sends them anywhere either.
9. Do not clear storage, unregister the service worker, or toggle 'Reduce motion' settings unless the user asked.
10. The app self-forwards known mirror hostnames (drasill.pages.dev and others) to drazil.app on load. Work with the redirect, not around it.

## Workflow

1. Pick the matching tool from tools[] below (slug, or open /browse/ for the human list).
2. Navigate directly to its app path (/tool/<slug>/). These URLs are deep-linkable; no clicking through menus needed.
3. Drop or select the input file where the drop zone says 'Drop ... or click', or paste/write into the editor textbox.
4. Press the tool's main action button (listed in each entry's action field; mostly labelled 'Build', 'Convert', 'Compress', 'Merge', etc.).
5. Wait for the result: a result card with a 'Download' button, a toast in #toast, or a status region announcing tone (idle/busy/built/error).
6. Capture the download with the browser's own download mechanism (in Playwright: page.waitForEvent('download')).
7. For anything persistent, use the built-in backup: Settings -> Storage -> Export backup (JSON). Import restores it. Do not clear site data first.

## Tools

### Study & AI

- [Study Workspace](https://drazil.app/tool/study/): PDF/Word/Markdown reader with page-attached notes, highlights, flashcards, spaced repetition, an AI study companion and a workspace of panels.
- [Quiz](https://drazil.app/tool/quiz/): Generate a quiz from the open document or pasted text; auto-graded MCQ, short and long answers.
- [Exam Mode](https://drazil.app/tool/exam/): Timed practice exams from your own material: question palette, clock, per-question review.
- [Local Library](https://drazil.app/tool/library/): On-device shelf for everything Drazil makes: files, notebooks, flashcards, quizzes, decks. Export/import as JSON.
- [Clock](https://drazil.app/tool/clock/): Zen clock, countdown timer and stopwatch with fullscreen and pop-out.
- [Whiteboard](https://drazil.app/tool/whiteboard/): Infinite canvas: pen, marker, shapes, sticky notes, direct typing, image paste, templates, multi-page boards.
- [Interactive Diagrams](https://drazil.app/tool/diagrams/): AI draws a labelled study diagram of any topic; parts move, relabel, and quiz you.
- [Simulations](https://drazil.app/tool/simulate/): Interactive simulations: Game of Life, Mandelbrot, predator/prey, solar system, chaos; describe a new one to build it.
- [Praxis (Video Generator)](https://drazil.app/tool/praxis/): Notes or a topic in; a narrated, captioned 1080p60 video out. Local neural voices (Kokoro, Piper, Chatterbox); no cloud, no credits.
- [File Narrator (TTS)](https://drazil.app/tool/narrator/): Reads documents, notes and pasted text aloud with system and on-device neural voices.
- [Dictation](https://drazil.app/tool/dictate/): Speak; get live transcribed text. Runs on browser speech or on-device Whisper.
- [Repeat After Me](https://drazil.app/tool/repeat/): Hear a line, say it back, compare takes; pronunciation drill on-device.
- [Chatbot](https://drazil.app/tool/chat/): AI study companion right beside your material. Your provider, or local Ollama; free unauthenticated web search with citations when none is set.
- [Ask & Learn](https://drazil.app/tool/brainly/): Ask questions against your documents, practise eight question kinds, or build a course from a topic.
- [Transcript Analysis](https://drazil.app/tool/transcript/): Paste any transcript; get a structured summary, quiz, flashcards and notes.
- [Calendar](https://drazil.app/tool/calendar/): Exams, deadlines and reminders on an offline month grid; import/export .ics.
- [Tasks & Notes](https://drazil.app/tool/tasks/): Tasks, timers, alarms and sticky notes in one place; fully local.
- [To-Do List](https://drazil.app/tool/todo/): Fast focused checklist with projects, labels, priorities, recurrence.
- [Notes](https://drazil.app/tool/notes/): Autosaving notes beside your reading; plain text or Markdown; saved to the local Library.
- [Notebooks](https://drazil.app/tool/notebook/): Topic notebooks bundling PDFs, notes, flashcards, quizzes; open and continue where you left off.
- [Local Models (Ollama guide)](https://drazil.app/tool/ollama-guide/): Four steps to connect Drazil to Ollama on this machine; every AI feature then stays on-device.

### Documents & PDF

- [Document Generator](https://drazil.app/tool/docgen/): Describe a document; guided chat drafts clean Markdown via hidden templates (agreements, stories, essays, resumes, minutes...).
- [Professional Document Engine](https://drazil.app/tool/prodoc/): Describe the document; get a typeset PDF - planned, designed and laid out locally (Text-to-PDF + real XeLaTeX pipeline).
- [Text to PDF](https://drazil.app/tool/text-pdf/): Text, Markdown or HTML in; a genuinely paginated PDF out - real engine, fonts, tables, code blocks and math.
- [LaTeX to PDF](https://drazil.app/tool/latex-pdf/): Compile LaTeX in the browser with TeX Live 2025 XeLaTeX (WebAssembly): real sections, math, tables, 672 packages.
- [LaTeX Studio](https://drazil.app/tool/latex-editor/): Full LaTeX IDE: project tree, bidirectional PDF<->source sync, templates, AI error assist and continuous compile.
- [Word to PDF](https://drazil.app/tool/word-pdf/): Word (.docx) in; structured PDF out - headings, lists, images, bold/italic preserved.
- [PDF Merge](https://drazil.app/tool/pdf-merge/): Combine several PDFs in your chosen order; text layer stays searchable.
- [PDF Split](https://drazil.app/tool/pdf-split/): Split one PDF by page ranges; each range becomes its own PDF (or a burst ZIP).
- [PDF Reorder](https://drazil.app/tool/pdf-reorder/): Reorder, rotate, delete, reverse pages with a thumbnail strip.
- [Reverse PDF](https://drazil.app/tool/pdf-reverse/): Flip page order end to first (structural flip; text layer untouched) - for booklets and backwards scans.
- [Dual Page Printer](https://drazil.app/tool/dual-pager/): Split a PDF into odd/even halves for manual duplex printing, with blank 'delay' pages and reverse-feed options.
- [Watermark](https://drazil.app/tool/watermark/): Stamp text across every page (or Word doc) - local, no upload.
- [PDF Unlocker](https://drazil.app/tool/pdf-unlock/): Remove owner-password restrictions (printing/copying/editing flags) from PDFs that open without a password.
- [PDF Editor](https://drazil.app/tool/pdf-editor/): Edit PDFs: text, highlight, images, shapes, rotate/delete/split/reorder, watermark.
- [Images to PDF](https://drazil.app/tool/img-pdf/): Combine images into one tidy PDF, in your chosen order.
- [Poster Tiler](https://drazil.app/tool/tiler/): Cut a big image or PDF into print-ready A4/Letter tiles with overlap and crop marks.
- [OCR & Text Extraction](https://drazil.app/tool/ocr/): On-device OCR (Tesseract) for images and scanned PDFs; multi-page, searchable output.

### Images, video & audio

- [Image Viewer / Editor](https://drazil.app/tool/viewer/): View and edit images: zoom, crop, draw, rotate, flip, background removal, filters.
- [Image Converter (JPG/PNG/WebP)](https://drazil.app/tool/convert-img/): Convert image formats one file or batched (ZIP out), with quality control.
- [Image Compressor](https://drazil.app/tool/compress-image/): Shrink images with AVIF/WebP/MozJPEG; sized by measured quality.
- [PDF Compressor](https://drazil.app/tool/compress-pdf/): Re-encode embedded images to shrink PDFs; keeps text sharp.
- [Video Compressor](https://drazil.app/tool/compress-video/): Re-encode video H.264/VP9/AV1; best-of-several encodes, measured quality.
- [Audio Compressor](https://drazil.app/tool/compress-audio/): Opus/AAC/MP3/FLAC with loudness normalization.
- [Convert (MKV/MP4, Doc to PDF, CSV to JSON)](https://drazil.app/tool/convert/): Container/format utility belt: video containers, doc to PDF, CSV to JSON and more - all local.
- [Audio Extractor](https://drazil.app/tool/convert-audio/): Pull the soundtrack out of any video (MP4/MKV/MOV/WebM) to WAV.
- [HTML Viewer](https://drazil.app/tool/html/): Open one HTML file or a whole folder; rendered sandboxed, with a file tree - fully offline.
- [QR Generator](https://drazil.app/tool/qr/): QR codes for links, Wi-Fi and text; PNG/SVG, error correction, colors.
- [SVG Generator](https://drazil.app/tool/imagegen/): Describe an icon/illustration/logo; get SVG or PNG. Runs via your AI provider.

## Key references

- [Full agent guide (plain text)](https://drazil.app/llms-full.txt): per-tool recipes, element ids, verification.
- [Machine registry (JSON)](https://drazil.app/.well-known/drazil-tools.json): structured version of the same data.
- [Browse all tools (human page)](https://drazil.app/browse/): the visual list, plain links.
- [Sitemap](https://drazil.app/sitemap.xml): prerendered documentation per tool.
- Tool docs: each landing page at https://drazil.app/<slug>/ ... e.g. /text-pdf/ - carries copy, FAQ and schema.org JSON-LD.

## Limits and privacy (know these before you script)

- Panel state and tab focus persist per origin; reloading /home restores the last session.
- Share links for LaTeX projects embed the document gzip+base64url in the URL fragment (#latex?share=...); the payload stays client-side.
- PDF reader pages render on canvas; selectable text is in the DOM text layer.
- IndexedDB: lumen-kv, lumen-library, lumen-study, lumen-latex-projects, lumen-latex-editor, lumen-reader-notebooks, lumen-snapshots, lumen-capture-queue, lumen-fonts-db, praxis-assets, lumen-share, lumen
- localStorage: lumen.* (including lumen.ai with provider config, lumen.prefs-style UI prefs, lumen.latex.autocompile)
- Settings -> Storage -> Export backup (JSON download); Import backup restores. The Library tool also has an export.