Skip to content
Oleaflyv0.4.12

Read, search, navigate, inspect, and save the compiled document.

Compile a document, then choose PDF View or Layout → Preview Only for a reading pass. Use Split View when you want the source beside the page. The preview displays the compiled result; it does not edit the manuscript text directly.

LLaMA in PDF-only view, with zoom, page navigation, search, and export controls above the paper
LLaMA in PDF-only view, with zoom, page navigation, search, and export controls above the paper Open full screenshot

Choose Logs to see compilation output. The control switches back to the PDF when selected again. Follow the first actionable error to the relevant source file, fix it, and recompile. See Reading the logs.

To start from an empty log, choose Clear next to Copy log. The log and its errors stay hidden until the next compile writes a new log. Your build files stay where they are, and the button is unavailable while a compile runs.

When a compile can’t run, the preview offers the fix where it can. A latexmk build missing a TeX file shows Find and install. A Tectonic build that needs something Tectonic can’t do shows Choose engine, which opens the engine dialog. A Typst project that pins a version this computer lacks shows Download Typst with that version, and Use Typst with your default version. See When a pinned version is missing.

A LaTeX project that compiles with system TeX (Auto, pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX, or pLaTeX) on a computer without a working TeX distribution shows Download and use TinyTeX and Use Tectonic. In a shared project the second button reads Use Tectonic for everyone, because it changes the compiler for every collaborator, while TinyTeX changes only your computer. If you can’t change the shared project’s settings, only Download and use TinyTeX appears, and the message asks you to install TinyTeX to compile the project on your computer. When a package needs XeLaTeX or LuaLaTeX and Auto picked another compiler, the preview offers Use XeLaTeX or Use LuaLaTeX. When upLaTeX or pLaTeX is missing, it offers Install Japanese support (about 450 MB) if Oleafly can add it to your TeX distribution.

The duration beside Logs reports the completed compile time. Use it to compare repeated builds of the same project, rather than treating it as a measurement of every part of the app.

Choose Document outline to open the PDF’s navigation tree. Expand entries and select a heading to jump to that location. The outline comes from the PDF; a document without PDF bookmarks may have no entries even when its source contains headings. Close the panel with Close document outline.

Search PDF opens the field at the upper right. Matches are highlighted in LLaMA, with previous and next result controls beside the count.
Search PDF opens the field at the upper right. Matches are highlighted in LLaMA, with previous and next result controls beside the count. Open full screenshot

Choose Search PDF, enter a word in Search PDF text, and inspect the highlighted results. Use Previous search result and Next search result to move through matches. Choose Close PDF search to return to reading.

Try searching for estimate in the LaTeX practice document. Search works with the PDF’s text layer; a scanned page made only of images does not supply searchable text.

Choose Fullscreen preview to read without the surrounding editor panes. Choose Exit fullscreen or press Esc to return. This is useful for checking a presentation or reading a page at a larger size.

Choose Present, the presentation icon, to show the compiled PDF as slides, such as a Beamer, Touying, or Polylux deck. Pick Present from the start, Present from this page, or Present with presenter view, which adds the next slide, a timer, and speaker notes on your screen. Present slides covers the keys, the windows on one or two displays, and speaker notes.

When a Quarto document builds a web page, the preview shows the page instead of a PDF. Choose Open in browser, the globe icon, to open it in your own browser. See Quarto.

In fullscreen, choose Hide toolbar to give the page more room. Use the floating Show toolbar control to bring the controls back.

Choose Zoom out to reduce the preview scale by one step. This affects how large the page looks on screen, not the PDF’s paper size.

Choose Zoom in to enlarge the preview. Use it to inspect equations, plot labels, and small table text. The supported scale range is 40% to 400%.

The preview toolbar: outline, search, fullscreen, zoom controls, page number, page layout, reading controls, and export.
The preview toolbar: outline, search, fullscreen, zoom controls, page number, page layout, reading controls, and export. Open full screenshot

Open the percentage menu to choose a fixed zoom preset. It also contains Fit to width, Fit to height, and Reset to 100%. Choose a fixed value when comparing the same page across revisions.

Choose Fit to width to fit the page to the available preview width. Use it in a split layout when reading paragraph text. Reapply it after substantially resizing the pane.

Choose Fit to height to see the page’s vertical extent. Use it to inspect margins, footer placement, and page balance.

Choose Reset to 100% from the zoom menu to return to the neutral scale. This resets the viewer scale; it does not change the source’s font size.

Pinch on a trackpad, or use Ctrl with the scroll wheel, to zoom. Ordinary scrolling moves through the document. ⌘=, ⌘-, and ⌘0 (Ctrl on Windows and Linux) zoom the whole app, the PDF included, even while the PDF has focus. Use the toolbar, a pinch, or Ctrl and the scroll wheel when you want to zoom only the PDF.

Zoomed-in pages stay sharp. The part of the page you’re looking at is drawn again at full resolution, and the preview redraws when you move the window to a screen with a different pixel density.

Choose Previous page to move backward. In a two-page layout, navigation advances by a spread. The button is unavailable when you are already at the beginning.

Click the page-number field, enter a page, and press Enter. The counter also follows your position as you scroll. Use this to return to a page mentioned in review notes.

Choose Next page to move forward. The button becomes unavailable at the end of the document.

For a multi-page PDF, choose Single page view to read one column of pages. Scroll continuously through the document. One-page documents do not need the layout switch, so it is hidden.

Choose Two-page view for facing pages. Use it when checking the balance of a thesis, book, or report across a spread. Return to Single page view when a narrower reading column is easier to follow.

Choose Invert PDF preview colors for a dark reading view. Select the same control to restore colors. The exported PDF retains its original colors; this is a display setting.

Choose Reader view for the accessible reading presentation of the PDF’s text. Use it when you want to follow the document’s reading order without relying only on the rasterized page. Exit Reader view to return to the normal page display. The quality of reading order depends on the structure supplied by the PDF.

Choose Rotate clockwise to rotate the display by 90 degrees. Repeat to return to the original orientation. Use it to inspect a landscape page or rotated diagram. Viewer rotation does not rewrite the document source.

Choose Download PDF to save the PDF currently displayed. Check whether a stale-preview notice is present before sharing it: the displayed result may be from the previous successful build. Image projects expose Download image instead.

Choose the save icon, Save PDF to project, to open its menu. The first item has the same name. It asks for a filename and saves a copy of the compiled PDF into the project tree, beside your other files. The name starts as the project title, as it does for Download PDF. Image projects have Save image to project instead, which saves a PNG without the menu. Use Download PDF when you only need a copy outside the project.

On a narrow toolbar, both items are in More preview controls.

Turn on Sync PDF on compiles, below Save PDF to project in the same menu, to keep a PDF in the project folder up to date. After each successful compile, Oleafly refreshes a PDF named after the project title, whatever the main file is called. The title becomes a file name the same way Download PDF names its file, so Thesis: Final Draft becomes Thesis_Final_Draft.pdf. The switch is saved with the project.

  • The PDF is a normal project file, so cloud sync and checkpoints pick it up.
  • If you rename the project, the next compile starts a new file with the new title. The old file stays as it is.
  • Oleafly never overwrites a file it didn’t create. If a file with that name is already there, it uses the next free name, such as Thesis_2.pdf.
  • Fast compiles don’t update the PDF. While Compile mode is set to Fast, the menu says so.
  • In a live-shared collaboration project, the PDF isn’t shared. It stays on your computer, and the menu says so.
  • If another app has the file locked, the compile still succeeds. The menu shows a note, and the next compile tries again.

Choose Open preview in a new window to detach the reader into an OS window. Move it to a second display while writing in the main window. It follows updated builds and project changes.

Settings → Appearance → PDF Preview. Set the defaults for PDF colors and hover previews.
Settings → Appearance → PDF Preview. Set the defaults for PDF colors and hover previews. Open full screenshot

Choose PDF preview settings to open Settings → Appearance → PDF Preview. Set the default dark-reading behavior and library hover previews there.

Narrow preview panes move controls into More preview controls. Open that menu before assuming a feature is unavailable. Widening the pane brings more controls back into the toolbar.

Drag across text in the PDF to select it, then copy. ⌘A (Ctrl+A) selects the text of the whole PDF. Links inside the PDF remain clickable. Selectable text depends on the PDF’s text layer. The preview does not turn an image-only scan into editable text.

Hold ⌘ or Ctrl and click a word in the PDF to open the matching source. In the source editor, Go to PDF navigates in the other direction. This works in LaTeX projects and in Typst projects on Typst 0.13 or later. See Source and PDF sync for shortcuts and limits.

After an edit or failed build, the viewer can retain the last readable PDF. A stale-preview notice means that page is not the current source. Recompile successfully before using it as the final output.

A recompile keeps your place in the PDF, in the detached preview window too. When you hide the preview and show it again, for example with ⌘⌥P (Ctrl+Alt+P), it comes back right away at the same spot.

With Auto compile on, a Typst project refreshes the preview a moment after you stop typing and keeps your scroll position. See Live preview with Auto compile.

  1. Compile the practice document.
  2. Choose Preview Only and Fit to height.
  3. Search for a phrase and visit its result.
  4. Open the outline and jump to a section.
  5. Zoom in to check its equation or table.
  6. Return to Split View to revise the source.
  7. Recompile, check that the stale notice has cleared, and download the PDF.
Image preview

AI answers couldn’t load

Try again, or search the documentation.