Help - SageSearch

Introduction

SageSearch helps you find content across large document collections. It supports multiple file formats (TXT/MD/CSV/LOG, PDF, DOC/DOCX, XLS/XLSX, PPT/PPTX, SDLXLIFF/XLIFF/TMX/SDLTM) and lets you preview, highlight, and export results with ease.

Note: Binary .doc and .ppt files are converted with Microsoft Word or PowerPoint when those apps are installed. HTML/RTF exports saved as .doc and binary .xls files are read directly.

Getting Started

Choose a root folder using the folder picker or File → Choose Folder....
Select which file groups to include under Files to Search.
Enter your query in the search box. Use quotes for phrases (e.g. "surface damage"), or enable Exact Match to require the full text.
Click Search or press Enter to view results.

Features

Unicode Search: Works with English, Japanese, and other Unicode scripts.
Exact & Phrase Matching: Toggle exact mode or wrap terms in quotes to restrict matches.
Case Sensitivity: Switch between case-insensitive and case-sensitive searches.
Folder-Aware Tree: The result tree mirrors your folder structure; select a branch to focus your view.
Translation File Segments: Individual segments appear beneath each SDLXLIFF/XLIFF/TMX/SDLTM file, labeled with their segment number (sequential numbering for TMX files; translation unit IDs for SDLTM).
Context Menu Actions: Right-click any file or segment to open it or reveal the containing folder.
Highlight Settings: Customize preview fonts, sizes, snippet length, and highlight colors; settings persist across sessions and carry into HTML exports.
Export: Save results from the status bar buttons as TXT, Markdown, or styled HTML.

Menus & Shortcuts

File → Choose Folder… (Ctrl+O): Pick a new root directory.
File → Rebuild Index (Ctrl+R): Forces a fresh index build using the current settings.
File → Exit (Ctrl+Q): Close the application.
Help → View Help (F1): Open this guide.
About → About SageSearch: View application details.
Tree Context Menu (Right-click): Open files, segments, or their containing folders directly.

Customizing Display

Use the Highlight Settings button next to the search bar to change preview font, size, snippet length (80–800 characters), and highlight color. Preferences are saved automatically and reused for exports. Changing snippet length re-runs the current search so the preview updates immediately.

Search Tips

Quoted phrases require the exact text, including spaces and punctuation.
Exact match mode must match the entire query string in order.
Japanese and other CJK text can be searched using either phrases or individual words.
Results list aggregates by file; the preview panel shows every matching snippet within that file or folder selection.
PowerPoint results (.ppt / .pptx) are listed per matching slide and labeled with the slide number.

Note: When exact mode is off, SageSearch intentionally returns slightly broader matches to avoid missing relevant results. Enable exact mode when you only want documents that contain the full query text.

Help and Support

If you encounter issues or have suggestions, please visit apphaven.net for updates and support resources.