Skip to content
Liuer

Quick Start

First Launch

Section titled “First Launch”

On first launch, the Mac App Store version asks you to choose an index directory — the folder Liuer will index and search. After you pick it, Liuer starts indexing in the background. You’ll see the indexing progress in the bottom bar.

The current index directory is shown at the bottom-right of the status bar. Click it to pick a different index directory and re-index.

Once indexing completes (usually under 2 minutes), you’re ready to search.

File Search Basics

Section titled “File Search Basics”

1. Enter a Search Term

Section titled “1. Enter a Search Term”

Type a filename or keyword in the search bar. Results appear instantly as you type.

2. Use Boolean Conditions

Section titled “2. Use Boolean Conditions”

Toggle between match modes in the left sidebar’s search settings:

  • All Match (always active by default): Files must contain ALL keywords
  • Any Match: Enable via the dropdown menu — files contain ANY keyword
  • Exclude: Enable via the dropdown menu — files must NOT contain specified keywords

Each mode has its own input field for entering multiple keywords.

3. Apply Filters

Section titled “3. Apply Filters”

Narrow results using the filter panel in the left sidebar:

  • Entry Type: Upper section — choose All, Folder, or File
  • File Types: Lower section — filter by category: Video, Audio, Archive, Document, Image, Code, and more
  • Size: Greater than, less than, or a range
  • Date: Modified or created date ranges
  • Path: Limit search to specific directories

4. Sort Results

Section titled “4. Sort Results”

Click any column header (Name, Path, Size, Modified, Created) to sort by that column. Click again to toggle between ascending and descending order.

5. Open Results

Section titled “5. Open Results”
  • Double-click or press Enter to open the file
  • Right-click for context menu (Open, Reveal in Finder, Copy Path, etc.)
  • Press Space for Quick Look preview

Content Search (Pro)

Section titled “Content Search (Pro)”

Content search lets you find text inside files — not just filenames. This is a Pro feature.

1. Switch to Content Search

Section titled “1. Switch to Content Search”

Click the ScanSearch icon at the bottom of the left panel to switch to content search mode.

2. Enter Search Keywords

Section titled “2. Enter Search Keywords”

Type your keywords in the content search area of the left panel. Three toggle buttons beside the input let you enable Case Sensitive, Whole Word, or Regex. Search starts automatically as you type, or press Enter to trigger it immediately.

3. View Matches

Section titled “3. View Matches”

Liuer displays matching files with:

  • Match count per file
  • Individual matches with line numbers
  • Surrounding context for each match

4. Open at Match

Section titled “4. Open at Match”

Click any match to open the file at that exact line in your editor.

Global Shortcut

Section titled “Global Shortcut”

Press ⌥⌘J (Option+Command+J) from anywhere to quickly show or hide the Liuer window.

Next Steps

Section titled “Next Steps”