DocsDesktop app and command line

Desktop app and command line

Convert whole files between Word and LaTeX without opening Word: a .docx becomes a .tex, and a .tex becomes a .docx. The direction follows the file. Both use the same converter as the Word add-in, and run entirely on your computer.

The desktop sidebar keeps conversion and creation tools together under Convert: Word and LaTeX files, PDF to LaTeX, equations, graphs, diagrams, tables, and AI OCR & creation. Your work stays separate. See the desktop capability map for what each tool does today and which OCR functions remain to be built.

Converting whole files is part of the Documents feature, included in every paid plan. Sign in once on each computer (see below); it works offline after that.

The desktop app (Windows)

  1. Download TeXConverter for Windows from the Download page and unzip it. It is one program, TeXConverter.exe, with nothing to install.
  2. Double-click TeXConverter.exe. It opens in a window of its own, with its own button and icon on the taskbar. (Microsoft Edge, or Chrome, draws the window, in a browser profile of its own, apart from your browsing and its extensions.) Windows SmartScreen may warn about a new program: choose More info → Run anyway.
  3. Sign in from the window, then drag .docx and .tex files onto it. Each converted file is saved next to the original, and a report lists anything that could not be converted.

Handwriting. Handwriting recognition is not currently enabled in the desktop app. The Windows Ink integration remains in the source, but the app disables device recognition while the OCR workflow is being moved to a supported service. Do not rely on older Ink instructions until the feature is re-enabled and verified in a released build.

Install. Click Install in the window (or run TeXConverter.exe install) to copy the app to %LOCALAPPDATA%\Programs\TeXConverter, put its icon on the Start menu and the desktop, and get Convert to LaTeX on .docx files and Convert to Word on .tex files in File Explorer. Pin it to the taskbar like any program. The icons open the app with no console window, even for a moment. Opening TeXConverter while it is already open brings its window to the front rather than starting a second copy. Settings › Apps lists it, and uninstalling there, or TeXConverter.exe uninstall, removes all of it again.

Test builds. A copy built on a developer's computer (npm run build:desktop) connects to the local test server, not texconverter.com, and says so: a Dev badge beside the name, and "Development build" with the server's address under the account. Use the copy from the Download page for real work.

Handwriting in Word. Installing also lets the Word add-in's ✍ Handwrite button open the same panel. It puts TeXConverterHelper.exe next to the app: the same program with no window, started when you sign in to Windows (Settings › Apps › Startup lists it as TeXConverterHelper, where it can be turned off). It does one thing — open the handwriting panel when the add-in asks — and answers only the TeXConverter add-in: it listens on this computer alone (127.0.0.1, ports 47815–47817), never on the network, accepts requests only from the add-in's own web address, reads and writes no files, and sends back only what you write and insert. Without the helper, the app's window does the same while it is open. TeXConverter.exe uninstall stops the helper and removes it.

Updates. The Download page always has the latest build: a new one is published each time TeXConverter changes, and the page shows its version, size and SHA-256. The app checks when it starts, every few hours, and at once when a new build is published. When there is one, a banner says so: Update now downloads it, checks it, puts it in place of the old TeXConverter.exe and opens the new version, keeping the right-click menu and the handwriting helper. If anything goes wrong, the old version stays. Later hides the banner until the window is next opened. An app too old to keep working says the update is required. To ask now, use Help & support → Check for updates: it shows the banner if there is a newer build, or says this is the latest.

Help. Help & support, at the bottom of the sidebar, opens User guide (this page; or press F1), Supported LaTeX and the questions and answers on texconverter.com in your browser, and Email support starts an email to the support address in your email program. The Store copy has no Check for updates, since Windows updates it.

From the Microsoft Store. The Store's package (npm run build:msix, being tried out; see DEPLOYMENT.md "Microsoft Store") is the same app, but Windows installs, updates and removes it, so there is no Install offer and no update banner. Windows puts it on the Start menu and starts its helper at sign-in, so the handwriting and the sign-in from Word work as with the download. Instead of a right-click entry, Open with → Convert with TeXConverter on a .docx or .tex converts it: Windows shows a packaged program's own right-click entries only on files it is the default program for. The window, the account and the files it saves are the same as the download's.

PDF to LaTeX. On a subject plan, choose Convert → PDF to LaTeX to turn a PDF into an editable LaTeX document: text, headings, lists, tables, maths, physics and chemistry (as mhchem), with each figure kept as a picture cut from its page. Choose a PDF, the pages to convert (at most 30 at a time, unless your plan says otherwise), how to read it, and whether to make a Word copy too; the tab shows what it will cost in credits and about how long it takes, then converts a few pages at once.

  • Smart (recommended) reads each page's text, headings, lists and figures on your computer, free and exactly as the PDF has them. Only the page's pieces of maths, physics and chemistry, cut out of the page, go to the AI: 1 credit for all of a page's maths. A page with no maths costs nothing. A page it can't read itself (a scan, two columns, a table) goes to the AI whole.
  • AI for every page sends every page to the AI whole: 1 credit a page. Best for scans, tables and other complex layouts.

The PDF stays on your computer: only the pictures and text the AI needs are sent, and nothing is kept on the server. The result is a folder in your TeXConverter folder named after the PDF, with the .tex, a figures folder and the .docx.

AI can make mistakes. On clear, computer-made PDFs expect roughly 95–99% of the text and 90–95% of the equations to be right, less for chemistry and for scanned or handwritten pages. The result lists the pages to check first: those the AI was less sure of, with what to look at, and any page it couldn't convert, which is in the document as its picture so nothing is lost (and isn't charged). Check the result against the PDF before you use it.

Your work. Signed in, a Your work tab lists what you made on the website, in Word and in the app, with your Create with AI creations; Open puts one in its tab. What you save or copy from the Equations, Graphs, Diagrams and Tables tabs is kept there, and your Recent symbols, the last diagram and your conversion options follow your account. The window opens at the same address each time, so what it keeps on this computer stays between launches too.

The command line (Windows, Mac, Linux)

The command-line converter is a single file, texconverter.mjs, that runs with Node.js 20 or later. Download it from the Download page, then:

node texconverter.mjs login                  # once per computer
node texconverter.mjs convert report.docx    # -> report.tex, images/ beside it
node texconverter.mjs convert paper.tex --bib refs.bib
node texconverter.mjs convert *.docx -o out/

TeXConverter.exe takes exactly the same commands, so on Windows you can use it instead of Node.

Command What it does
convert <files...> Converts each file; .docx → .tex, .tex → .docx
app Opens the window, to drag files into
login, logout, account Signs this computer in or out, or shows who is signed in and their plan
work Lists Your work, newest first: what you made on the website, in Word, in the app and with AI, each with its id
work get <id> Prints one: an equation's LaTeX or a diagram's source as it is (> figure.tex saves it), a graph or table as JSON
install, uninstall Adds or removes the right-click menu (TeXConverter.exe only)
helper Serves handwriting to the Word add-in, with no window (what install starts at sign-in)
Option Meaning
-o, --output <file> Where to write the result (default: beside the input)
--images <folder> Folder for extracted images (default: images)
--class article|report|book Document class for a new .tex (default: article)
--font-size 10|11|12 Font size for a new .tex (default: 11)
--dollar smart|always|never How bare $...$ in Word text is read (default: smart, which skips amounts of money)
--no-detect-latex Leave $...$ typed in the text as plain text
--no-table-borders Never draw table rules
--bib <file.bib> A bibliography for a .tex (repeatable); --bib-style plain|unsrt|ieee

Equations TeXConverter cannot represent are listed in the report and left out, rather than the whole document being refused.

Signing in

login (or Sign in in the window) shows a short code and opens texconverter.com, where you approve it. The computer then holds a licence it checks by itself, so conversion works offline for days at a time, and stays signed in until you sign out. See Accounts and plans.

Word on the same computer. While the app is signed in (and its helper running, which install sets up), Word's Account dialog offers Continue as your email. Word asks the app, the app asks you in a Windows dialog, and once you choose Yes Word is signed in. No other program, web page or Windows user can answer that dialog for you, and the app never hands Word its own sign-in: Word gets one of its own, listed separately on your account page.