Phials documentation

File Previews

A preview is a larger look at whatever you have selected: a photo, a video, a folder, a document, and more. Phials picks the right preview for each file automatically, so you can inspect files without opening another app.

Where previews appear

Previews can show up in three places, depending on the file type and your layout:

  • Preview sidebar: a panel beside your file list that updates as you click around. This is the most common spot.
  • Preview tab: a full center tab with more room and preview-specific controls like zoom and playback. Double-clicking a file usually opens it here, and many previews have an Open in fullscreen button that does the same. The same file always maps to a single preview tab, so you never end up with duplicates.
  • Fullscreen: an edge-to-edge view for formats that work well with the extra space.

Selection drives the preview: click another file and the preview switches to match. When more than one preview could apply to a file, Phials chooses the most specific one. For example, a Git repository folder gets the repository summary instead of the plain folder preview, and an image with AI generation metadata gets the AI image preview instead of the generic one.

If nothing more specific fits, you see the default preview.

The info panel

Beside a large preview, Phials can show an optional info panel with the file’s metadata, and for AI-generated images, the generation details. It is off by default, and Phials remembers whether you had it open.

Previews by file type

PreviewWhat it’s for
Text & codeSyntax-highlighted source and config files
MarkdownLive rendered Markdown, with a raw mode
ImageViewing, fullscreen, and light editing
VideoInline and fullscreen playback
AudioAudio playback
SpreadsheetCSV, TSV, Excel, and OpenDocument tables
DatabaseRead-only browsing of SQLite files
3D modelglTF, OBJ, STL, and other 3D formats
FontType specimens
FolderFolder contents and statistics
Git repositoryBranch, remote, and working-tree summary
AI imageImages with embedded generation metadata
macOS app.app bundles
Disk image (DMG)macOS disk images
DefaultThe fallback when no specific preview fits