Troubleshooting

pvql doctor checks every part of the installation and builds one real preview, and says what to do about anything that fails.

The panel says the service is not answering

Run pvql service --install, then pvql doctor; the service’s own output is in ~/Library/Logs/pvqld.log. See The render service.

Login Items still lists pyvista-quicklook or PyVista Quick Look Extensions

Earlier versions made those entries; reinstalling replaces them, and System Settings drops the old ones the next time it opens.

Nothing happens on space bar

Confirm the type is claimed with pvql types, then check that Finder resolves it: mdls -name kMDItemContentType yourfile.vtu should report an org.pyvista.pyvista-quicklook.* type.

The panel says “Extension org.pyvista.PyVistaQuickLook.QuickLook not found”

The Finder has run since before 0.7.0 and still asks for the extension by its old identifier. Run killall Finder once no files are being copied or moved.

A dataset made of several files fails in Desktop, Documents or Downloads

Those folders are private to each program; see Files in the Desktop, Documents, and Downloads folders.

Files show a blank icon in the Finder

The Finder draws a file’s icon from the app that opens it. ParaView 6 says it opens .vtk, .vtp, .vtu, .vti and the other VTK formats, but its bundle lacks the icon it names for them. Select such a file, press ⌘I, choose PyVista Quick Look under Open With, and click Change All.

Previews are stale

pvql cache --clear.

A preview fails

Run pvql config set log true; activity is then appended to pvql.log beside the config file. The extension’s own log is in ~/Library/Containers/org.pyvista.PyVistaQuickLook.QuickLook/Data/tmp/.