# Seer — Full Documentation Context ## Source: https://1218.io/docs/seer/ — Home # Documentation ### ✨ Key Features - **Actively maintained since 2015** Seer, the first Quick Look tool ever released for Windows, was launched on _`September 28, 2015`_, and has been continuously improved ever since. - **Beautiful UI with dark mode support** Clean, modern interface that looks great in both light and dark themes. - **Handles extreme workloads effortlessly** Instantly previews massive archives, multi-gigabyte text files, or PDFs with tens of thousands of pages. - **Highly customizable** Extend preview formats, file properties, and control bar actions — tailor Seer to your workflow. - **Copy anything from preview** Extract text, images, even video frames directly from the preview window — no restrictions. - **Extensive format support** Supports hundreds of file types: video, audio, images, markdown, Office docs, folders, web pages, and more. - **Lightweight and efficient** Uses minimal memory even with large files — optimized for everyday use and power users alike. - **Lightning-fast performance with native C++** Built in C++ for maximum speed and responsiveness on Windows, **simply the best in its class.** ### 🔗 Links - 🤖 If you run into issues, try sending the page link to AI for faster answers. - 🐞 Found a bug? [Issues](https://github.com/ccseer/Seer/issues) ## Source: https://1218.io/docs/seer/builtin-viewers.html — Core Features & Guide # Core Features & User Guide Seer provides high-performance native viewers and flexible workflow controls covering daily office work, software development, creative design, and system troubleshooting. In addition to instant launch speeds, each viewer offers extensive keyboard workflows, mouse gestures, and practical features. > [!TIP] > You can share this page with an AI assistant along with your question for fast, relevant answers. ## General Features Regardless of the file type currently being previewed, the Seer host window provides a unified set of controls, hidden interaction gems, and global shortcuts. > [!NOTE] > Except for a few special exceptions, the vast majority of keyboard shortcuts only respond when the preview window has input focus. ### 1. Property Inspector Click the info icon in the title bar (or press shortcut Ctrl + I) to pop up the centered property inspector card: - **Shift Toggle for Raw vs Friendly Display**: While the inspector is active and not focused on text input, press the Shift key to toggle all values between friendly readable formatting and exact raw data (e.g., `12.5 MB` ⟷ `13,107,200 bytes`, or `2 hours ago` ⟷ `2026-11-01 13:08:42`). Your preference is automatically remembered. - **Long Text Folding & Full Expansion**: Property rows exceeding 3 lines are automatically folded with an ellipsis. Click anywhere on the row to toggle between collapsed preview and full expansion; the expanded state of each row is preserved. - **Section Folding & Quick Copy**: Click section headers (Basic, Extended, etc.) to collapse or expand groups. Hover your cursor over any property row to reveal a copy button on the right to copy its value to your clipboard. - **File Notes & Memo**: - **Purpose & Capacity**: The inspector includes a dedicated memo field supporting up to 8,192 characters for attaching personal notes, review reminders, or key summaries to the previewed file. - **Storage Location**: On local drives and network shares supporting named streams (such as NTFS), notes are attached directly to the file and follow it when renamed or moved on the same volume. For non-stream drives (FAT32/exFAT) or cloud placeholders (e.g., OneDrive online-only files), notes fall back to Seer's local database. - **Local-Only Nature (Important)**: ⚠️ Notes are personal local annotations and **do not travel across networks or cloud uploads**. Uploading files or sending them via messaging apps and email strips stream metadata. Copying files to non-NTFS USB drives or reinstalling Windows without backing up local app data will detach notes. - **Preserves File Modification Time**: Writing or clearing notes preserves the original file modification and creation timestamps, ensuring build tools never trigger unnecessary rebuilds and your Git status remains clean. - **Seamless Editing & Persistence**: The note area is always editable with no separate "Edit" or "Save" buttons—changes save automatically as you type (writes settle about a second after you stop typing, and pending edits are flushed when the preview closes). If a file is marked read-only, the note area enters read-only mode to prevent accidental edits. - **Title Bar Visual Cue**: When a file contains notes, the title bar info button displays a subtle accent-colored dot in its top-right corner. - **Master Switch**: File remarks can be enabled or disabled at any time under **Settings > System**. - **Pin Inspector**: Click the pin icon in the top-right corner of the inspector to keep it pinned. When pinned, the inspector will open automatically whenever you preview a new file. - **Rich Chart Visualizations**: With property plugins installed, native vector diagrams and charts (such as image histograms or scopes) render inline with full interactivity. ### 2. Window Management & Detached Instances - **Primary Action & Shift Batch Close**: - **Standard Click**: Triggers the action configured under **Settings > Advanced** (**Titlebar button**). Supports three modes: **Separate Window** (default, detaches the preview into an independent sub-window), **Pinned Window** (keeps window pinned on top without dismissing on blur), or **Standalone Window** (launches an isolated `SeerViewer.exe` process). - **Hold Shift for Batch Close**: When multiple windows are pinned or detached on screen, **holding down the Shift key** transforms the action button into a "Close All Sub-Windows" button with a badge showing the count of active windows. Clicking it closes all sub-windows at once. - **Window Sizing Shortcuts**: - F9: Shrink preview window size. - F10: Enlarge preview window size. - F11 (or **double-click the title bar**): Toggle between default size and maximized fullscreen. - **Open Settings**: Press Ctrl + , to open the Seer Settings panel. ### 3. Global FindBar Text/Code, PDF, Web/Markdown, and Folder/Archive viewers all embed the unified FindBar: - **Open & Dismiss**: Press Ctrl + F to open; press Esc to close and return keyboard focus to the viewport. - **Match Stepping**: - F3 or Enter in input: Jump to next match. - Shift + F3 or Shift + Enter: Jump to previous match. - Alt + C: Toggle case-sensitive matching (`Aa` button). ### 4. Continuous Cursor Tracking & Auto-Reload - **File Cursor Tracking**: Move the selection cursor with arrow keys in Windows File Explorer or supported 3rd-party file managers; an active Seer window tracks the selection and updates instantly without having to press Space repeatedly. - **Same-Type Navigation**: - Ctrl + → / Ctrl + ←: Move back and forth through the files you previewed recently (a rolling history, not the folder's file order). - Ctrl + Shift + → / Ctrl + Shift + ←: **Jump strictly between files of the same type** in the current directory (folders, and files with a different extension, are skipped). - **External Changes Auto-Reload**: When enabled in Settings (disabled by default), modifying and saving a previewed file in an external editor reloads the latest contents in place. The text viewer additionally restores its saved reading position (`Text/remember_pos`, on by default); other viewers re-render from the top. For folders, it only monitors changes within the 1st-level directory. You can also press F5 to reload manually. ### 5. Control Bar & Extensions - Ctrl + O: Open the current file in the system default application (equivalent to double-clicking the file icon). - Ctrl + R: Reveal and select the file in Windows File Explorer. - Extend actions dynamically with [Control Plugins](https://1218.io/docs/seer/add-ctrlbar.html) (e.g., copying folder listings, sharing, unlocking file handles). ## Text & Code Viewer Engineered for software developers and technical readers, balancing high-fidelity syntax rendering for everyday source code with instant, zero-freeze opening of massive multi-megabyte logs. ### Dual-View Architecture: Standard View vs Large File View To eliminate out-of-memory crashes and interface freezes when viewing large files, Seer automatically adapts the view mode based on file size: - **Automatic Routing Threshold**: Controlled via configuration, defaulting to **3 MiB** (3,145,728 bytes). - **≤ 3 MiB**: Opens in **Standard View**, providing full syntax styling, word wrap, code formatting, and quick rendering switches. - **> 3 MiB**: Automatically streams the document in **Large File View** to guarantee instant, freeze-free opening of multi-hundred-megabyte logs, database SQL dumps, or massive CSV files without memory exhaustion. To maintain instant, freeze-free performance on massive files, the Large File View streams content using fixed row heights. As a result, certain compute-intensive features—such as dynamic word wrap, code formatting, and direct Markdown/HTML/SVG rendering—are unavailable in this mode. Both views fully support syntax highlighting, search (Ctrl + F), line numbers (N), whitespace visualization (W), overview minimap (M), and mouse text selection. ### Single-Line Length Limit & Overflow Protection When inspecting minified or bundled files (such as single-line minified JavaScript, monolithic JSON payloads, or Base64 data), a single row may contain tens or hundreds of thousands of characters. Calculating layout and line-wrapping for such enormous single lines causes severe application lag or freezes during window resizing. - **Default Single-Line Limit: 10,000 Characters**: Seer caps single-line reading and layout at **10,000 characters** by default (the configuration key enforces a strict minimum floor of 10,000). - **Capsule Truncated Badge**: If a line exceeds 10,000 characters, the excess bytes are safely truncated, and an inline capsule badge is painted at the end of the line (e.g., `… 500 B` or `… 14.5 KB`). - **Omitted Byte Tooltip**: Hovering your cursor over the badge displays an informative tooltip reporting the exact omitted byte count (e.g., `Line truncated (14,848 bytes omitted)`), maintaining silky-smooth interaction without silently discarding awareness of truncated content. ### Complete Shortcut Reference | Shortcut | Description | Viewport Availability | | :--- | :--- | :--- | | Z | Toggle word wrap / horizontal scrolling | **Standard View Only** | | F | Automatically format code (JSON / XML) | **Standard View Only** | | R | Switch to rendered view (Markdown, HTML, or SVG) | **Standard View Only** | | L | Center viewport onto current cursor line | **Standard View Only** | | N | Show / hide left line numbers | Supported in both views | | W | Show / hide whitespace symbols (dots for spaces, arrows for tabs) | Supported in both views | | M | Show / hide overview code minimap | Supported in both views | | Ctrl + = | Increase font size (or hold Ctrl and scroll wheel) | Supported in both views | | Ctrl + - | Decrease font size | Supported in both views | | Ctrl + F | Open FindBar (F3 next, Shift+F3 previous) | Supported in both views | ### Custom Syntax Highlighting Seer's code highlighting engine is powered by the open-source **Kate syntax highlighting specification** (the same standard shared by Kate, KWrite, Qt Creator, and KDevelop). When a specialized or custom file format is not covered out of the box, or when you want to customize syntax coloration, you can easily add `.xml` syntax definitions without writing code or compiling anything. #### 1. Syntax Reference & Examples - **Syntax Format Reference**: [Kate Highlight XML Format Documentation](https://docs.kde.org/stable_kf6/en/kate/katepart/highlight.html#katehighlight-xml-format) - **Official Example (`hextxt.xml`)**: [ccseer/Seer-Controls/plugins/hex-viewer/syntax/hextxt.xml](https://github.com/ccseer/Seer-Controls/blob/main/plugins/hex-viewer/syntax/hextxt.xml) The official **Hex View** control plugin uses this exact mechanism: it dumps hex data into files with a custom `.hextxt` extension and bundles `syntax/hextxt.xml` to provide custom syntax highlighting. #### 2. Storage Locations & Activation Place your `.xml` definition files into one of Seer's syntax directories: - **Standard Installed Seer**: `%LocalAppData%\Corey\Seer\syntax\` (i.e., `C:\Users\\AppData\Local\Corey\Seer\syntax\`; create the `syntax` folder if it does not already exist). - **Portable Seer** (when `portable.cfg` exists in the application root): `\data\syntax\`. - **Extension Packages**: Plugin packages can bundle and distribute syntax definitions under `\syntax\`. **Activation**: After placing the file, simply **restart Seer**. The host will automatically scan, validate, and register all conforming syntax files. #### 3. XML File Rules & Key Constraints Syntax definitions follow the standard Kate Syntax XML specification. Below is the structure from the official `hextxt.xml` example: ```xml ``` - **File Size Limit**: Each `.xml` file must strictly stay within **512 KB**. Files exceeding 512 KB are discarded to guard against accidental non-syntax payloads. - **Required Attributes**: - `name` (Mandatory): Unique display name for the language (e.g., `name="HexDump"`). - `section`: Category under which the definition is grouped (e.g., `Sources`, `Scripts`, `Markup`, `Other`). - `extensions` (Mandatory): Semicolon-delimited wildcard patterns for matching filenames (e.g., `extensions="*.hextxt"`). - ⚠️ **Do not include spaces after semicolons**: Writing `*.foo; *.bar` causes the second pattern to be read with a leading space (`" *.bar"`), which will never match any filename. Always write them cleanly without spaces as `*.foo;*.bar`. - `priority`: Must be a positive integer (e.g., `priority="100"`). - `version`: Definition revision number (integer or float, e.g., `version="2"`). - `kateversion`: Kate format version string. It must contain a dot (e.g., `kateversion="5.0"` or `kateversion="6.0"`). Files with missing, dotless, or incompatible `kateversion` attributes are skipped. #### 4. Conflict Resolution & Overrides When multiple syntax definitions overlap, Seer applies deterministic precedence rules: - **Identical Names (`name` match)**: If a custom definition shares the same `name` as an existing or built-in definition, the one with the higher `version` takes precedence. If versions are tied, the first loaded definition is retained. - **Overlapping Extensions (`extensions` collision)**: When different language definitions claim the same file extension (such as two definitions both matching `*.shader`), the definition with the **higher `priority` value wins**. - **Overriding Built-in Highlighters**: To replace Seer's built-in highlighting for a given file type with an updated community or custom rule, simply specify a higher positive integer in `priority` (e.g., `priority="100"`; built-in priorities are typically in the single digits), and Seer will seamlessly prioritize your custom rule. ## Video & Audio Viewer Provides GPU hardware decoding support (disabled out of the box) and real-time audio visualization for smooth playback across all popular media formats. ### Decoding & OpenGL Rendering Requirements - **Decoding Backend**: Hardware decoding is **off by default** — the **Disable GPU decoding** option under **Settings > File Types > Media** is checked, so Seer starts with software decoding (`FFmpeg`, `dav1d`). Uncheck it to let Seer try the GPU decoders, and optionally pin the exact backend order in `user.ini [Media]` under `decoders` (`D3D11`, `MFT:d3d=11`, `DXVA`, `CUDA`, `FFmpeg`, `dav1d`, ...). - ⚠️ **OpenGL Hardware Rendering**: Video frame display strictly requires an active **OpenGL** hardware rendering context from the GPU. In rare environments (such as virtual machines, remote desktop connections lacking GPU passthrough, or systems with outdated/corrupt display drivers), video playback may fail to render properly. ### Playback Control & Volume Behaviors - **Playback Speed Lifecycle**: Playback speed adjustments are runtime-only (held for the active application lifecycle) and automatically reset to 1.0x on the next launch of Seer. - **Volume Control (Standard Preview vs Standalone Window)**: - **Standard Preview Window**: Supports toggling **Mute / Unmute** (M or control bar button), without volume slider adjustment. - **Standalone Window (`SeerViewer.exe`)**: Supports fine volume adjustment via mouse wheel or volume slider popup with an on-screen display (Volume OSD) badge, and automatically saves and persists the volume level across launches. - **Subtitle Track Selection & Auto-Discovery**: For videos with embedded subtitle tracks, select or disable tracks via the right-click **Subtitle** menu. Seer also automatically detects external `.srt`, `.ass`, `.ssa`, and `.vtt` subtitle files sharing the same base name in the video's directory. - **Under 1-Second Media Protection**: Media clips with a duration under 1 second (< 1,000 ms) do not have playback functionality: the progress slider, time indicator, play/pause button, speed button, and mute button are completely hidden, and timeline shortcuts are disabled. Looping is disabled to avoid pipeline restart oscillation; the clip plays once and pauses on its final frame, with a "No timeline" status displayed on the control bar. - **Video Chapters & Progress Bar Tooltip**: For videos with embedded chapters (such as MP4 or MKV), the progress slider automatically paints visual chapter tick marks. Hovering your mouse along the progress bar displays a tooltip with the exact timestamp and chapter title (e.g., `04:15 | Introduction`). - **Time Indicator Display Modes**: Click the time label on the control bar to cycle between display modes (toggling between elapsed time / total duration and countdown remaining time). Your preferred display style is remembered automatically. - **Percent Seek**: Press number keys 0 through 9 during playback to jump directly to 0% through 90% of the video duration. - **Frame Stepping**: Press , / . to pause and step backward / forward by 1 frame (Shift + , / Shift + . steps by 5 frames). Also available via the right-click "Jump" menu. - **Playback Resume**: Remembers playback progress for audio and video files when enabled in settings or `user.ini` (`audio_remember_playback_pos` and `video_remember_playback_pos`, disabled by default). ### Instant Frame & Cover Copying Press Ctrl + C at any time during playback or pause to copy visual media directly to your clipboard: - **Video Frame Capture**: Copies the current video frame as a high-resolution lossless image into the system clipboard. - **Pinpoint Specific Frames**: If you want to copy an exact frame, simply pause playback and use frame-stepping (, for previous frame, . for next frame, or Shift + , / Shift + . for 5-frame leaps) to navigate to the precise frame, then press Ctrl + C. - **Audio Tracks**: - **With Embedded Cover Art**: If the audio file contains album artwork (and the view is in Cover or Cover & Visualizer mode), Ctrl + C copies the original high-resolution album cover image directly to your clipboard. - **Without Cover Art (or Visualizer-Only Mode)**: If the track has no embedded artwork or is displayed in Visualizer-Only mode, Ctrl + C captures the active dynamic audio waveform canvas and saves it to your clipboard as an image. - A notification confirms the image has been saved to your clipboard upon every successful copy. ### Audio Waveform Visualizer & Cinema RAW Formats - **Real-Time Audio Visualizer**: Playing audio tracks (MP3, FLAC, WAV, etc.) provides a real-time visualizer accessible via the right-click menu: - **3 View Modes**: Cover Only, Cover & Visualizer, Visualizer Only. - **4 Visualizer Styles**: Mirrored Bars, Symmetrical Bars, Smooth Spectrum Curve, Dynamic Liquid Wave. - **Cinema RAW Video Formats**: With the official [mdkadapter plugin](https://1218.io/docs/seer/download.html#viewers) installed, Seer natively previews professional cinema raw footage including RED R3D (`.r3d`) and Blackmagic RAW (`.braw`). ## Image Viewer Engineered for precision design and photography inspection, combining GPU-accelerated rendering, deep gesture support, and instant opening of massive raw images. ### Display Modes & Canvas Navigation - **Default Display Mode Setting**: Configure your preferred opening size under **Settings > File Types > Image**: - **Auto Fit** (default): Automatically scales down or up so the entire image fits within the viewer window without scrollbars. - **Fit Short Side**: Scales until the shorter side touches the window edge; scroll the longer side if needed (ideal for tall screenshots or panoramic banners). - **Prefer Full Size**: Always opens the image at 100% native unscaled physical resolution. - **Smart Expand (E)**: Press E (or select **Expand** from the right-click context menu) to intelligently optimize the preview window and zoom level: - For **tall vertical images** (e.g. mobile screenshots, long web captures): expands the image width to fill the available screen width while allowing smooth vertical scrolling. - For **wide panoramic images**: fits the height to the available screen height while allowing horizontal scrolling. - Seer automatically calculates the maximum readable dimension on your monitor and resizes the preview window accordingly. - **Direct Edge Fitting**: Press W to fit the image to the window width, or press H to fit to the window height. - **Double-Click Toggle**: Double-click anywhere on the canvas to instantly toggle between 1:1 actual pixel resolution and window-fitting mode. - **Mouse Wheel & Touchpad Gestures**: - **Wheel Action Mode**: In **Settings > File Types > Image**, choose whether spinning the mouse wheel scrolls the canvas vertically or zooms smoothly without holding Ctrl. - **Shift + Wheel**: Scrolls the canvas horizontally—effortlessly pan wide pictures without dragging scrollbars. - **Windows Precision Touchpad**: Native support for two-finger pinch-to-zoom and two-finger fluid canvas panning. - **Click & Drag**: When zoomed in, simply click and drag with the left mouse button to freely navigate the canvas. - **Overview Minimap (M)**: Press M to toggle the navigation minimap in the bottom-right corner. When zoomed in, click or drag the highlighted viewport box on the minimap to jump across large multi-thousand-pixel canvases with pinpoint precision. ### Inspection Gems & Background Cycling - **Resolution Label & Live Zoom Tooltip**: The resolution label on the bottom control bar displays the image's original native dimensions (e.g. `3840×2160`). Hovering your cursor over the label reveals a real-time tooltip showing the **currently rendered dimensions and exact scaling percentage** (e.g. `1280×720 (33.33%)`), making it easy to check the live zoom ratio at a glance. - **5-Mode Canvas Background Cycling (B)**: - Press B (or use the right-click menu) to instantly cycle between **No background (inherits app theme)**, **Transparent checkerboard**, **Pure Black**, **Pure Gray**, and **Pure White**. - **Solving Transparency Inspection**: Essential for viewing light/dark transparent PNGs, monochrome logos, or white vector SVGs—switch to black to inspect white highlights, or switch to white to check dark contours. - **Orientation & Flipping**: Press R / L to rotate 90° clockwise / counter-clockwise; press X / Y to flip horizontally / vertically. - **Massive Image Fast-Opening (256 MiB Threshold)**: - Opening giant images (scanned archives, gigapixel aerial photography, or massive TIFF files exceeding 256 MiB) often freezes ordinary viewers. - Seer uses a two-stage pipeline: it extracts high-resolution embedded preview data in milliseconds for an instant zero-freeze preview on Spacebar, while allowing on-demand full uncompressed bitmap loading without memory exhaustion. ### Advanced Formats & Metadata - **Professional Adobe PSD Compatibility**: - Full compatibility with native Adobe Photoshop `.psd` documents without launching Photoshop. - Comprehensive support for **8-bit, 16-bit, and 32-bit** color depths. - Flawless color rendering across **CMYK print colors, Duotone, Indexed color, and Multichannel** modes. - **Camera RAW Lossless Negatives & EXIF**: - Native direct decoding for professional camera RAW formats: Canon (`.cr2`, `.cr3`), Nikon (`.nef`), Sony (`.arw`), Fujifilm (`.raf`), Adobe (`.dng`), Olympus (`.orf`), Panasonic (`.rw2`), and more. - Prioritizes embedded full-resolution previews for sub-second opening; the Property Inspector (Ctrl + I) extracts camera bodies, lens optics, focal length, aperture, shutter speed, ISO, exposure bias, and embedded GPS coordinates. - **Smart Animation Detection**: - Many `.apng` and `.webp` files contain only a single static frame. Seer inspects animation metadata to automatically choose the best viewing engine: - **Single-Frame Static Files**: Automatically routed to the static raster engine, enabling 1:1 pixel inspection, zooming, and EXIF extraction. - **Animated Sequences (GIF / APNG / Animated WebP)**: Activates the playback engine with loop control, playback pause, and frame-stepping (, / .) for inspecting individual animation frames. - **Multi-Resolution Icon Containers (ICO / CUR / ICNS)**: - For Windows icons (`.ico`), cursors (`.cur`), or macOS icons (`.icns`) bundling multiple resolutions and bit-depths, the bottom control bar displays a selectable list of all bundled icon sizes (e.g., `16x16`, `32x32`, `48x48`, `256x256`). - Click **Export Selected Image as PNG** in the control bar to instantly export the active icon layer as a standalone transparent PNG file. - **Vector Graphics (SVG) & Source Inspection**: - Renders vector drawings with infinite sharpness at any scale. The right-click menu provides a one-click shortcut to view the raw XML source structure directly in the text viewer. ## PDF Document Viewer Features a lightweight native rendering engine tailored for office documentation and technical whitepapers, with background streaming rendering and deep annotation support. ### Reading Layouts & Tile Overview - **Two-Page Book Spread (P)**: Press P (or use the right-click menu) to toggle between continuous vertical scrolling and a realistic two-page book spread layout with binding gaps. - **Tile Overview Grid (Ctrl + G)**: Press Ctrl + G to enter the overview mode, rendering all document pages as an interactive thumbnail grid. Click any page thumbnail to jump directly to it. - **Rapid Navigation Shortcuts**: Press [ / ] to flip to the previous / next page; press Home / End to jump straight to the first / last page. Press M to toggle the navigation minimap. - **Direct Sizing**: Press W to fit page width, H to fit page height, or A to restore 1:1 original physical size. - **3 Reading Color Themes (D)**: Press D to cycle between **Default White**, **Dark Night Mode** (high-contrast eye saver), and **Warm Sepia** (eye-care reading tone) without modifying document colors. - **Page Separator Styles (G)**: Press G to cycle between clean default gap, solid line, dashed line, and wavy separator lines. - **Orientation (R / L)**: Rotate document pages 90° clockwise (R) or counter-clockwise (L). ### Default Zoom Modes & Sizing Rules In addition to shortcuts (Ctrl + = / Ctrl + - or Ctrl + mouse wheel), Seer provides 4 configurable default opening zoom modes in the right-click menu and configuration: - **Four Default Zoom Modes**: - **Default / Actual Size**: Opens pages at 1:1 original physical dimensions. **Important history behavior**: *Only* this default option recovers saved zoom levels from document history; other modes ignore history zoom upon opening. - **Fit Width**: Dynamically scales pages so the **maximum width across all pages** fits the viewer window. The initial zoom calculation references the window size base (default `fit_w = 960`, configurable in `user.ini [PDF]`). - **Fit Height**: Dynamically scales pages so the **current page** fits the viewer window height (in a two-page spread it uses the taller page of the facing pair). `fit_h = 960` in `user.ini [PDF]` only provides the initial window height base. - **Custom Zoom**: Always opens documents at your preferred custom scaling ratio (e.g., 125%, 150%). - **Right-Click Zoom Menu & Custom Default Setting**: - The right-click context menu displays the current live zoom percentage (e.g. `Custom (135%)`). - **"Set Current Zoom as Custom Default"**: When you have adjusted a document to your ideal comfortable reading size, right-click and choose this option to instantly save that exact percentage as your global custom default. ### Sidebar Navigation & Page Alignment - **Dynamic Inspection Sidebar (O)**: Press O to toggle the sidebar. To keep the interface clean, tabs appear dynamically based on document contents: - **Page Thumbnails**: Always available for every document, showing a continuous thumbnail strip with page numbers. - **Document Outline / TOC**: Appears **only when the PDF contains embedded bookmarks/TOC data**, displaying a multi-level collapsible tree for chapter jumping. - **Annotations & Comments**: Appears **only when the PDF contains reader annotations**, listing all highlights, strikethroughs, and notes across the document. - **Thumbnail Alignment (V)**: While reading in the main viewport, press V to automatically align and center the sidebar thumbnail list onto the currently visible page. - **Configurable Sidebar Docking**: By default, the sidebar is docked on the right. You can configure it to dock on the left via `user.ini [PDF] show_sidebar_left = true`. ### Interactive Hyperlinks, Search & Security - **Native Hyperlink Interaction**: Fully supports clicking table-of-contents entries, internal page anchors, external web URLs (opens directly in your default browser), and mailto email links. - **Annotation Visibility (T)**: Press T to toggle the visibility of document highlight markings, underlines, and reader annotations. - **Full-Text Streaming Search (Ctrl + F)**: - Background asynchronous chunked search with an active loading ring indicator. - Supports case-sensitive matching (`Aa`), current match deep orange highlight, matching items yellow highlight, and F3 / Shift + F3 stepping across hyphenated line breaks. - **Password-Protected Documents**: Encrypted PDF files automatically present a clean native password prompt to unlock and view contents safely. ## Folder & Archive Viewer Inspect folder structures and compressed archive contents instantly without disk decompression or temporary file clutter. ### Three Distinct View Modes - **Hierarchical Tree View (Alt + T)**: Classical multi-level collapsible directory tree showing folders and files in a unified tree hierarchy with expand/collapse arrows. - **Multi-Column Navigation (Alt + C)**: macOS Finder-style drill-down columns, allowing deep filesystem navigation by clicking through subfolders without losing parent context. - **Gallery View (Alt + Y)**: Thumbnail grid layout optimized for photo, graphic, and asset directories, with keyboard arrow navigation and an integrated side preview pane. ### Git Status Integration & In-Place Search - **Git Repository Status Badges**: - When viewing folders inside a Git repository, Seer automatically detects repository status and displays color-coded badges next to file entries: - **Modified (`M`)**: Tracked files with unstaged or staged modifications. - **Added (`A`)**: Newly staged files. - **Untracked (`?`)**: Newly created files not yet tracked by Git. - **Renamed (`R`)**: Files that have been renamed. - **Deleted (`D`)**: Tracked files that have been removed. - This feature can be toggled under **Settings > File Types > Folder** (enabled by default). - **In-Place File Search (Ctrl + F)**: - Press Ctrl + F to search filenames in real time with case matching (`Aa`). - Matching names are highlighted and non-matching entries are dimmed instead of hidden, so the folder structure stays readable. Enter or F3 steps through the matches in all three views. - **Side Info View & Preview Pane (Alt + D)**: - Press Alt + D to toggle the right info pane to inspect file thumbnails, EXIF metadata, and file remarks directly without opening separate preview windows. ### Archive Inspection & Fast Operations - **Instant Archive Inspection & Double Decompression**: - Native direct reading for archives including `.zip`, `.7z`, `.rar`, `.tar`, `.gz`, `.bz2`, `.xz`, `.zst`, `.iso`, `.cab`, `.chm`, and `.arj` without extracting temporary files to disk. - Supports nested archives requiring secondary decompression. - **Background Folder Size Calculation**: Opening a folder starts a size scan in a separate helper process, so the preview window stays responsive and the cumulative size of the folder appears in the Property Inspector once the scan finishes. - **Convenient Path Copying**: - Right-click menu shortcuts allow one-click copying of absolute paths, relative paths, or the entire directory listing to your clipboard. ## Web & Markdown Viewer Modern offline rendering for `.html`, `.mhtml`, and `.md` documents. ### Browser Engine & Security Considerations Seer embeds the **full Chrome (Chromium) browser engine**, providing layout and execution capabilities identical to modern web browsers: - **Chrome (Chromium) Core**: Full compatibility with HTML5, modern CSS3, JavaScript, Canvas, SVG, and hardware acceleration for offline single-page apps, reports, and `.mhtml` web archives. - **Local & Network Permissions**: - To support rich local reports, offline documentation, and Markdown previews, web security boundaries are relaxed: local documents can load cross-directory local assets, fetch external CDN resources, and access the clipboard. - **Data Caching & Persistent Storage**: - HTTP network cache is kept purely in memory (`MemoryHttpCache`), while persistent web storage (such as HTML5 `localStorage`, `IndexedDB`, and site data) is stored in `%LocalAppData%\Corey\Seer\web`. - ⚠️ **Security Warning**: - Because previewed HTML documents are granted local file reading, network access, and script execution permissions, **never preview untrusted, suspicious, or unverified `.html` files from unknown sources**. ### Floating FindBar & Table of Contents - **Floating FindBar Over WebEngine**: - The FindBar floats above the page in its own window, so it stays crisp and fully transparent over the hardware-accelerated web viewport instead of being covered by it. - Press Ctrl + F to open in-page keyword search, supporting case-sensitive matching (`Aa`) and F3 / Shift + F3 jumping. - **Floating Table of Contents (T)**: Press T to toggle a dynamic floating TOC on the side that tracks reading scroll progress in real time. - **Content Zoom**: Hold Ctrl and scroll the mouse wheel, or press Ctrl + = / Ctrl + - to zoom in or out. ### Markdown Themes, Math & Diagrams - **100% Offline & Self-Contained**: All Markdown rendering assets—including theme stylesheets, KaTeX math fonts, and the Mermaid diagram engine—are bundled directly within Seer. Markdown previews work completely offline with zero dependencies on external CDNs or online CSS/JS. - **Theme Library**: Curated built-in themes including `default`, `github_light`, `github_dark`, `obsidian`, `studio`, `papyrus`, `amethyst`, `prism`, `evergreen`, `sahara`, `nordic`, `paperwhite`, and more. Custom external CSS files can also be specified under **Settings > File Types > Web**. See [`custom-example.css`](https://github.com/ccseer/Seer-markdown-css/blob/master/custom-example.css) for a sample. - **LaTeX Math (KaTeX)**: Native rendering for inline `$math$` and display block `$$math$$` formulas. - **Technical Diagrams (Mermaid)**: Native rendering for flowcharts, sequence diagrams, and Gantt charts. - **GitHub Alerts**: Native styling for `[!NOTE]`, `[!TIP]`, `[!WARNING]`, `[!IMPORTANT]`, and `[!CAUTION]` blockquotes. - **Save as PDF**: The bottom control bar includes a "Save as PDF" action, allowing one-click export of styled Markdown or web pages into vector PDF documents. ## System Previewer & Thumbnail For proprietary or specialized file formats not covered by Seer's built-in viewers and without dedicated Seer plugins installed, Seer leverages the Windows operating system ecosystem via a two-tier fallback mechanism. ### Concepts & How It Works To understand this module, it is important to clarify what these two capabilities represent and where their underlying data originates: - **System Previewer**: - Corresponds directly to the content displayed in **Windows File Explorer's built-in Preview Pane** (toggled with Alt + P in Windows File Explorer). - It is an interactive preview component registered with the OS by third-party applications (e.g., scrollable document views, interactive sheet previews). - **System Thumbnail**: - Extracts the system-generated or application-generated **file icon/thumbnail and renders it enlarged and centered** in the preview window. When an interactive preview handler is unavailable, the enlarged high-resolution thumbnail ensures the file is still immediately identifiable. - **Data Source: Provided by Installed Applications**: Windows does not natively know how to preview every specialized proprietary file format. These capabilities are provided and registered into Windows by third-party software you install (for example, installing Adobe Photoshop provides `.psd` previews, Microsoft Office provides `.docx` / `.xlsx` / `.pptx` previews, and 3D/CAD suites provide engineering model previews). - **Seer's Role: Reading and Hosting the Existing Data**: - **Seer simply attempts to read and host this data from the operating system**. Seer does not bundle proprietary decoders for these closed formats itself; instead, it bridges into the Windows shell using standard system preview and thumbnail interfaces. - If the relevant application is not installed on the computer, or if that software did not register shell preview components with Windows, Seer cannot fabricate a preview out of thin air. ### Two-Tier Loading & Graceful Fallback When encountering a non-built-in format, Seer follows a prioritized sequential fallback: ```mermaid graph TD A["Proprietary / Non-Built-in File (Press Spacebar)"] --> B{"Is preview support available in Windows or installed apps?"} B -- "Available and loaded" --> C["Host System Previewer (Embedded native interactive viewport)"] B -- "Unavailable or failed to load" --> D{"Is Thumbnail Fallback enabled?"} D -- "Enabled and thumbnail exists" --> E["Extract Shell Thumbnail (Enlarged and centered)"] D -- "Disabled or no thumbnail found" --> F["Show unsupported file notice"] ``` 1. **First Priority: System Previewer**: Searches for and activates the preview component provided by Windows or installed software, embedding the identical native interactive view that would appear in File Explorer's preview pane. 2. **Second Priority: System Thumbnail**: If no preview handler is registered or initialization fails, Seer fetches the highest-resolution shell thumbnail and scales it up smoothly to fit the window. ### Keyboard Shortcut Reliability & Cloud Protection - **Keyboard Closure**: When Seer itself has focus, Space and Esc close the preview as usual. When an embedded third-party previewer (such as a Microsoft Office or Adobe preview handler) takes keyboard focus, the keystroke no longer reaches Seer directly, so Seer falls back to its low-level keyboard hook. Space is handled by the hook out of the box; Esc forwarding is controlled by `enable_esc_key` in `user.ini [General]` and is off by default — enable it if you want Esc to dismiss the window while an external previewer holds focus. - **Cloud Files on Demand Protection**: For online-only cloud files (such as OneDrive or cloud-synced placeholder files not yet downloaded locally), Seer automatically avoids activating preview handlers or metadata extraction, **preventing unwanted background file downloads**. ### Configuration & Management All settings for this module are managed under **Settings > File Types > System**: - **Global Toggle**: Enable or disable the fallback module entirely under **Settings > File Types > System**. - **Toggle Thumbnail Fallback Independently**: If you prefer interactive previewers only and wish to avoid enlarged static thumbnails, uncheck the option *Use system thumbnails for files without a preview handler* under **Settings > File Types > System**. - **File Extension Exclusion List**: Exclude specific problematic or slow third-party preview handlers by configuring `exclude` in `user.ini [SystemViewer]`. ### Known Limitations & Important Tips #### 1. File Locked While Preview Is Open > [!WARNING] > **File locked by preview component**: When viewing a document through the **System Previewer**, the active preview component provided by third-party software (such as Microsoft Office, Adobe Acrobat/Photoshop, or CAD suites) typically keeps the file open while the preview is active. - **Observed Behavior**: While the preview window remains open, attempting to **rename, move, overwrite, or delete** the file in Windows File Explorer or another program will trigger the Windows message: *"The action can't be completed because the file is open in another program"*. - **Resolution**: - Simply **close the Seer preview window** (by pressing Space or Esc) or navigate to any other file in your file explorer. Seer immediately closes the third-party preview component and releases the file, allowing rename or deletion operations to proceed normally. - **Comparison with Thumbnails**: - In contrast, when fallback **Shell Thumbnails** or Seer's native built-in viewers are active, files are read quickly and released immediately, without locking the file. #### 2. Data Caching & Manual Refresh > [!NOTE] > **Local Caching**: Retrieving supported preview formats from the operating system and third-party applications is a time-consuming process. To ensure instant previews when pressing Space, Seer stores this information in a **local cache**, avoiding redundant scans on every preview. - **Behavior after Software Changes**: When you **install or uninstall software** (e.g., installing Photoshop, Office, or CAD tools), Windows updates its configuration, but Seer may continue reading its cached data and might not immediately recognize the new preview capabilities. - **How to Refresh**: - Simply **restart Seer**, or toggle any viewer option in Seer Settings and click **OK** to trigger a full runtime reload. - **How it works**: A viewer runtime reload automatically clears the local system previewer cache, prompting Seer to rescan Windows and recognize newly installed preview components. ## Settings & Preferences Press Ctrl + , (or right-click the system tray icon and select **Settings**) to open the Seer configuration dialog. Here is a guided tour of the key options across the settings panels: ### 1. General Settings - **Language**: Choose your preferred user interface language. Seer ships with full localized interfaces for over 15 languages. - **Appearance Theme**: Switch between **Light**, **Dark**, and **Auto** (automatically matches your Windows system color mode). - **Run Seer When System Boots**: - **Desktop Version**: Uses the standard Windows registry startup by default. You can also opt into **Use Task Scheduler for Startup** under **Settings > System** for higher reliability and elevated privileges. - **Microsoft Store Version**: Click the **Open System Settings** button to jump directly to Windows Settings -> Apps -> Startup to enable automatic startup. - **Run as Administrator**: Relaunches Seer with elevated administrative privileges, allowing Seer to intercept keystrokes and preview files within applications running as Administrator (such as Total Commander, Directory Opus, or Everything run with admin rights). - **Check for Updates Automatically**: Toggle whether Seer automatically checks for new software releases on startup. ### 2. File Types Manage associations, view modes, and feature toggles for each format category under **Settings > File Types**: - **Category Tabs**: Switch between dedicated panels for **Text**, **Image**, **Media**, **Folder**, **PDF**, **Web** (formerly labeled HTML; both refer to the same viewer), **System**, **Unknown** (the property-inspector viewer used when no other viewer claims the file), and **Disabled**. - **Master Toggles & Custom Extensions**: Every category has an enable/disable switch. Extra extensions for a viewer are added through its `extra_support` key in `user.ini` (for example `[Text] extra_support`); the **Disabled** panel is the only one with a tag editor, and it holds the global exclusion list. - **Category-Specific Options**: - **Image**: Configure default view style (**Auto Fit**, **Fit Short Side**, **Prefer Full Size**) and mouse wheel behavior (scroll vs zoom). Minimap visibility is toggled with `M` in the viewer and remembered automatically (not a Settings-page option). - **Folder**: Toggle Git repository status badges (`M`, `A`, `?`, `R`, `D`). - **Web**: Select the default Markdown theme and optionally specify a custom external CSS file. - **System**: Toggle thumbnail fallback for unsupported formats. - **Disabled**: Blacklist specific file extensions that Seer should never preview. ### 3. Advanced Settings - **Double-Click to Open with Default Program**: When enabled, double-clicking anywhere inside the preview viewport instantly launches the file in its default registered application (same as pressing Ctrl + O). - **Load Cloud Files**: Controls whether Seer automatically triggers on-demand background downloads when previewing unhydrated cloud placeholder files (e.g. OneDrive files-on-demand). Keeping this unchecked preserves your network bandwidth and disk space. - **Tracking File**: Automatically follows your selection in File Explorer; navigating with arrow keys updates the preview window in real time without repeatedly pressing Space. - **Auto-Reload on External Modification**: When enabled (disabled by default), modifying and saving a previewed file in an external program reloads the view in place (the text viewer restores its saved reading position). For folders, it monitors 1st-level directory changes. - **Preview Window Focus**: Decides whether the preview window takes keyboard focus away from your file manager. This is the setting to look at when shortcuts seem to "not work" right after pressing Space: - **Never take focus** (default): The preview never steals focus from Explorer or your file manager, so typing and arrow keys keep working there. Pressing Space again closes the preview immediately, but viewer-level shortcuts (Z, M, Ctrl + F, ...) only respond after you click inside the window. - **Every time a file is previewed**: Each new preview activates the window, so viewer shortcuts work right away. The trade-off is that focus leaves the file manager after every Space. - **Only when the window opens**: Focus is taken once when the preview window appears, but switching files while it stays open does not grab focus again. - **Trigger on Software-Generated Key Events**: Off by default. Seer's keyboard hook deliberately ignores keystrokes that Windows flags as injected/simulated, so a macro, a virtual keyboard or a remote-control session does not accidentally pop up previews while you work. Turn it on when Seer is driven by automation — AutoHotkey/AutoIt scripts, on-screen keyboards, accessibility tools, or remote desktop/KVM setups that replay keystrokes. The option covers both the trigger key and the Delete/Esc handling below. - **Window Size and Position Mode**: - **Auto Size & Position** (default): Adapts the window dimensions dynamically based on each file's native aspect ratio and the viewer's optimal scale. - **Keep Window Size & Position**: Remembers the exact geometry and screen coordinates of the last closed preview window. - **Center Window on Open**: Always centers the preview window in the middle of your active monitor. - **Titlebar Button Action**: Choose what happens when clicking the primary button in the titlebar: - **Separate Window** (default): Detaches the current preview into its own floating window. It still belongs to the running Seer instance, so quitting Seer closes it. - **Pinned Window**: Keeps the preview pinned on top without dismissing when focus is lost. - **Standalone Window**: Launches a completely isolated viewer process (`SeerViewer.exe`). - **Enable Delete Key**: Lets Delete cooperate with Seer's file handles instead of fighting them. What actually happens depends on which window has focus: - **Preview window focused**: Seer closes the preview (and any detached window showing the same file), then moves the file to the Windows Recycle Bin. Nothing happens while the file is still loading, and pinned windows are left open — they are only closed by you. - **File manager focused**: Seer does not delete anything itself. It just hides the preview and releases the file handles, so the deletion you requested in Explorer, Total Commander or Directory Opus does not fail with "The action can't be completed because the file is open in another program". - Leave this off if you keep Seer open while reorganizing files and would rather no key press could ever remove a file. - **Hide System Tray Icon**: Hides Seer from the Windows system tray for maximum minimalism. If hidden, Seer provides an 8-second safety window on startup where the icon remains visible, allowing you to access settings. - **Open user.ini**: Click the `user.ini` button at the bottom to open `user.ini` in your default editor for manual fine-tuning (hover the button to see the full path; refer to [Custom Configuration Guide](https://1218.io/docs/seer/user-ini.html) for field references). ### 4. System - **Use Task Scheduler for Startup**: Toggle between Windows Task Scheduler (recommended, immune to UAC privilege blocks) and the legacy registry startup method. - **Context Menu Integration**: Adds the **"Open with SeerViewer"** action to Windows File Explorer's right-click context menu for all files and directories, launching the file directly into a standalone `SeerViewer.exe` process. - **Register in "Open With" Menu**: Registers `SeerViewer` in the native Windows "Open With" application list for all supported file formats. - **Set as Default App**: Opens the Windows **Default apps** page so you can point a file type at `SeerViewer` yourself. Seer cannot silently take over associations — Windows requires that confirmation. - **File Remarks Master Switch**: Toggle Seer's personal file note system on or off globally. ### 5. Keyboard Shortcuts - **Trigger Keys**: Customize the primary trigger key and modifier combination (e.g. Space, Alt + Space, Ctrl + Space, Shift + Space). - **Separate Window Trigger**: Set an alternative modifier combination to launch the preview directly into a detached window. - **Action Rebinding**: Rebind any global or viewer-specific shortcut (e.g., Rotate, Mute, Word Wrap, FindBar, Fullscreen) to match your personal muscle memory. ### 6. Backup, Import & Reset The three buttons at the bottom of **Advanced** move a whole configuration between machines or back to factory state: - **Export**: Writes a snapshot of the current settings to a `.ini` file you choose. The file is Seer's own export format (versioned, not intended for hand editing), so keep it as a backup rather than opening it in an editor. The snapshot covers the settings stored in `config.ini` (appearance, shortcuts, per-type options, plugin switches, ...). It does **not** include `user.ini` tweaks, and it deliberately skips activation data, recent lists (PDF / Media history, per-page zoom memory), window positions, and the multi-viewer assignment map. - **Import**: Applies a previously exported snapshot and then restarts Seer immediately, because several settings only take effect on a fresh start. Values are copied as-is — including any absolute paths inside them (see below). Files that are not Seer exports, or that were written by a different export format version, are refused with an error. - **Reset to default**: Clears `config.ini` back to defaults and restarts. Activation and license data are preserved, and hand-edited values in `user.ini` are not touched, so you keep your own advanced tweaks. The button first turns into a confirm/cancel pair — a second click is required. > [!WARNING] > **Paths inside a snapshot do not migrate.** Some settings are stored as absolute paths from the machine that created the export. On another device — different user name, drive letter, or Seer install location — those entries keep pointing at the old paths and silently stop working. Known cases: > > - **Plugins**: the extension registry records each package's install folder, and the plugin install directory itself is an absolute path. After moving to a new machine, reinstall the plugin packages (download from the [Plugin Downloads](https://1218.io/docs/seer/download.html) page) instead of expecting the imported registry to find them at the old location. > - **Local plugin entries** (the legacy `plugins_added` list) reference files by absolute path and will not resolve elsewhere. > - **Custom Markdown CSS** (`markdown_css_path`) points at a file on the old machine; re-select it under **Settings > File Types > Web**. > - **Autostart records** embed the registered executable path; re-toggle startup on the new machine. > > Path-free settings — theme, language, shortcuts, viewer toggles, decoding options, and so on — migrate cleanly. Plugin packages themselves are folders on disk and are never part of the snapshot; back them up separately if needed. ## Source: https://1218.io/docs/seer/add-plugin.html — Preview More Formats # Preview Plugins Preview plugins extend Seer's native viewing engine, enabling instant previews for file formats not supported out of the box (such as CAD drawings, EPUB ebooks, 3D assets and specialized formats). ## 1. Online Installation (Available) The built-in plugin repository allows you to browse and install verified plugins directly: 1. Open Seer settings (`Ctrl+,` or right-click the system tray icon and select `Settings`). 2. Navigate to `Settings > Viewers` and switch to the **Available** tab. 3. Browse the list or use the search bar to locate the plugin you need. 4. Click **Install**. 5. Click **Tasks** to monitor download progress and installation status. 6. Click **Okay** to save settings and use the plugin. _Note: If an installation fails due to a locked file or temporary network issue, restart Seer and click Retry in the Tasks panel._ ## 2. Local Installation (Local) ### Download Plugins - **Recommended**: Visit [Plugin Downloads - Viewers](https://1218.io/docs/seer/download.html#viewers) to easily find and download official packaged viewer extensions (`.zip`). - [Browse plugin releases on GitHub](https://github.com/ccseer/Seer-Plugins/releases). Choose the plugin you need and check its release notes for Seer version requirements. Under **Assets**, download the plugin ZIP, not GitHub's **Source code** archive. Different plugins may be listed under different releases. If in-app installation is slow or unavailable, use this manual download instead. You can import the ZIP directly without extracting it. ### Install the Download If you already have a package or developed your own: 1. In `Settings > Viewers`, switch to the **Local** tab. 2. Click **+** below the list. 3. Select your plugin file: - **Packaged Plugin:** A `.zip` archive containing the plugin assets. - **Plugin Manifest:** A `plugin.json` definition file. 4. Seer prepares the package and selects it in the appropriate settings page. 5. Review its settings, then click **Okay** to save and activate it. **Cancel** discards the import. If importing a manifest, keep it alongside the executable and other package files; the JSON alone is not a complete plugin. ## 3. Managing Installed Plugins ### Priority Ordering If multiple plugins support the same file extension, Seer checks viewer type priority first: DLL plugins take precedence over conversion plugins. - Within the same priority level, plugins are checked in **top-to-bottom order**. Drag items in the Local table to change that order. - Moving a plugin above one of a higher-priority type does not override the type priority. ### Enabling / Disabling - Select a plugin and toggle **Enabled** in its details, then save settings. ### Customizing Format Overrides - Select a plugin in the table to display its details on the right panel. - Under **File Formats**, you can add, modify, or remove extensions handled by the plugin. - Adjust CLI arguments or execution parameters if needed. ### Uninstalling - Select the plugin and click **Delete** in the details pane. Click **Okay** to commit removal and clean up its managed package files. --- ## Important Notes - **Package Files:** Seer copies imported packages into its managed plugin directory. Do not move or edit the deployed files there. - **Extension Matching:** File extensions are case-insensitive (e.g., `.PNG` and `.png` match identically). - **Source Files:** Keep the downloaded package intact until installation finishes. - **Performance:** Keep only the plugins you actively use enabled to maintain Seer's fast startup and minimal memory footprint. ## Source: https://1218.io/docs/seer/add-ctrlbar.html — Launch from Control Bar # Customizing Control Bar Buttons ## Overview The **Control Bar** is divided into two sections: * **Left (File-level):** Integration with external applications and quick actions (e.g., "Open with...", "Reveal in File Explorer"). These are configurable in `Settings > Controls`. * **Right (Preview-level):** Viewport controls (e.g., rotate, mute, zoom). This guide focuses on extending the **Left** section. ## Adding Controls In `Settings > Controls`, you can manage built-in buttons, create custom actions, or install control plugins. ### 1. Custom Actions 1. Click **+** below the actions list and select the program or script to run. 2. Configure the action details on the right panel: * **Name**: Display name shown in tooltips. * **Executable**: Path to the target executable (`.exe`). * **Arguments**: Command-line arguments. Use placeholders like `"${input_file}"` to pass file paths. * **File Formats**: Target file extensions (e.g., `png`, `zip`) or **Special Tokens** (e.g., `${type_folder}`). * **Close preview after successful launch**: Close the preview once the external program starts successfully. Seer does not wait for the program to finish. ### 2. Control Plugins Control plugins supply packaged actions. They are separate from custom actions, which use a program or script you already have. #### Official Control Plugins Official control plugin packages are available in the download center. Please visit [Plugin Downloads - Controls](https://1218.io/docs/seer/download.html#controls) to download the `.zip` packages. Downloaded archives can be imported directly in `Settings > Controls` without extracting. #### Install the Download 1. In `Settings > Controls`, click **+** below the list. 2. Select the downloaded `.zip` directly, or select `plugin.json` from a complete extracted package. 3. Review the imported action's formats and behavior in the details panel. 4. Click **Okay** to save and use it. **Cancel** discards the import. If a package provides a different capability, Seer takes you to the corresponding settings page. ## Managing Actions * **Reorder**: Drag and drop items in the list to rearrange button order on the Control Bar. * **Toggle**: Select an action and change **Enabled** in its details, then save settings. * **Customize Overrides**: For installed plugins, you can customize the matched file formats and CLI arguments, or reset them to default anytime. * **Built-in Buttons**: Built-in actions (Open with Default Application, Reveal in File Explorer, Same-Type Navigation) can be toggled individually. ## Placeholders and Arguments When configuring custom actions or control plugins, you can use placeholders in the command-line arguments to dynamically pass information about the currently previewed target: - **Common Placeholders**: - `"${input_file}"`: Absolute path of the previewed file or folder (if the path may contain spaces, **always wrap it in double quotes**). - `${7z}`: Absolute path to the bundled `7z.exe` (can also be entered directly in the **Executable** field). - **File Format Special Tokens**: In the **File Formats** field, in addition to standard file extensions (e.g. `png, zip`), you can match broad categories: - `${type_folder}`: Matches directories and folders; - `${type_file}`: Matches all files; - `${type_all}`: Matches both files and folders. > [!TIP] > **Complete Placeholders & Capability-Specific Rules:** > Different plugin capabilities support different sets of placeholders (for example, Control plugins only receive read-only input paths and cannot use output directory tokens; Property plugins require output paths). > > Visit the official reference guide for the complete specification: > - 📖 [Control Plugin Placeholders](https://1218.io/docs/seer/create-plugin.html#control-placeholders) > - 🌐 [Universal Placeholders](https://1218.io/docs/seer/create-plugin.html#universal-placeholders) (including `${seer_exe}`, `${theme}`, `${lang}`, `${screenshot}`, etc.) > - 🏷️ [File Format Matcher Tokens (`${type_*}`)](https://1218.io/docs/seer/create-plugin.html#matcher-tokens) ### 3. Configuration Example: Extract Archive with 7-Zip To add a button that extracts archives using the bundled 7-Zip: 1. **Executable**: `${7z}` (or browse to your own `7z.exe`). 2. **Arguments**: `x "${input_file}" -r -y -o"C:\Output\Path\"` 3. **File Formats**: `zip rar 7z tar gz` **Parameter Breakdown:** * `x`: Extract with full paths. * `"${input_file}"`: Target archive file. * `-r`: Recurse into subdirectories. * `-y`: Assume Yes on all queries (overwrite). * `-o"..."`: Output directory. ## Source: https://1218.io/docs/seer/add-property.html — Explore File Properties # Property Plugins Property plugins extend Seer's metadata extraction engine. When you open the properties window (or press `Ctrl + I` on a previewed file), property plugins inspect the file and display structured attributes and metadata. The default shortcut is `Ctrl + I`; you can change it in Settings. ## 1. What Property Plugins Do Each installed plugin determines which files it can inspect and which fields it returns. ## 2. Managing Property Plugins All property plugins are managed in `Settings > Properties`: ### Official Property Plugins Official property plugin packages are available in the download center. Please visit [Plugin Downloads - Properties](https://1218.io/docs/seer/download.html#properties) to download the `.zip` packages. Downloaded archives can be imported directly in `Settings > Properties` without extracting. ### Local Installation 1. In `Settings > Properties`, click **+** below the list. 2. Select the downloaded `.zip` directly, or select `plugin.json` from a complete extracted package. 3. Seer prepares the package and selects its entry. Review the formats and **Enabled** setting. 4. Click **Okay** to save and use it. **Cancel** discards the import. If a package provides a different capability, Seer takes you to the corresponding settings page. ### Configuration & Customization - **Toggle:** Select a plugin and change **Enabled** in its details, then save settings. - **Format Overrides:** Select any property plugin to inspect its details on the right panel, where you can customize its matched file extensions or remove it via the **Delete** button. ## Source: https://1218.io/docs/seer/download.html — Plugin Downloads # Plugin Downloads Seer supports extending its preview capabilities, file property extraction, and control bar actions through plugins. You can choose from the categories below to download official and community plugin packages (`.zip`). Downloaded archives do not need manual extraction. Simply go to Settings in Seer (`Settings > Viewers/Properties/Controls`), click **+**, and select the `.zip` archive to import and activate it. No matching viewer plugins found | Plugin Name | Version | Supported Formats | Description | Download | | :--- | :--- | :--- | :--- | :--- | | [OfficeViewer](https://github.com/ccseer/OfficeViewer) | `1.5.1` | `doc, docx, ppt, pptx, xls, xlsx, vsd, dxf, dwg, pst, msg, mdb, eml, uue, 123, prz, drw, pct, mpp, qpw, wpd, shw` | Microsoft Office documents, AutoCAD drawings, and more | [Download](https://1218.io/seer/OfficeViewer-1.5.1.zip) | | [FontViewer](https://github.com/ccseer/FontViewer) | `1.3.0` | `ttf, otf, otc, ttc` | TrueType and OpenType font rendering and preview | [Download](https://1218.io/seer/FontViewer-1.3.0.zip) | | [JsonTreeViewer](https://github.com/ccseer/JsonTreeViewer) | `1.1.0` | `json` | High-performance interactive JSON tree structure powered by simdjson | [Download](https://1218.io/seer/JsonTreeViewer-1.1.0.zip) | | [f3dviewer](https://github.com/ccseer/f3dviewer) | `1.1.1` | `vtk, vtp, vtu, vtr, vti, vts, vtm, ply, stl, dcm, nrrd, nhrd, mhd, mha, tif, tiff, e, ex2, exo, g, gml, pts, step, stp, iges, igs, brep, abc, obj, gltf, glb, 3ds, wrl, fbx, dae, off, dxf, x, 3mf, usd, usda, usdc, usdz, vdb` | Interactive 3D and CAD model rendering | [Download](https://1218.io/seer/f3dviewer-1.1.1.zip) | | [DataTreeViewer](https://github.com/ccseer/DataTreeViewer) | `1.1.0` | `jsonc, yaml, yml, ini, cfg, conf, toml, tml, jsonl, ndjson, cbor, xml, svg, xhtml, plist, env` | Structured configuration files and data tree inspection | [Download](https://1218.io/seer/DataTreeViewer-1.1.0.zip) | | [DataTableViewer](https://github.com/ccseer/DataTableViewer) | `1.1.0` | `csv, tsv, sqlite, sqlite3, db, db3, sl3` | Tabular data viewer for CSV, TSV, and SQLite databases | [Download](https://1218.io/seer/DataTableViewer-1.1.0.zip) | | [eps2png](http://ghostscript.com/index.html) | `1.1.1` | `eps` | Ghostscript-based Encapsulated PostScript (EPS) renderer | [Download](https://1218.io/seer/eps2png-1.1.1.zip) | | [docx-editor-wrapper](https://github.com/ccseer/docx-editor-wrapper) | `1.0.0` | `docx` | Dedicated preview extension for Microsoft Word DOCX files | [Download](https://1218.io/seer/docx-editor-wrapper-1.0.0.zip) | | `dll_lib_exports` | - | `dll, lib` | View exported symbols and functions in Windows DLL and LIB files | [Download](https://1218.io/seer/dll_lib_exports.zip) | | [ImageMagick](http://www.imagemagick.org) | `1.1.0` | `jxl` | Modern high-efficiency JPEG XL image format support | [Download](https://1218.io/seer/ImageMagick-1.1.0.zip) | | [oiio](https://github.com/OpenImageIO/oiio) | `1.0.0` | `exr, dds, sgi, dpx, hdr, rla` | Professional HDR and texture formats powered by OpenImageIO | [Download](https://1218.io/seer/oiio-1.0.0.zip) | | [exiftool](http://www.sno.phy.queensu.ca/~phil/exiftool) | - | `indd` | Adobe InDesign document preview and metadata extraction | [Download](https://1218.io/seer/InDesign.zip) | | [mdkadapter](https://www.red.com) | `1.2.0` | `r3d, braw` | Professional raw cinema video formats (RED R3D and Blackmagic RAW) | [Download](https://1218.io/seer/mdkadapter-1.2.0.zip) | | [torrent2json](https://github.com/ccseer/Seer-plugins/tree/master/Qt_Torrent2Json) | - | `torrent` | BitTorrent file list and torrent metadata inspection | [Download](https://1218.io/seer/torrent2json.zip) | | [ApkMetaInfo2Json](https://github.com/ccseer/Seer-plugins/tree/master/Qt_ApkMetaInfo2Json) | - | `apk` | Android APK icon, package name, and permissions inspection | [Download](https://1218.io/seer/ApkMetaInfo2Json.zip) | | `epub` | `1.0.1` | `epub` | EPUB e-book cover and content viewer | [Download](https://1218.io/seer/epub-1.0.1.zip) | | `ipynb` | `1.2.0` | `ipynb` | Jupyter Notebook interactive notebook viewer | [Download](https://1218.io/seer/ipynb-1.2.0.zip) | | `XMindThumbnail` | - | `xmind` | XMind mind map thumbnail and diagram preview | [Download](https://1218.io/seer/xmind.zip) | | `BPG Viewer` Community | `1.1.2` | `bpg` | Preview Better Portable Graphics (BPG) images (by [@wunshare](https://github.com/wunshare)) | [Download](https://github.com/wunshare/seer_bpg_plugin/releases) | Created a Seer plugin? Share it with the community! [Submit Your Plugin →](https://github.com/ccseer/Seer-Plugins/issues/new/choose) No matching property plugins found | Plugin Name | Version | Supported Formats | Description | Download | | :--- | :--- | :--- | :--- | :--- | | [Image Scopes](https://github.com/ccseer/Seer-Properties/tree/main/plugins/image-histogram-property) | `1.1.0` | `png, jpg, jpeg, bmp, webp, tif, tiff` | Renders an RGB histogram, a luma waveform, and a Cb/Cr vectorscope with exposure statistics | [Download](https://1218.io/seer/properties/image-histogram-property-1.1.0.zip) | | [File Hashes](https://github.com/ccseer/Seer-Properties/tree/main/plugins/sha256-property) | `1.1.0` | `${type_file}` | Computes file hash digests (SHA-256 by default; supports CRC32, BLAKE3, SHA-512, etc.) | [Download](https://1218.io/seer/properties/sha256-property-1.1.0.zip) | | [Git Info](https://github.com/ccseer/Seer-Properties/tree/main/plugins/git-info-property) | `1.0.0` | `${type_folder}` | Reports the git state of the inspected folder (branch, HEAD state, upstream, change counts, and repository type) | [Download](https://1218.io/seer/properties/git-info-property-1.0.0.zip) | | [Digital Signature](https://github.com/ccseer/Seer-Properties/tree/main/plugins/digital-signature-property) | `1.0.0` | `dll, exe` | Verifies Windows Authenticode signatures (embedded or local catalog) for dll and exe files, fully offline | [Download](https://1218.io/seer/properties/digital-signature-property-1.0.0.zip) | | [PDB](https://github.com/ccseer/Seer-Properties/tree/main/plugins/pdb-property) | `1.0.0` | `pdb` | Read-only summary of PDB symbol files: format version, GUID, architecture, symbol/type/source counts, and largest object contributions | [Download](https://1218.io/seer/properties/pdb-property-1.0.0.zip) | Created a Seer plugin? Share it with the community! [Submit Your Plugin →](https://github.com/ccseer/Seer-Plugins/issues/new/choose) No matching control plugins found | Plugin Name | Version | Applies To | Description | Download | | :--- | :--- | :--- | :--- | :--- | | [Open With](https://github.com/ccseer/Seer-Controls/tree/main/plugins/explorer-open-with) | `1.2.0` | `${type_file}` | Opens the Windows "Open with" dialog for the current file | [Download](https://1218.io/seer/controls/explorer-open-with-1.2.0.zip) | | [Explorer Properties](https://github.com/ccseer/Seer-Controls/tree/main/plugins/explorer-properties) | `1.2.0` | `${type_file}` | Opens the Windows Explorer Properties dialog for the current file | [Download](https://1218.io/seer/controls/explorer-properties-1.2.0.zip) | | [Share](https://github.com/ccseer/Seer-Controls/tree/main/plugins/explorer-share) | `1.2.0` | `${type_file}` | Opens the Windows system Share UI for the current file | [Download](https://1218.io/seer/controls/explorer-share-1.2.0.zip) | | [Terminal Here](https://github.com/ccseer/Seer-Controls/tree/main/plugins/terminal-here) | `1.1.0` | `${type_folder}` | Opens a terminal at the selected folder (auto-detects Windows Terminal, PowerShell or CMD) | [Download](https://1218.io/seer/controls/terminal-here-1.1.0.zip) | | [Copy Folder Listing](https://github.com/ccseer/Seer-Controls/tree/main/plugins/copy-folder-listing) | `1.1.0` | `${type_folder}` | Copies the first-level contents of the selected folder to the clipboard | [Download](https://1218.io/seer/controls/copy-folder-listing-1.1.0.zip) | | [Who Is Locking This File?](https://github.com/ccseer/Seer-Controls/tree/main/plugins/file-lock-info) | `1.1.0` | `${type_file}` | Shows which applications and services are using the current file, reported by the Windows Restart Manager | [Download](https://1218.io/seer/controls/file-lock-info-1.1.0.zip) | | [OCR Text](https://github.com/ccseer/Seer-Controls/tree/main/plugins/ocr) | `1.0.0` | `${type_pdf}`, `${type_image}` | Extracts text from the current view (PDF or Image) using local on-device OCR, with built-in QR/barcode detection | [Download](https://1218.io/seer/controls/ocr-1.0.0.zip) | | [Hex View](https://github.com/ccseer/Seer-Controls/tree/main/plugins/hex-viewer) | `1.0.0` | `${type_file}` | Generates a classic 16-byte hex dump of any file and shows it instantly in a separate window | [Download](https://1218.io/seer/controls/hex-viewer-1.0.0.zip) | | [Quantize Image](https://github.com/ccseer/Seer-Controls/tree/main/plugins/image-quantize) | `1.0.0` | `${type_image}` | Compresses the image into a high-quality palette PNG (up to 256 colors, alpha preserved) next to the source — offline Oklab perceptual quantization with Floyd–Steinberg dithering, often smaller than pngquant and comparable to TinyPNG | [Download](https://1218.io/seer/controls/image-quantize-1.0.0.zip) | Created a Seer plugin? Share it with the community! [Submit Your Plugin →](https://github.com/ccseer/Seer-Plugins/issues/new/choose) --- ## Installation Tips - **Viewers**: In `Settings > Viewers`, switch to the **Local** tab, click **+**, and select the downloaded `.zip` file. - **Properties**: In `Settings > Properties`, click **+** below the list and select the downloaded `.zip` file. - **Controls**: In `Settings > Controls`, click **+** below the list and select the downloaded `.zip` file. ## Source: https://1218.io/docs/seer/create-plugin.html — Create Plugin # Plugin Development & Implementation Seer provides a modular plugin architecture that allows developers to extend its capabilities across multiple surfaces. Select a plugin capability below to explore its development specifications: ## Preview Plugins (Viewers) Preview plugins extend the spacebar preview window. They support two implementation architectures: **Convert Plugins** and **DLL Plugins (SDK v3)**. ### Build a Preview Plugin with an AI Agent Replace the placeholder below, then give the complete instruction to your coding agent: ```text Read and follow the Seer plugin development guide at https://raw.githubusercontent.com/ccseer/Seer-Plugins/refs/heads/master/plugin_development_guide.md. Treat it as the source of truth for architecture, plugin.json, implementation, validation, and packaging. If the guide is unavailable, stop and report that before proceeding. Before doing any work, inspect the Requirement below. If it is missing, unchanged placeholder text, or too ambiguous to implement, ask one clarifying question and wait. Do not infer the missing requirement. Once clear, choose Convert or DLL and briefly justify the choice, then implement a complete, installable plugin in the current workspace. Do not modify Seer itself or stop at a plan or code snippets. Follow every applicable validation step in the guide and report the actual results. Run an in-app Seer preview test when possible; otherwise explicitly state that runtime verification was not performed. Requirement: [REPLACE THIS PLACEHOLDER with your preview plugin requirement, e.g. render mermaid diagrams in markdown preview] ``` ### Convert Plugins Seer treats convert plugins as external command-line executors. When a user presses Space on a supported file, Seer launches the configured program, passing file paths via placeholders. The program converts the file into a format natively supported by Seer (HTML, JSON, TXT, images, etc.), which Seer loads and renders once the process exits. #### Placeholder Variables | Placeholder | Description | Example | | :--- | :--- | :--- | | `${output_file}` | Base output file path; append the target extension in arguments. | `${output_file}.html` | | `${no_cache}` | Disables conversion caching and stores output in the auto-delete directory, which is purged when preview windows close. | `${no_cache}` | Convert plugins also accept the universal placeholders (`${input_file}`, `${use_backslash}`, `${seer_dir}`, `${seer_exe}`, `${seerviewer_exe}`, `${7z}`) and do not use the `${type_*}` matcher tokens, because they declare their matches in `formats` rather than `extensions`. Both are covered in the shared **Placeholders & Matching Tokens** section below. #### Supported Executables & Script Runtimes - **Scripts**: PowerShell scripts (`.ps1`, supported out-of-the-box via PowerShell). For Python (`.py`), Node.js (`.js`), or batch (`.bat`), compile into a standalone `.exe` (e.g. with PyInstaller) or bundle the interpreter inside the package. - **Custom Binaries**: Standalone CLI executables compiled from C/C++, Rust, Go, or C#. #### `plugin.json` Example (Convert) ```json { "name": "ipynb", "version": "1.2.0", "type": "convert", "roles": [ "viewer" ], "entry": "ipynb.ps1", "args": [ "-i", "${input_file}", "-o", "${output_file}.html" ], "formats": [ "ipynb" ], "appMinVersion": "4.1.3", "author": "ccseer" } ``` ### DLL Plugins (SDK v3) For maximum rendering performance, deep interactivity, or streaming views, Seer supports native C++/Qt dynamic link libraries loaded directly into the viewport via `QPluginLoader`. - **Technical Specifications**: C++17, Qt 6.8, MSVC 2022 (x64), CMake 3.22+. - **Essential Interfaces**: Inherit `ViewerBase` (widget implementation) and implement `ViewerPluginInterface` (IID `"seer.plugin.interface.preview/3"`). - **Minimum App Version**: SDK v3 plugins must declare `"appMinVersion": "4.2.9"`. #### Reference Projects | Project | Purpose | | :--- | :--- | | [F3DViewer](https://github.com/ccseer/f3dviewer) | 3D model rendering and panoramic view | | [OfficeViewer](https://github.com/ccseer/OfficeViewer) | Office documents and CAD drawings | | [FontViewer](https://github.com/ccseer/FontViewer) | Font glyph inspection and rendering | | [JsonTreeViewer](https://github.com/ccseer/JsonTreeViewer) | High-performance interactive JSON tree | | [Collections](https://github.com/stars/ccseer/lists/plugins) | All official and community preview plugins | ## Control Plugins Control plugins add custom action buttons to the **left side of the bottom Control Bar** in the preview window, enabling quick operations and external tool integrations for the active file or folder. ### Build a Control Plugin with an AI Agent Replace the placeholder below, then give the complete instruction to your coding agent: ```text Read and follow the Seer control plugin development guide at https://raw.githubusercontent.com/ccseer/Seer-Controls/refs/heads/main/plugin_development_guide.md. Treat it as the source of truth for architecture, plugin.json, implementation, validation, and packaging. If the guide is unavailable, stop and report that before proceeding. Before doing any work, inspect the Requirement below. If it is missing, unchanged placeholder text, or too ambiguous to implement, ask one clarifying question and wait. Do not infer the missing requirement. Once clear, implement a complete, installable control plugin adhering to the Canonical v1 process contract in the current workspace. Do not modify Seer itself or stop at a plan or code snippets. Follow every applicable validation step in the guide and report the actual results. Requirement: [REPLACE THIS PLACEHOLDER with your control plugin requirement, e.g. open VS Code in the current directory or copy absolute path to clipboard] ``` ### Architecture & Contract - **Process Model**: Implements the Canonical v1 process contract (`backend: "process"`, `capabilities: ["control"]`). Seer executes the helper via CLI. - **Return Status & Error Reporting**: - **Success**: The process exits with code `0` (or matches `success_exit_codes`). If `"close_after_success": true` is configured, Seer automatically closes the preview window after execution succeeds. - **Failure**: The process exits with a non-zero code. Anything written to standard error (`stderr`) is captured by Seer and shown as an in-app **Toast failure notification**. - **UI & Interaction**: Control plugins do not draw persistent main windows of their own. Typical helpers run background tasks, copy text to the clipboard, or invoke native Windows system dialogs (e.g. Open With, Properties, Share). ### Command-Line Placeholders A control helper receives the target path only — `${input_file}` plus the universal placeholders (`${use_backslash}`, `${seer_dir}`, `${seer_exe}`, `${seerviewer_exe}`, `${7z}`) listed in the shared **Placeholders & Matching Tokens** section below. > [!WARNING] > `${output_dir}`, `${output_file}`, and `${no_cache}` are **rejected** in a control manifest. A control that needs a scratch location must resolve one itself: its own executable directory first, then the system temp directory. ### `plugin.json` Examples (Control) #### Example 1: Folder Action (`Terminal Here`) The official **Terminal Here** plugin configuration: ```json { "schema_version": 1, "id": "io.1218.seer.terminal-here", "name": "Terminal Here", "description": "Opens a terminal window in the current folder.", "version": "1.0.0", "appMinVersion": "4.5.10", "backend": "process", "capabilities": [ "control" ], "extensions": [ "${type_folder}" ], "command": "terminal_here.exe", "arguments": [ "--input", "${input_file}" ], "close_after_success": false, "timeout_ms": 150000, "success_exit_codes": [ 0 ] } ``` #### Example 2: File Action (`Explorer Open With`) The official **Explorer Open With** plugin configuration: ```json { "schema_version": 1, "id": "io.1218.seer.explorer-open-with", "name": "Open With", "description": "Opens the Windows Open With dialog for the current file.", "version": "1.1.0", "appMinVersion": "4.5.10", "backend": "process", "capabilities": [ "control" ], "extensions": [ "${type_file}" ], "command": "shellopenwith.exe", "arguments": [ "--input", "${input_file}", "${use_backslash}" ], "timeout_ms": 30000, "success_exit_codes": [ 0 ] } ``` > [!TIP] > To automatically close the preview window upon success, set `"close_after_success": true` in the manifest. For official control plugin source code, see: [ccseer/Seer-Controls](https://github.com/ccseer/Seer-Controls). ## Property Plugins Property plugins extend Seer's metadata inspection engine. When a user presses `Ctrl + I` on a previewed file or folder (or opens the Properties window), matching property plugins extract and display structured metadata and graphical scopes/charts. ### Build a Property Plugin with an AI Agent Replace the placeholder below, then give the complete instruction to your coding agent: ```text Read and follow the Seer property plugin development guide at https://raw.githubusercontent.com/ccseer/Seer-Properties/refs/heads/main/plugin_development_guide.md. Treat it as the source of truth for architecture, plugin.json, implementation, validation, and packaging. If the guide is unavailable, stop and report that before proceeding. Before doing any work, inspect the Requirement below. If it is missing, unchanged placeholder text, or too ambiguous to implement, ask one clarifying question and wait. Do not infer the missing requirement. Once clear, implement a complete, installable property plugin adhering to the Canonical v1 process contract and Schema 1 JSON specification in the current workspace. Do not modify Seer itself or stop at a plan or code snippets. Follow every applicable validation step in the guide and report the actual results. Requirement: [REPLACE THIS PLACEHOLDER with your property plugin requirement, e.g. extract and display detailed audio/video codec parameters and bitrate for MP4 files] ``` ### Architecture & Contract - **Process Model**: Implements the Canonical v1 process contract (`backend: "process"`, `capabilities: ["property"]`, `result_schema: 1`). - **CLI Invocation**: The host passes: `--input "${input_file}" --output "${output_file}" --output-dir "${output_dir}"` - **Output Publication**: - The host expands `${output_file}` to a base path without an extension (e.g. `/`). - The plugin **must** write its JSON result to `.json` (i.e. `${output_file}.json`). - Visual attachments (charts, histograms, vectorscopes) must be saved into `${output_dir}`. - **Constraint**: `${no_cache}` is **forbidden** for property plugins. - **Exit Code Policy**: - Expected domain results (e.g. unsigned file, not a git repository, empty metadata) **must exit with code `0`** and describe the status in JSON. - Exit non-zero **only** on fatal errors or invalid invocations (non-zero exits cause the host to wipe the request directory). ### Command-Line Placeholders | Placeholder | Description | Example | | :--- | :--- | :--- | | `${output_file}` | Host-assigned base path with no extension; the result must be written to `${output_file}.json`. | `C:\Users\...\request_dir\md5_hash` | | `${output_dir}` | Host-assigned request directory for attachments (charts, images). | `C:\Users\...\request_dir` | Plus the universal placeholders listed in the shared **Placeholders & Matching Tokens** section below, which also covers the `${type_*}` matcher tokens. `${no_cache}` is rejected for property plugins. ### Result JSON (Schema 1) Specification The result file `${output_file}.json` must be valid UTF-8 JSON containing `result_schema: 1` and a `data` object: #### 1. Flat Rows Only when the whole result is a **single row** (e.g. SHA-256): ```json { "result_schema": 1, "data": { "SHA-256": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824" } } ``` #### 2. Subgroup with an Ordered Array of Single-Key Objects (Default) Anything that produces more than one row must be published as **exactly one subgroup** titled after the plugin — loose top-level rows collide with every other plugin's rows, which the Inspector shows in one list. The array order is the render order, so this is the only form that lets the plugin decide the sequence the rows appear in: ```json { "result_schema": 1, "data": { "Git": { "value": [ { "Repository": "ccseer/Seer-Properties" }, { "Branch": "main" }, { "Status": "Clean" } ] } } } ``` #### 3. Subgroup with a Value Object `value` may also be a plain object, but its rows are rendered in the key order of the parsed object, which the plugin cannot control. Use it only when row order does not matter: ```json { "result_schema": 1, "data": { "Git": { "value": { "Branch": "main", "Status": "Working tree clean" } } } } ``` #### 4. Graphical Charts & Scopes (Image Attachments) Save generated PNG charts into `${output_dir}`, and declare them with `{"type": "image", "value": "relative_filename.png"}`: ```json { "result_schema": 1, "data": { "Image Scopes": { "value": [ { "RGB Histogram": { "type": "image", "value": "histogram.png" } }, { "Luma Waveform": { "type": "image", "value": "waveform.png" } } ] } } } ``` ### `plugin.json` Example (Property) ```json { "schema_version": 1, "id": "io.1218.seer.git-info", "name": "Git Info", "description": "Reports repository information for the current folder using Git.", "version": "1.0.0", "appMinVersion": "4.5.10", "backend": "process", "capabilities": [ "property" ], "extensions": [ "${type_folder}" ], "invocations": { "property": { "command": "git_info.exe", "arguments": [ "--input", "${input_file}", "--output", "${output_file}", "--output-dir", "${output_dir}" ], "result_schema": 1, "timeout_ms": 30000, "success_exit_codes": [ 0 ] } } } ``` For official property plugin source code, see: [ccseer/Seer-Properties](https://github.com/ccseer/Seer-Properties). --- ## Placeholders & Matching Tokens Seer expands these tokens in `arguments`. Which placeholders a capability may use is validated by the host when the manifest loads — an unsupported token is a manifest-loading error, not a runtime warning. ### Available to Every Capability | Placeholder | Description | Example | | :--- | :--- | :--- | | `${input_file}` | Absolute path of the previewed file or folder. | `C:\Docs\sample.pdf` | | `${use_backslash}` | Optional directive flag to format path separators using Windows native backslashes (`\`). Must be passed as a standalone argument (e.g. `"${use_backslash}"`), never concatenated with other text. | `${use_backslash}` | | `${seer_dir}` | Directory containing `Seer.exe`. | `C:\Program Files\Seer` | | `${seer_exe}` | Absolute path to `Seer.exe`. Can be passed as an argument, or used directly as the `command` or Executable field. | `C:\Program Files\Seer\Seer.exe` | | `${seerviewer_exe}` | Absolute path to `SeerViewer.exe`. Can be passed as an argument, or used directly as the `command` or Executable field. | `C:\Program Files\Seer\SeerViewer.exe` | | `${7z}` | Absolute path to `7z.exe` bundled with Seer. Can be passed as an argument, or used directly as the `command` or Executable field. | `C:\Program Files\Seer\plugins\7z.exe` | | `${theme}` | Current Seer theme, expanded as `dark` or `light`. A data placeholder that cannot be used as the entire `command`. | `dark` | | `${lang}` | Current Seer language, expanded in BCP-47 format (e.g. `en`, `zh-CN`). A data placeholder that cannot be used as the entire `command`. | `en` | | `${screenshot}` | Absolute path to a temporary PNG screenshot of the current view (captured on demand, primarily for control plugins; remains literal if view is not ready). A data placeholder that cannot be used as `command`. | `C:\Users\Username\AppData\Local\Temp\Seer\screenshot\view_1.png` | ### Capability-Specific Placeholders | Placeholder | Preview | Control | Property | | :--- | :--- | :--- | :--- | | `${output_file}` | Base output path; append the target extension, e.g. `${output_file}.html` | Not supported | Base path with no extension; the result must be written to `${output_file}.json` | | `${output_dir}` | Not supported | Not supported | Request directory for attachments (charts, images) | | `${no_cache}` | Disables conversion caching and stores output in the auto-delete directory | Not supported | Not supported | > [!WARNING] > A Control helper receives the target path only. If it needs a scratch location it must resolve one itself: its own executable directory first, then the system temp directory. ### `extensions` Matcher Tokens Beyond standard extensions (e.g. `["png", "zip"]`), `extensions` accepts tokens that match broad categories. These apply to plugins that declare `extensions` (Control and Property); Convert plugins declare `formats` instead and do not use them. | Token | Description | | :--- | :--- | | `${type_folder}` | Matches directories and folders. | | `${type_file}` | Matches all files (including extensionless files). | | `${type_all}` | Matches everything (both files and folders). | | `${type_image}` | Matches images supported by Seer's native image viewer. | | `${type_media}` | Matches audio and video formats. | | `${type_web}` | Matches HTML and Markdown web files. | | `${type_text}` | Matches text, code and config files. | | `${type_pdf}` | Matches PDF documents. | | `${type_none}` | Matches files outside the categories above (e.g. archives, executables). | --- ## Packaging and In-App Testing Once developed, the plugin must be packaged into a standard ZIP archive for installation. This applies to all plugin capabilities. ### Packaging Standards 1. **Package Documentation**: Every standalone Control or Property package should include a `PACKAGE_README.md` (description plus `## Options & Arguments` table), staged as `README.md` at the package root. 2. **Flat Root Layout**: For Control and Property packages (Canonical v1), `plugin.json`, the executable/script, `README.md`, and runtime dependencies must reside directly at the archive root. Do not wrap them inside an extra folder, and never mix flat and nested entries — the host rejects an archive with an ambiguous package root. > Legacy Convert plugins installed from the online catalog use the opposite layout: a top-level `/` folder wrapping the package files. Follow the Convert plugin guide for that case; the two layouts are not interchangeable. 3. **Maximum Compression**: 7-Zip with maximum Deflate compression is recommended: ```powershell 7z a -tzip -mx=9 my-plugin-1.0.0.zip .\* ``` ### Bundling Custom Syntax Highlighting (`syntax/*.xml`) Starting with Seer 4.8.0, any standard Canonical v1 plugin package can bundle custom Kate syntax highlighting definitions: - **Directory Layout**: Place syntax XML files directly inside a `syntax/` subfolder at the package root (i.e. `/syntax/*.xml`). - **Activation**: When the plugin package is installed or enabled, Seer automatically scans this directory, registers the declared file extensions with the native text viewer, and applies syntax highlighting without restarting or recompiling Seer. - **Validation Rules**: - The package must be a valid plugin with a real executable command and declared capabilities (packages containing only `syntax/` without an invocation are rejected at manifest load time). - Each XML file must follow the Kate syntax definition XML format with a `` root element, and must satisfy the following strict validation checks (failing any check will reject package installation): - `kateversion`: Must be explicitly declared and must not exceed `6.30` (strictly locked to KSyntaxHighlighting 6.30.0 in Seer 4.8.0). - `priority`: The `` tag must explicitly declare a positive integer attribute (`priority > 0`). Missing or non-positive values will abort installation. - `extensions`: Must declare matching file patterns (e.g. `*.foo;*.bar`), and wildcards **must not contain whitespace padding** (e.g. `*.foo; *.bar` is rejected; it must be written as `*.foo;*.bar` because the syntax library matches tokens verbatim without trimming). - `name`: Must explicitly declare a non-empty language name attribute. - Maximum file size is **512 KB** (524,288 bytes) per XML file; each package may contribute up to 64 definition files. - **Conflict Resolution**: - **Same Language Name**: If multiple packages or built-in definitions share the same language name, the definition with the higher `version` attribute wins. - **Extension Contention**: If different language definitions claim the same file extension, the one with the higher integer `priority` attribute in `` wins. ### Local In-App Testing 1. Open Seer Settings and navigate to the target section: - Preview Plugins: `Settings > Viewers` -> **Local** tab - Control Plugins: `Settings > Controls` - Property Plugins: `Settings > Properties` 2. Click **+** below the list and select the `.zip` archive (or `plugin.json` from your local folder). 3. Seer automatically validates the package and loads it. Verify the settings and click **Okay** to activate. ## Source: https://1218.io/docs/seer/app-compatibility.html — 3rd Party Compatibility # Third-Party Compatibility & IPC Integration ## Integrate Seer with an AI Agent Replace the placeholder below, then give the complete instruction to your coding agent: ```text Read and follow the Seer SDK IPC integration guide at https://raw.githubusercontent.com/ccseer/Seer-sdk/refs/heads/main/IPC_PROMPT.md (and use the matching raw headers/examples referenced inside it when needed). Treat IPC_PROMPT.md as the source of truth for transports, Win32 commands, JSON-RPC methods/events, security checks, and constraints. If the guide is unavailable, stop and report that before proceeding. Before doing any work, inspect the Requirement below. If it is missing, unchanged placeholder text, or too ambiguous about the target app's language/framework or integration goal, ask one clarifying question and wait. Do not infer the missing requirement. Once clear, implement a complete, runnable Seer IPC integration in the current workspace using the mechanism that fits the requirement (Named Pipe JSON-RPC 2.0, WM_COPYDATA 6000/6001, Dynamic Explorer 4002/4003 + 4000/4001, or legacy WM_COPYDATA 5000-5010). Do not invent undocumented parameters/fields, do not modify Seer itself, and do not stop at a plan or rough snippets. Apply every applicable contract from the guide: for Named Pipe clients, use access 0x0012018B, SECURITY_SQOS_PRESENT | SECURITY_IDENTIFICATION, PIPE_READMODE_MESSAGE, server session/owner SID verification, and FILE_FLAG_OVERLAPPED + a reader thread if subscribing to events; for file-manager Spacebar hooks, register topHwnd dynamically, handle SEER_CORE_READY restarts, and reply synchronously to 4000 -> 4001 within 150 ms; always handle Seer not running, invalid/relative paths, and error responses cleanly. Run the project's available build or verification checks and report actual results; if live Seer runtime testing was not performed, state that explicitly. Requirement: [REPLACE THIS PLACEHOLDER with your target app/language and integration goal, e.g. add Spacebar Quick Look integration to our C++/Win32 file manager, or open/control Seer previews and subscribe to close events from our Python launcher] ``` --- ## Developer Guide > [!TIP] > Ready-to-run examples (C++, Python, C#, Rust, Go, PowerShell, AutoHotkey) and AI integration instructions are available in the [Seer SDK](https://github.com/ccseer/Seer-sdk) repository. Seer supports out-of-process integration with third-party applications, scripts, and custom file managers through: 1. **Named Pipe JSON-RPC 2.0** (`\\.\pipe\Seer.IPC.v2.`) — primary programmatic API for opening/closing/pinning previews, querying session state, registering file manager windows, and subscribing to lifecycle events. 2. **Win32 `WM_COPYDATA`** — dynamic file manager registration (`4002` / `4003` + `4000` / `4001` + `SEER_CORE_READY`), JSON-RPC (`6000` / `6001`), and legacy fire-and-forget commands (`5000`–`5010`). --- ### Named Pipe JSON-RPC 2.0 Integration (Recommended) Connect to `\\.\pipe\Seer.IPC.v2.` (where `` comes from `ProcessIdToSessionId(GetCurrentProcessId(), ...)`), exchange single-line `\n`-delimited UTF-8 JSON-RPC 2.0 frames (no BOM, max `64 KiB`), and switch the client handle to `PIPE_READMODE_MESSAGE`. > [!IMPORTANT] > **Pipe connection & security requirements:** > > - **Access mask**: Request **`0x0012018B`** (`READ_CONTROL | SYNCHRONIZE | FILE_READ_DATA | FILE_READ_EA | FILE_READ_ATTRIBUTES | FILE_WRITE_DATA | FILE_WRITE_ATTRIBUTES`). Do **not** pass `GENERIC_WRITE` — it includes `FILE_CREATE_PIPE_INSTANCE` (`0x4`), which Seer's hardened pipe DACL rejects (`ERROR_ACCESS_DENIED`). > - **SQOS flags**: Pass **`SECURITY_SQOS_PRESENT | SECURITY_IDENTIFICATION`** (`0x00100000 | 0x00010000`) to `CreateFileW`. > - **Server verification**: Immediately verify `GetNamedPipeServerSessionId` matches your session ID and the pipe owner SID (`GetSecurityInfo` `OWNER_SECURITY_INFORMATION`) matches your user SID, `BUILTIN\Administrators`, or `NT AUTHORITY\SYSTEM`. > - **Event subscriptions**: Clients calling `seer.events.subscribe` must also pass `FILE_FLAG_OVERLAPPED` and read on a dedicated background thread so synchronous `ReadFile` does not block `WriteFile`. **Available JSON-RPC methods:** | Method | Params | Summary | | :--- | :--- | :--- | | `seer.getInfo` | `{}` | Returns `protocolVersion`, `appVersion`, `versionInt`, `licensed`, `methods`, `events` (exempt from license/active gate). | | `seer.app.getState` | `{}` | Returns `{licensed, active, tracking, stayOnTop, subWndCount, mainSessionId}` (exempt from license/active gate). | | `seer.viewers.list` | `{includeDisabled?}` | Returns `{viewers: [{name, displayName, priority, internal, disabled, extensions}]}` sorted by priority descending (exempt from license/active gate). | | `seer.preview.open` | `{path, mode?, ifAlreadyOpen?, rect?, fullscreen?, focus?, seekMs?, viewer?}` | Opens preview (`mode`: `"main"` / `"separated"` / `"pinned"` / `"standalone"`; `ifAlreadyOpen` for `main`: `"toggle"` closes an already-open matching window and discards overrides, use `"noop"` to apply overrides; optional `rect` `{x, y, width, height}` in physical pixels clamped to screen work area, `fullscreen` bool, `focus` bool, `seekMs` int `>= 0`, `viewer` type name; `rect`/`focus`/`viewer` rejected on `standalone`). Returns `{sessionId}` or `{closed: true}` (`{}` for `standalone`). | | `seer.preview.close` | `{sessionId?}` | Closes the main window (default) or target separated window (`-32003` if pinned). | | `seer.preview.getState` | `{sessionId?}` | Returns `{sessionId, visible, pinned, path, viewerType, availableViewers, rect?, fullscreen, inspectorVisible, loadState, sourcePath}` (`rect` only present when `visible` is `true`). | | `seer.preview.list` | `{}` | Returns `{sessions: [{sessionId, visible, pinned, path, isMain, viewerType, availableViewers, rect?, fullscreen, inspectorVisible, loadState, sourcePath}]}`. | | `seer.preview.switchViewer` | `{sessionId?, viewer}` | Switches an open preview's viewer in place; returns `{viewer}` (`-32602` on unknown/disabled viewer, `-32004` if invalid state). | | `seer.preview.reload` | `{sessionId?}` | Reloads the active preview (`{reloaded: true}`); returns `-32004` when hidden, unloaded, or not reloadable. | | `seer.preview.separate` | `{sessionId?}` | Opens a separated window for the current preview path; returns `{sessionId}` (`-32004` if invalid state, `-32008` on open failure). | | `seer.preview.closeAllSub` | `{}` | Closes all visible child windows (separated and pinned, excluding main) and returns `{closedCount}`. | | `seer.preview.reveal` | `{sessionId?}` | Reveals the current file in Explorer without changing preview visibility; returns `{revealed: true}` (`-32008` on failure). | | `seer.preview.openDefault` | `{sessionId?}` | Opens the current file with the system default app without changing preview visibility; returns `{opened: true}` (`-32008` on failure). | | `seer.preview.getProperties` | `{sessionId?}` | Returns `{groups: [...]}` containing inspector property groups for the active preview (`-32004` if unavailable). | | `seer.preview.listControls` | `{sessionId?}` | Returns `{sessionId, path, controls: [{id, name, closeAfterSuccess, requiresScreenshot}]}` for enabled Control plugin actions. | | `seer.preview.triggerControl` | `{sessionId?, id}` | Triggers a Control plugin action (`{triggered: true, id, sessionId}`); hides preview + emits `preview.closed` if `closeAfterSuccess` is `true` and launch succeeds. | | `seer.window.pin` | `{sessionId?}` | Pins a visible preview window (always on top). | | `seer.window.waggle` | `{sessionId?}` | Triggers the window waggle animation on a visible preview window (`-32004` if hidden). | | `seer.window.setBounds` | `{sessionId?, rect}` | Applies clamped `{x, y, width, height}` physical pixel bounds to a visible window (restores maximized state without overwriting persistent geometry); returns applied `{rect}`. | | `seer.window.setFullscreen` | `{sessionId?, fullscreen}` | Sets fullscreen state on a visible window; returns `{fullscreen}`. | | `seer.window.setInspector` | `{sessionId?, visible}` | Shows/hides the inspector panel (`{visible}`); `visible: true` requires a loaded valid viewer (`-32004` on `DT_None`/error/resolving), `visible: false` is idempotent on any visible window. | | `seer.explorer.register` / `unregister` / `suspend` | `{topHwnd, name?}` / `{topHwnd}` / `{topHwnd, suspended}` | Dynamically manage caller-owned file manager HWNDs (`topHwnd` is `uint32` in `[1, 0xFFFFFFFF]`, optional `name` <= 128 chars). | | `seer.events.subscribe` / `unsubscribe` | `{events: [...]}` | Named Pipe only. Subscribe to `preview.opened`, `preview.fileChanged`, `preview.loadStateChanged`, `preview.viewerChanged`, `preview.closed`, `window.pinnedChanged`, `app.stateChanged`; returns `{events: [...]}`. | See [seer/ipcv2helper.h](https://github.com/ccseer/Seer-sdk/blob/main/seer/ipcv2helper.h), [examples/cpp_ipc/main.cpp](https://github.com/ccseer/Seer-sdk/blob/main/examples/cpp_ipc/main.cpp), and [examples/python/seer_ipc.py](https://github.com/ccseer/Seer-sdk/blob/main/examples/python/seer_ipc.py) for C++/Python reference clients and helpers. **Error codes & license/active gate:** - **License / active gate**: `seer.preview.*` and `seer.window.*` require an active license (`-32009 LICENSE_EXPIRED` takes precedence over `-32001 NOT_ACTIVE` when both apply). `seer.getInfo`, `seer.app.getState`, `seer.viewers.list`, `seer.explorer.*`, and `seer.events.*` remain available regardless of license or activation state. - **Domain error codes**: `-32001` `NOT_ACTIVE`, `-32002` `SESSION_NOT_FOUND`, `-32003` `SESSION_PINNED`, `-32004` `INVALID_STATE`, `-32005` `TRANSPORT_UNSUPPORTED`, `-32006` `REGISTRATION_REJECTED`, `-32007` `LAUNCH_FAILED`, `-32008` `OPEN_FAILED`, `-32009` `LICENSE_EXPIRED` (plus standard JSON-RPC errors `-32700` / `-32600`–`-32603`). Full schema and session rules are documented in [IPC_PROMPT.md](https://github.com/ccseer/Seer-sdk/blob/main/IPC_PROMPT.md). --- ### Custom File Manager Integration (Spacebar Hook) Custom file managers register their top-level window handles dynamically at runtime so Seer intercepts the Spacebar keypress when that window is in the foreground and requests the currently selected file path. #### Step 1: Register Your Top-Level Window (`4002`) Locate Seer via `FindWindowW(L"SeerWindowClass", nullptr)` and send `WM_COPYDATA` with `dwData = SEER_REGISTER_EXPLORER` (`4002`), fixed 8-byte payload (`ULONGLONG` holding the low 32 bits of your `topHwnd`), and **`wParam` set to a valid `HWND` owned by your process** (`wParam = 0` is always rejected): ```c++ bool registerToSeer(HWND myTopHwnd) { HWND seer = FindWindowW(SEER_CLASS_NAME, nullptr); if (!seer || !myTopHwnd) { return false; } ULONGLONG payload = static_cast(static_cast(reinterpret_cast(myTopHwnd))); COPYDATASTRUCT cds{}; cds.dwData = SEER_REGISTER_EXPLORER; // 4002 cds.cbData = sizeof(payload); // fixed 8 bytes cds.lpData = &payload; DWORD_PTR result = 0; if (!SendMessageTimeoutW(seer, WM_COPYDATA, reinterpret_cast(myTopHwnd), reinterpret_cast(&cds), SMTO_ABORTIFHUNG, 500, &result)) { return false; } return result != 0; } ``` Listen for the `RegisterWindowMessageW(L"SEER_CORE_READY")` broadcast in your window procedure and re-run `registerToSeer(myTopHwnd)` so your integration continues working if Seer starts later or restarts. Optionally send `SEER_UNREGISTER_EXPLORER` (`4003`) before destroying your window. > [!TIP] > If your file manager runs **elevated** while Seer runs non-elevated, allow messages on your top-level window with `ChangeWindowMessageFilterEx` for `WM_COPYDATA` and `RegisterWindowMessageW(L"SEER_CORE_READY")`. #### Step 2: Handle Spacebar Press (`4000` -> `4001`) When the user presses Spacebar inside a registered foreground window, Seer sends `WM_COPYDATA` with `dwData = SEER_REQUEST_PATH` (`4000`), `cbData = 0`, and `lpData = nullptr`. > [!IMPORTANT] > Seer waits **150ms** (`SendMessageTimeout`) for your synchronous `SEER_RESPONSE_PATH` (`4001`) reply before returning from `WM_COPYDATA` handling so the UI never hangs. Respond back to `FindWindowW(SEER_CLASS_NAME, nullptr)` with `dwData = SEER_RESPONSE_PATH` (`4001`) carrying the NUL-terminated UTF-16LE absolute path (`cbData = (wcslen(path) + 1) * sizeof(wchar_t)`). See [examples/cpp_explorer/main.cpp](https://github.com/ccseer/Seer-sdk/blob/main/examples/cpp_explorer/main.cpp) for a complete runnable implementation. --- ### Custom App Trigger (Legacy `WM_COPYDATA`) Existing integrations using one-shot `WM_COPYDATA` preview commands (`5000`–`5010`) continue to work unchanged (see [seer/ipclegacyhelper.h](https://github.com/ccseer/Seer-sdk/blob/main/seer/ipclegacyhelper.h) and [examples/legacy/](https://github.com/ccseer/Seer-sdk/tree/main/examples/legacy)): ```c++ HWND seer = FindWindowW(L"SeerWindowClass", nullptr); if (seer) { COPYDATASTRUCT cd{}; cd.cbData = static_cast((wcslen(path) + 1) * sizeof(wchar_t)); cd.lpData = const_cast(path); cd.dwData = SEER_INVOKE_W32; // 5000 SendMessageW(seer, WM_COPYDATA, 0, reinterpret_cast(&cd)); } ``` --- ### Win32 `WM_COPYDATA` Reference (`SeerCommand`) Defined in [`seer/ipc.h`](https://github.com/ccseer/Seer-sdk/blob/main/seer/ipc.h): | Command Name | Value | Description | | :--- | :--- | :--- | | `SEER_REQUEST_PATH` | `4000` | Sent from Seer to registered custom explorer requesting the selected file path (reply within 150ms). | | `SEER_RESPONSE_PATH` | `4001` | Sent from custom explorer back to Seer containing the selected UTF-16LE absolute path. | | `SEER_REGISTER_EXPLORER` | `4002` | Sent from custom explorer to Seer with 8-byte low-32-bit `topHwnd` and valid caller `wParam` `HWND`. | | `SEER_UNREGISTER_EXPLORER` | `4003` | Sent from custom explorer to Seer to unregister a previously registered `topHwnd`. | | `SEER_INVOKE_W32` | `5000` | Preview in the main window (minimum 200ms interval; legacy `WM_COPYDATA`). | | `SEER_INVOKE_W32_SEP` | `5001` | Preview in a separated window (legacy `WM_COPYDATA`). | | `SEER_IS_VISIBLE` | `5004` | Check if the main preview window is visible (`1` or `0`). | | `SEER_HIDE` | `5005` | Hide the main preview window if visible. | | `SEER_GET_CURRENT_FILE` | `5006` | Write the currently previewed file path into a named shared-memory mapping. | | `SEER_GET_VERSION` | `5007` | Query Seer version integer (`major * 10000 + minor * 100 + patch`, e.g. `40900` for `4.9.0`). | | `SEER_IS_TRACKING_ENABLED` | `5008` | Query if file tracking mode is enabled. | | `SEER_INVOKE_W32_STANDALONE` | `5009` | Preview in a standalone viewer process (`SeerViewer.exe`; legacy `WM_COPYDATA`). | | `SEER_INVOKE_W32_PIN` | `5010` | Preview and pin the window (always on top; legacy `WM_COPYDATA`). | | `SEER_V2_REQUEST` | `6000` | Send a single UTF-8 JSON-RPC 2.0 request (<= 64 KiB, no BOM); `wParam` must be caller's reply `HWND` on the sending thread. | | `SEER_V2_RESPONSE` | `6001` | JSON-RPC 2.0 response sent synchronously by Seer back to `wParam`. | > [!NOTE] > `SeerViewer.exe` (`SeerViewerWindowClass`) handles standalone previews and returns `FALSE` (`0`) for `4002`, `4003`, and `6000`. ## Source: https://1218.io/docs/seer/user-ini.html — Configure user.ini # user.ini Configuration Dictionary ## File Location For non-portable builds, `user.ini` is preferred at `%USERPROFILE%\Documents\Seer\user.ini`; otherwise `%LOCALAPPDATA%\Corey\Seer\user.ini` is used. Portable builds keep it in `\data\`, unless a configuration file already exists next to `Seer.exe`; then that directory is used. Delete a line to restore its default; clear the whole file to regenerate all defaults on next startup. **Version suffixes**: `U` is the Microsoft Store build; `P` is the portable build, and the two are mutually exclusive. `+` is appended after `U` / `P` to indicate elevated privileges, giving `U+` or `P+`. See [Miscellaneous](https://1218.io/docs/seer/misc.html#understanding-version-indicators). ## How to Modify 1. Exit Seer completely. 2. Locate `user.ini` as described above. 3. Edit the value; delete a line to restore its default; clear the whole file to regenerate all defaults. 4. Restart Seer. ## Common Overrides | Goal | Setting | Notes | | :--- | :--- | :--- | | Ignore extensions entirely | `[General] ignored_extensions = exe, msi` | No spacebar preview at all. | | Large-image threshold | `[Image] max_read_size = 268435456` | 256 MiB; the old value `157286400` is migrated automatically. | | Bound decoded-image memory | `[Image] decode_budget_mb = 0` | `0` = automatic, maximum 1024 MB. | | Plain-text fallback threshold | `[Text] view_threshold = 3145728` | 3 MiB. | | Forward Esc from third-party previewers | `[General] enable_esc_key = true` | Off by default. | ## Dictionary: `user.ini` ### `Folder` | Key | Type | Default | Purpose | | :--- | :--- | :--- | :--- | | `exclude` | string | empty string | Remove suffixes from this viewer's built-in table; case-insensitive, comma-separated. | | `extra_support` | string | empty string | Add custom suffixes to this viewer; case-insensitive, comma-separated. | ### `General` | Key | Type | Default | Purpose | | :--- | :--- | :--- | :--- | | `birth` | variant | written at runtime | Runtime metadata: launch time in ISO 8601 format; rewritten on every launch. | | `enable_esc_key` | bool | false | Forward Esc to Seer when a third-party preview handler owns focus. Off by default. | | `ignored_extensions` | string | empty string | Extensions for which the spacebar preview is ignored entirely; case-insensitive, comma or space separated. | | `loading_delay_ms` | int | 200 | Delay threshold in milliseconds before the loading screen appears. Minimum 200. | | `path` | variant | written at runtime | Runtime metadata: absolute path of the user.ini file actually read; rewritten on every launch. | | `temp_file_expire_days` | int | 21 | Temporary files older than this many days are removed on exit. | | `titlebar_hide_separate_btn` | bool | false | Hide the title-bar button that detaches the preview into a standalone window. | | `tray_icon_style` | string | default | Tray icon style: `default`, `dark`, `light`, or `blue`. | | `use_trigger_key_close` | bool | true | Whether the trigger key also closes the window when the preview has focus. | ### `Image` | Key | Type | Default | Purpose | | :--- | :--- | :--- | :--- | | `accelerate` | bool | true | Enable hardware-accelerated image rendering. | | `decode_budget_mb` | int | 0 | Resident memory budget for decoded images in MB; `0` = automatic, maximum 1024. | | `exclude` | string | empty string | Remove suffixes from this viewer's built-in table; case-insensitive, comma-separated. | | `max_read_size` | int | 268435456 | Large-image threshold in bytes; above it only a preview-resolution image is decoded. | | `minimap_scale` | float | 1.0 | Minimap scale factor, range `[0.5, 2.0]`. | | `raw_extra_support` | string | empty string | Add custom RAW suffixes to the image viewer. | | `use_internal_exif_reader` | bool | true | Use the built-in EXIF reader; disable it when an external metadata tool takes over. | | `zoom_step` | float | 1.25 | Image zoom step, range `[1.01, 4.0]`. | ### `Media` | Key | Type | Default | Purpose | | :--- | :--- | :--- | :--- | | `audio_extra_support` | string | empty string | Add suffixes to the media viewer's audio table. | | `audio_remember_playback_pos` | bool | false | Remember audio playback position. | | `decoders` | variant | MFT:d3d=11, D3D11, DXVA, CUDA, hap, FFmpeg, dav1d | Decoder preference order; effective when hardware decoding is enabled in Settings. | | `exclude` | string | empty string | Remove suffixes from this viewer's built-in table; case-insensitive, comma-separated. | | `log` | bool | false | Write the media decoding log to `%TEMP%/Seer/seer_mdk.log`. | | `playback_speed_step` | float | 0.2 | Step size used by the playback speed shortcuts. | | `show_mute_button` | bool | true | Show the mute button in the control bar. | | `show_time_indication` | bool | true | Show remaining or total time in the control bar. | | `video_extra_support` | string | empty string | Add suffixes to the media viewer's video table. | | `video_remember_playback_pos` | bool | false | Remember video playback position. | ### `Others` | Key | Type | Default | Purpose | | :--- | :--- | :--- | :--- | | `ipc_v2_pipe_enabled` | bool | true | Enable the Named Pipe JSON-RPC 2.0 channel (`Seer.IPC.v2`). | ### `PDF` | Key | Type | Default | Purpose | | :--- | :--- | :--- | :--- | | `exclude` | string | empty string | Remove suffixes from this viewer's built-in table; case-insensitive, comma-separated. | | `extra_support` | string | empty string | Add custom suffixes to this viewer; case-insensitive, comma-separated. | | `fit_h` | int | 960 | Default PDF height-fit rendering limit in pixels. | | `fit_w` | int | 960 | Default PDF width-fit rendering limit in pixels. | | `show_sidebar_button` | bool | true | Show the PDF sidebar (outline / thumbnails / annotations) button. | | `show_sidebar_left` | bool | false | Place the PDF sidebar on the left (`true`) or right (`false`). | ### `SystemViewer` | Key | Type | Default | Purpose | | :--- | :--- | :--- | :--- | | `exclude` | string | empty string | Remove suffixes from this viewer's built-in table; case-insensitive, comma-separated. | ### `Text` | Key | Type | Default | Purpose | | :--- | :--- | :--- | :--- | | `custom_font` | string | empty string | Custom monospace font name; the font must be installed locally. | | `exclude` | string | empty string | Remove suffixes from this viewer's built-in table; case-insensitive, comma-separated. | | `extra_support` | string | empty string | Add custom suffixes to this viewer; case-insensitive, comma-separated. | | `line_threshold` | int | 10000 | Maximum characters per line before switching to a lower-overhead rendering path. | | `minimap_scale` | float | 1.0 | Minimap scale factor, range `[0.5, 2.0]`. | | `remember_pos` | bool | true | Restore the previous scroll position. | | `view_threshold` | int | 3145728 | Text size threshold in bytes; larger files switch to plain-text mode. | ### `WebView` | Key | Type | Default | Purpose | | :--- | :--- | :--- | :--- | | `exclude` | string | empty string | Remove suffixes from this viewer's built-in table; case-insensitive, comma-separated. | | `extra_support` | string | empty string | Add custom suffixes to this viewer; case-insensitive, comma-separated. | > `General/path` and `General/birth` are runtime metadata. ## Source: https://1218.io/docs/seer/activation-issues.html — Activation Issues > [!IMPORTANT] > > - License keys for different licensing models are not interchangeable or replaceable. > - Please thoroughly test the software during the free trial period before purchasing. > - Thanks for your support 🙏 ## [Desktop Version](https://www.1218.io/seer/order/) Right-click the Seer icon in your system tray, select `Register`, and paste your license key into the pop-up window. If the length matches, the software will automatically identify the licensing model and activate. Currently, the Desktop version supports one licensing model: ### Device-Based Licensing - **How to Activate**: Paste your license key into the registration window. Once activated, the interface will display your current device binding status (e.g., `1/3`, meaning 1 out of 3 devices is registered). - **Deactivation (Changing Devices)**: - If you need to change computers, upgrade major hardware components (e.g., motherboard, CPU—**must be done prior to the upgrade**), or decommission an old device, please open the `Register` window on the **original computer** and click the `Deactivate` button. - Upon successful deactivation, the server will release that device slot, allowing you to activate on another device. - _Note: Deactivation uses the encrypted device identifiers backed up locally during activation. Thus, even if you make minor hardware adjustments in the meantime, you can still deactivate successfully._ - Due to the **offline design** (activation and deactivation require an active internet connection, but offline use is supported once activated), deactivation must be performed on the original device. ## [Microsoft Store Version](ms-windows-store://pdp/?productid=9PGVFJBVBZWX&cid=doc-1218-website-seer) > [!TIP] Recommend using the Desktop version Due to the running mechanism of Microsoft Store apps, the current known limitations are as follows: 1. "Open/Save" dialogs cannot respond 2. On a small number of PCs due to system settings or other reasons, Seer may fail to save configuration files (currently, this can be resolved by manually moving the configuration file to the Seer folder under Documents) 3. The program may exit automatically when the system wakes up from sleep 4. Updates are released 2 to 7 days later than the Desktop version 5. Unable to replace the executable file 6. I have no control over Microsoft Store licenses. Requests such as deactivation, license cancellation, or removing devices cannot be completed 7. Unable to roll back versions The usage rights of purchased software are bound to your Microsoft account. If you reinstall your system or switch devices, you can redownload and use Seer using the same Microsoft account. Trial, licensing control, payment, and software updates are all managed by the Microsoft Store. ## Source: https://1218.io/docs/seer/misc.html — Misc # Privacy, Versions, and Troubleshooting ## Network Activity Seer establishes network connections only under the following conditions: - **Implicitly:** - **Markdown/HTML Preview:** Requests external resources (images, styles) to render content correctly. - **License Verification:** Occurs **only** during the activation process. No recurring validation requests are made. - **Update Checks:** Initiated once within the first minute of startup. - _Note:_ This can be disabled by unchecking `Automatically check for updates` in Settings. - **Explicitly:** - **Online plugin installation:** Downloads the selected plugin package. - **Online updates:** Downloads the update package when you apply an update. ## Understanding Version Indicators The icon next to the Seer logo indicates the current execution state: - **`U`:** Microsoft Store version. - **`P`:** Portable version. `U` and `P` are mutually exclusive. - **Neither:** Website (Desktop) version. - **`+`:** Administrator privileges. It is appended after `U` / `P`, so `U+` and `P+` are possible. - **No `+`:** Running with standard user privileges. ## Log & Crash Reports To assist with debugging, locate the log and dump files: 1. Press `Win + E` to open File Explorer. 2. Enter `%TEMP%\Seer` in the address bar. 3. Look for `seer.log` (logs). A `.dmp` crash report is generated only by builds without automatic crash reporting; if none exists, send `seer.log` together with the reproduction steps. 4. **Submitting Reports:** Open the `About` window in Seer, click the support email address, and attach these files along with steps to reproduce the issue. ## Restoring the Hidden Tray Icon If you enabled "Hide tray icon" in Settings, you can reopen Settings using either method: - **Method 1:** Preview any file, click the preview window to focus it, and press `Ctrl + ,`. - **Method 2:** Close Seer from Task Manager and relaunch it. The tray icon remains visible for the first 8 seconds after startup, allowing you to right-click and open Settings. ## Customizing Configuration Paths If Seer fails to persist settings due to file permission issues, you can force it to use a specific location: 1. Ensure Seer is **not** running. 2. Navigate to `%USERPROFILE%\Documents`. 3. Create a directory named `Seer`. 4. Inside `Documents\Seer\`, create an empty text file: - **Desktop Version:** Name it `config.ini` - **Store Version:** Name it `uwp.ini` 5. Restart Seer. It will now use this file for all configuration read/write operations. _Tip: Similarly, creating a `user.ini` file under `%USERPROFILE%\Documents\Seer\` will redirect your `user.ini` configuration path there as well._