Home

Welcome to the LatexIt wiki!

Quick troubleshooting

Install the latest development version from here. If some step fails, the output will be “I ran [some command line”]. Then, copy/paste this command line in a terminal and run it for yourself. Because LatexIt! will not delete the temporary files in this case, you will be able to reproduce the error and see what went wrong.

Detailed troubleshooting

If you’re getting the “convert failed with error N” error message, please use the following procedure to determine what’s wrong.

First, create a file named test.tex and put the contents below in it

\documentclass{article}
\usepackage[utf8x]{inputenc}
\pagestyle{empty}
\begin{document}
Hello, world
\end{document}

We’re going to run the exact same procedure as LatexIt!. Assuming your file is named test.tex, please run

latex -output-directory /tmp -interaction=batchmode test.tex

This should create a test.dvi file in your /tmp directory. If you’re on Windows, replace /tmp with the appropriate location (usually TEMP, which means, for instance, c:\documents and settings\yourusername\local settings\temp).

Now we need to crop the dvi file and convert it to ps.

dvips -o /tmp/test.ps -E /tmp/test.dvi

Finally, and this is where it usually fails, you need to run convert.

convert -units PixelsPerInch -density 300 /tmp/test.ps -trim /tmp/test.png

Possible raisons for failure include:

• you’re on Windows, and LatexIt found c:\system32\convert.exe instead of ImageMagick’s convert utility. Please double-check in Tools > Addons > LatexIt > Preferences that the path to convert.exe looks like c:\program files\imagemagickQ4blahblahblah\bin\convert.exe
• you’re on Windows and you’re using a 64-bit version of ImageMagick, please see this thread