Overview
File Explorer Add-ons extend Windows File Explorer with preview and thumbnail support for file types not natively supported by Windows. View file contents directly in the preview pane without opening external applications.Activation
Key Features
Supported File Types
Code Files
Monaco Preview HandlerSyntax-highlighted code preview.cs, .cpp, .py, .js, .ts, .json, .xml, .html, .css, .md, .sql
Markdown
Markdown Preview HandlerRendered Markdown documents.md, .markdown
SVG Images
SVG Preview & ThumbnailVector graphics preview.svg files
PDF Documents
PDF Preview & ThumbnailPDF document preview.pdf files
G-code
G-code Preview & Thumbnail3D printing code preview.gcode, .bgcode files
STL Models
STL Thumbnail3D model thumbnails.stl files
QOI Images
QOI Preview & Thumbnail“Quite OK Image” format.qoi files
Preview Handlers
Preview handlers display file contents in the preview pane:- Monaco Code Preview
- Markdown Preview
- PDF Preview
- SVG Preview
- G-code Preview
Features:
- Syntax highlighting
- Line numbers
- Multiple language support
- Read-only view
- C/C++/C#
- Python
- JavaScript/TypeScript
- JSON/XML
- HTML/CSS
- Markdown
- SQL
- And 50+ more
Thumbnail Providers
Generate thumbnails for File Explorer icon view:- SVG Thumbnail: Rasterized vector graphics
- PDF Thumbnail: First page preview
- STL Thumbnail: 3D model render
- G-code Thumbnail: Embedded preview image or toolpath
- QOI Thumbnail: Decoded QOI image
Configuration
Enable/Disable Handlers
Individually control each preview handler:Enable Monaco code preview handlerPerformance note: May be slower for very large files
Enable Markdown preview handler
Enable SVG preview handler
Enable SVG thumbnail provider
Enable PDF preview handler
Enable PDF thumbnail provider
Enable G-code preview handler
Enable G-code thumbnail provider
Enable STL 3D model thumbnail provider
Enable QOI image preview handler
Enable QOI image thumbnail provider
File Association
Preview handlers register for specific file extensions in Windows registry:Use Cases
Software Development
Code Review
Code Review
Quick preview of source code files:
- Enable Monaco preview handler
- Navigate to project directory
- Click files to preview without opening IDE
- Review code changes quickly
- Syntax highlighting
- No need to open full editor
- Fast file browsing
Documentation
Documentation
Preview README and documentation:
- Enable Markdown preview
- Click README.md to see rendered output
- Review docs before editing
- Verify formatting
Configuration Files
Configuration Files
Preview JSON, XML, YAML configs:
Design & Graphics
3D Printing
G-code Inspection
Preview G-code files before printing
- View toolpath
- Check layer heights
- Estimate print time
Model Thumbnails
STL thumbnail generation
- Visual model previews
- Browse models easily
- Identify files quickly
Document Management
- PDF Preview
- Markdown Notes
Quick document review:
- Enable PDF preview
- Browse document folders
- Click PDFs to preview
- No need to open full PDF reader
- Invoice review
- Document selection
- Quick reference
Technical Details
Architecture
Preview Handler Structure
src/modules/previewpane/README.md
Preview Handler Process
Preview handlers run in isolated process:- Crash isolation
- Memory management
- Security sandboxing
Implementation Pattern
Typical handler implementation:Keyboard Shortcuts
File Explorer
| Shortcut | Action |
|---|---|
Alt+P | Toggle preview pane |
Arrow Up/Down | Navigate files (preview updates) |
Enter | Open file in default application |
Ctrl+Scroll | Zoom thumbnail size |
Troubleshooting
Preview not showing
Preview not showing
Check:
- Preview pane is visible (
Alt+P) - Specific handler is enabled in PowerToys Settings
- File extension is supported
- File is not locked/in use
- Restart File Explorer (Task Manager → Windows Explorer → Restart)
- Disable and re-enable handler
- Restart PowerToys
Thumbnails not generating
Thumbnails not generating
Possible causes:
- Thumbnail cache corrupted
- Handler not enabled
- File too large
- Enable thumbnail provider in settings
- Clear thumbnail cache:
- Restart File Explorer
Monaco preview slow for large files
Monaco preview slow for large files
Performance issue:
- Monaco handler loads entire file
- Large files (>1MB) may be slow
- Disable Monaco handler for large files
- Use external editor for large files
- Consider file size limits in settings (if available)
Preview shows error or blank
Preview shows error or blank
Debug:
- Check file is not corrupted
- Try opening in native application
- Check PowerToys logs:
- Look for preview handler errors
- File encoding not supported
- Missing dependencies
- File format variation not supported
See Also
- File Locksmith - Unlock files in use
- PowerToys Run - Quick file search
- Image Resizer - Batch image operations