New User Tutorial

Before you begin using FileShows, we recommend consulting the Concise Manual to understand the common wildcards, paths, regular expressions, parameter quoting rules, and basic operation procedures applicable to both ft and FileShows.

T1GUI01-Path Matching - Single Path

Home-Description

A. Base Path (Working Directory or File)
1. Select Path; 2. Current Path; 3. Execute Operation.

B. Toolbar Buttons
1. App Center; 2. Preferences; 3. Scheduled Tasks; 4. Open Path.

C. Output Results

T1GUI02-Path Matching - Parameter Settings

Home-Prefs-Filter

Parameter Examples:
--pattern='**.zip' --excludes='/**backups**'
--size_ge=1M
--fileds=ok,action,type,size,time

After configuring the parameters, return to the main interface. The set parameters will be automatically applied to the command line preview. Click the "Execute" button to apply and run the operation.

T1GUI03-Path Matching - Execution Results

Home-Path-List

Output Data:

ft list --pattern='**.zip' --excludes='/**backups**' --size_ge=1M --fileds=ok,action,type,size,time
Ok Action Type Size Modified Path
1 list f 4.6M Aug 01 16:33 ~/Downloads/FileShows-icons-5.zip
1 list f 1.6M Dec 11 2024 ~/Downloads/BOC202411/BOC-2024-11-0.pdf.zip

T1GUI04-Path Matching - Open Path

Home-Path-Launcher

Open file or folder using default app association, supported on desktop platforms.

Simply paste a file or folder path into this input box to open it with the system's default associated application.

T2GUI01-Text Search - Parameter Settings

Perform regular expression searches on the content of already filtered text files.

Home-Prefs-Search

  1. Search Text or Regular Expression
  2. Replacement Text
  3. Mode Options
    reI: Ignore Case;
    reU: Unicode Mode;
    reS: Single-line Mode;
    reM: Multi-line Mode;
  4. Process File Line by Line
    Matches each line of the text file against the regular expression; enabled by default.
    For multi-line matching, the application will read the entire text file as a single string including newlines. Please disable this option.

T2GUI02-Text Search - Execution Results

Home-Path-Search

Output Data (corresponding command line example below):

ft search  --source=~/Downloads --pattern="**.yaml" --excludes="/**/.**" --regexp="version"  --fields=ok,action,type,time,size,extra
Level LineNo LineText Path
i L:3 I:version: 1.0.0 F:~/Downloads/xft/pubspec.yaml
i L:3 I:version: 1.0.0 F:~/Downloads/ft/pubspec.yaml