Chapter 5: Power Tools & Automation¶

In high-volume file management, basic file manipulation—copying, moving, and deleting individual items—is only the beginning. Professional engineers, system administrators, content creators, and data analysts frequently encounter complex operational challenges: restructuring thousands of inconsistently named digital assets, isolating subtle code regressions between parallel release branches, maintaining synchronized mirrors across network storage arrays, locating deeply buried configuration files, and cryptographically verifying file integrity.

ATBCmder transforms these labor-intensive tasks into swift, deterministic operations. Instead of requiring external command-line scripts, third-party batch utilities, or clunky standalone diff applications, ATBCmder integrates a comprehensive automation suite directly into its orthodox dual-panel core. Whether you need to execute regular expression substitutions across an entire photo archive, perform a two-way directory synchronization with content-level hashing, or feed multi-filter search results into a virtual workspace, ATBCmder provides the tools you need with complete keyboard efficiency.

1. Visual Quickstart: The Automation Engine & Command Matrix¶

ATBCmder divides power tools and automation into six specialized functional domains that interact seamlessly with the dual-panel interface:

┌────────────────────────────────────────────────────────────────────────────────────────┐
│                                DUAL FILE PANELS                                        │
│     Left Panel (Source / Directory A)        Right Panel (Target / Directory B)        │
├────────────────────────────────────────────────────────────────────────────────────────┤
│                                          │                                             │
│  [1] Batch Multi-Rename (Ctrl+M)         │  [2] Side-by-Side File Diff (Meta+Shift+F12)│
│      Tokens, RegEx, Counters, Preview    │      Line highlights, Hunk sync, In-place   │
│                                          │                                             │
│  [3] Directory Sync (Shift+F12)          │  [4] Advanced Search (Alt+F7)               │
│      Content/Date compare, Asym mirror   │      Spotlight / Deep scan ➔ Feed to Listbox│
│                                          │                                             │
│  [5] Semantic Command Bar (/)            │  [6] File Utilities & Security              │
│      Spotlight queries, AI intent, NLP   │      Split/Link, Checksum, Wipe (Alt+Del)   │
│                                          │                                             │
├────────────────────────────────────────────────────────────────────────────────────────┤
│  [Feed to Listbox] ➔ Populates virtual panel tab for bulk operations across directories│
└────────────────────────────────────────────────────────────────────────────────────────┘

Dual-Matrix Automation Cheat Sheet¶

2. Batch Multi-Rename Tool (Ctrl+M / ⌃M / cm_MultiRename)¶

Renaming dozens or hundreds of files manually is tedious and error-prone. The Batch Multi-Rename Tool (cm_MultiRename, mapped to fmultirename.pas in the classic architecture) allows you to define flexible naming patterns, apply dynamic sequence counters, perform case conversions, and execute powerful Regular Expression (RegEx) find-and-replace rules with real-time visual safety guarantees.

Figure 5.1: The Batch Multi-Rename Tool featuring live preview rows, token masks, numeric counter parameters, and duplicate detection.

2.1 The Multi-Rename Workflow¶

1. Select Files: In the active file panel, select the files or directories you wish to rename using Space, Insert, or wildcard selection (+). If nothing is selected, the item under the cursor is used.
2. Launch Tool: Press Ctrl+M (⌃M) or choose Files ➔ Multi-Rename Tool... from the menu bar.
3. Configure Templates & Rules: Enter filename/extension masks, set counter options, or define find-and-replace strings.
4. Inspect Live Preview: The 3-column table (Old Name, New Name, Directory) updates instantly on every keystroke.
5. Execute: Click Start Rename (or press Enter). ATBCmder performs the renames atomically and refreshes the file panels.

2.2 Template Tokens & Range Slicing¶

ATBCmder uses intuitive bracketed tokens to reference parts of the original file metadata:

Character Range Slicing ([Na-b] / [Ea-b])¶

You can extract specific character ranges from the original name or extension using 1-based index slicing:

• [N1-4]: Extracts the first 4 characters of the name. For Document_Final.txt, this yields Docu.
• [N5-]: Extracts from the 5^th character to the end of the name. For DSC_0982.jpg, this yields 0982.
• [N-5]: Extracts up to the 5^th character.
• [E1-2]: Extracts the first 2 characters of the extension. For archive.html, this yields ht.

2.3 Counter Controls & Numeric Sequences¶

The Counter Settings group allows granular control over numeric indexing:

• Start At: The starting integer for the counter sequence (default: 1).
• Step: The increment value added for each subsequent file (default: 1). Setting Step to 2 generates 1, 3, 5, 7....
• Digits: The zero-padding width (range: 1 to 10). Setting Digits to 3 formats numbers as 001, 002, 003. Setting Digits to 1 disables leading zeros (1, 2, 3).

2.4 Find & Replace and Regular Expressions¶

The Find & Replace group enables text replacements across all selected items:

• Find: Target substring or regular expression pattern.
• Replace with: Replacement string. When RegEx is enabled, backreferences ($1, $2 or \1, \2) refer to capture groups.
• Use Regular Expressions (Regex): Toggles Python standard library regular expression parsing.
• Case Sensitive: When unchecked, matching ignores character casing (e.g., matching both .JPG and .jpg).

Powerful RegEx Substitution Examples¶

Example 1: Strip unwanted tracking or release tags from filenames
Input File:      Album_Artist_-_Track_01_[Lossless_24bit_96kHz].flac
Find Pattern:    \s*\[.*?\]
Replace with:    (leave empty)
Output File:     Album_Artist_-_Track_01.flac

Example 2: Reorder dates from YYYY-MM-DD to DD-MM-YYYY
Input File:      Invoice_2026-09-06_Acme.pdf
Find Pattern:    (\d{4})-(\d{2})-(\d{2})
Replace with:    $3-$2-$1
Output File:     Invoice_06-09-2026_Acme.pdf

Example 3: Convert spaces and underscores to standardized hyphens
Input File:      my new blog post_draft.md
Find Pattern:    [ _]+
Replace with:    -
Output File:     my-new-blog-post-draft.md

2.5 Case Conversion Modes¶

ATBCmder provides instant casing normalization without requiring complex patterns:

• No change: Preserves original capitalization.
• lowercase: Converts the entire filename and extension to lowercase (PHOTO_001.JPG ➔ photo_001.jpg).
• UPPERCASE: Converts all characters to uppercase (readme.txt ➔ README.TXT).
• First letter uppercase: Capitalizes the initial character of each word (war and peace.epub ➔ War And Peace.epub).

2.6 Live Preview Grid & Collision Protection¶

Renaming hundreds of files without previewing can result in disastrous data overwrites. ATBCmder implements a Zero-Accident Safety Architecture:

1. Instant Debounced Preview: As you type into template inputs or adjust spin boxes, the table immediately calculates the resulting filenames.
2. Duplicate Target Detection: ATBCmder scans all computed output filenames within the destination folder. If two or more files would resolve to the exact same name, or if a filename resolves to an empty string:
3. The colliding rows are immediately highlighted in prominent red (#FFEBEB / #D70000 in light mode, #4A1515 / #FF8080 in dark mode).
4. The Start Rename button is automatically disabled.
5. A tooltip warns: "Name collisions detected. Please resolve duplicates before renaming."
6. Collision Clearance: Once you adjust your counter, template, or regex to make all target filenames unique, the warning clears and the Start Rename button re-enables.

2.7 Practical Step-by-Step Recipes¶

Recipe A: Renaming Digital Camera Photos with Timestamps¶

Transform cryptic camera names (IMG_4092.JPG, IMG_4093.JPG) into chronologically organized assets:

1. Select the photo files and press Ctrl+M.
2. Set File Name Template to: Photo_[Y][M][D]_[C].
3. Set Extension Template to: [E].
4. Set Digits to 3, Start At to 1.
5. Set Case Conversion to lowercase.
6. Preview the result: photo_20260906_001.jpg, photo_20260906_002.jpg.
7. Press Enter to apply.

Recipe B: Adding a Prefix While Preserving Name and Extension¶

Prefix a batch of documents with a project code:

1. Select documents and press Ctrl+M.
2. In File Name Template, enter: PRJ-ALPHA_[N].
3. Leave Extension Template as [E].
4. Click Start Rename.

3. Side-by-Side Visual File Diff (Meta+Shift+F12 / ⌘⇧F12 / cm_FileDiff)¶

Detecting differences between configuration revisions, source code files, or data dumps is a daily task for power users. ATBCmder includes a built-in, side-by-side Visual File Diff Viewer (DiffViewerDialog) that eliminates the need to launch heavyweight external tools.

┌────────────────────────────────────────────────────────────────────────────────────────┐
│  Side-by-side Diff: config.py (Left)  vs.  config.py.new (Right)                       │
├────────────────────────────────────────────────────────────────────────────────────────┤
│ [💾 Save Left] [💾 Save Right] | [Copy to Right →] [← Copy to Left] | [Prev] [Next]    │
│ [🔄 Re-compare] | [✔] Ignore whitespace  [ ] Ignore case  [ ] Ignore blank lines       │
├─────────────────────────────────────────────┬──────────────────────────────────────────┤
│ config.py (Left)                            │ config.py.new (Right)                    │
├─────────────────────────────────────────────┼──────────────────────────────────────────┤
│ 12: DEBUG = False                           │ 12: DEBUG = False                        │
│ 13: LOG_LEVEL = "INFO"                      │ 13: LOG_LEVEL = "DEBUG"      [CHANGED]   │
│ 14: PORT = 8080                             │ 14: PORT = 8080                          │
│ 15: # Deprecated database setting           │ 15:                                      │
│ 16: DB_TIMEOUT = 30              [REMOVED]  │ 16: DB_TIMEOUT = 10          [CHANGED]   │
│ 17:                                         │ 17: SSL_ENABLED = True       [ADDED]     │
├─────────────────────────────────────────────┴──────────────────────────────────────────┤
│  Difference 2 of 4  │  Ln 16, Col 1 (Left)  │  Ln 16, Col 1 (Right)                    │
└────────────────────────────────────────────────────────────────────────────────────────┘

3.1 Launching File Diff¶

• Compare Two Selected Files: In a single panel, select exactly two files and press Meta+Shift+F12 (⌘⇧F12) or choose Commands ➔ Compare by Content....
• Compare Opposing Files: Highlight a file in the Left Panel, highlight the corresponding file in the Right Panel, and trigger cm_CompareContents.
• Supported Commands: cm_CompareContents, cm_FileDiff, and cm_CompareByContent all route to the side-by-side comparison engine.

3.2 Visual Difference Highlighting & Color Codes¶

The diff engine parses text line by line using an optimized Hunt-Szymanski LCS algorithm (TextDiffer), dividing differences into color-coded hunks:

Each pane features a dedicated left gutter (LineNumberArea) displaying 1-based line numbers synchronized with diff positions.

3.3 Synchronized Scrolling & Reentrancy Safety¶

When comparing long source files containing thousands of lines, navigating through code requires lockstep coordination:

• Scrolling the vertical or horizontal scrollbar of either editor instantly adjusts the opposing editor by the identical pixel offset.
• ATBCmder implements an internal reentrancy lock (_syncing_vscroll, _syncing_hscroll) preventing event feedback loops, stuttering, or cursor drift.

3.4 Hunk Navigation & Bidirectional Merging¶

You can navigate through differences without using the mouse:

• Next Difference: Press Alt+Down / ⌥↓ (or Ctrl+Down).
• Previous Difference: Press Alt+Up / ⌥↑ (or Ctrl+Up).
• Jump to Hunk: Clicking directly on any highlighted line in either pane automatically sets that hunk as active.

Bidirectional Merging (Vimdiff dp / do Compatibility)¶

Merge differences between files with single keystrokes:

• Copy Left to Right (→): Press Alt+Right / ⌥→ (or Ctrl+Alt+Right or Vimdiff dp via Alt+P). The active hunk in the Left editor replaces the corresponding section in the Right editor.
• Copy Right to Left (←): Press Alt+Left / ⌥← (or Ctrl+Alt+Left or Vimdiff do via Alt+O). The active hunk in the Right editor replaces the corresponding section in the Left editor.

3.5 In-Place Editing & Atomic Saving¶

Unlike diff viewers that treat text as read-only, both panes in ATBCmder are fully functional code editors:

• Type, paste, or delete text directly within either editor.
• Whenever manual edits alter lines, press F5 (or Ctrl+R) to re-run the difference calculation on the updated buffers.
• Save Left File: Click 💾 Save Left (or press Cmd+S / Ctrl+S while the Left editor has focus).
• Save Right File: Click 💾 Save Right (or press Cmd+S / Ctrl+S while the Right editor has focus).

3.6 Comparison Filtering Options¶

The diff viewer toolbar allows you to isolate genuine logic changes from formatting noise:

• Ignore Whitespace (_cb_ws): Ignores changes in tabs, trailing spaces, and spaces-vs-tabs indentation.
• Ignore Case (_cb_case): Performs case-insensitive character comparisons.
• Ignore Blank Lines (_cb_blank): Collapses empty line additions and deletions, focusing strictly on substantive code changes.

3.7 Binary File Diff Detection¶

If either file selected for comparison contains null bytes or binary MIME signatures (e.g. images, executables, compiled archives), ATBCmder automatically invokes BinaryDiffer:

• Displays file sizes and cryptographic SHA-256 hashes side by side.
• Clearly states whether the binary files are byte-identical or divergent.

4. Directory Synchronization (Shift+F12 / ⇧F12 / cm_SyncDirs)¶

Keeping directory trees synchronized across local disks, backup drives, and network storage is a cornerstone of reliable systems. ATBCmder’s Directory Synchronizer (SyncDirsDialog, mapped to fsyncdirsdlg.pas) compares entire folder hierarchies, determines exact directional operations, and previews every file copy and deletion before touching your storage.

Figure 5.2: Directory Synchronization dialog displaying recursive comparison status, directional sync arrows, and asymmetric mirror controls.

4.1 Launching Directory Sync¶

1. Open the Source directory in the Left Panel and the Destination directory in the Right Panel.
2. Press Shift+F12 (⇧F12) or choose Commands ➔ Synchronize Dirs....
3. The Synchronize Directories dialog appears with both paths pre-populated in the header cards.

4.2 Comparison Methods & Precision¶

Before synchronizing, configure your comparison criteria in the Synchronize Settings card:

4.3 Directional Analysis & Status Indicators¶

Click Compare to launch a non-blocking background comparison worker (SyncCompareWorker). The comparison table populates with color-coded directional rows:

┌────────────────────────────────────────────────────────────────────────────────────────┐
│ Relative Path             │ Operation │ Reason            │ Details                    │
├───────────────────────────┼───────────┼───────────────────┼────────────────────────────┤
│ assets/banner.png         │    ->     │ Left is newer     │ 2026-09-06 > 2026-08-15    │
│ docs/manual.pdf           │    ->     │ Right missing     │ File exists only on left   │
│ config/settings.json      │    <-     │ Right is newer    │ 2026-09-06 > 2026-09-01    │
│ vendor/legacy_lib.so      │    <-     │ Left missing      │ File exists only on right  │
│ build/cache.db            │    !=     │ Conflict          │ Timestamp / type mismatch  │
└────────────────────────────────────────────────────────────────────────────────────────┘

• -> (Left to Right): The file on the Left is newer, or exists only on the Left. Default action: copy to Right.
• <- (Right to Left): The file on the Right is newer, or exists only on the Right. Default action: copy to Left (in two-way mode).
• = (Equal): Files match in size and timestamp/content. Filtered out of the active sync list to save time.
• != (Conflict): Incompatible directory-vs-file collision or unresolvable timestamp conflict. Skipped during automated bulk sync for data safety.

4.4 Asymmetric Mirroring vs. Two-Way Symmetric Sync¶

ATBCmder supports two fundamentally different synchronization philosophies:

1. Two-Way Symmetric Synchronization (Default)¶

• Goal: Bring both directories into alignment so both have the latest versions of every file.
• Action: Files marked -> are copied Left ➔ Right. Files marked <- are copied Right ➔ Left.
• Safety: No files are deleted on either side.

2. Asymmetric Mirroring (Asymmetric Checkbox Enabled)¶

• Goal: Make the Right directory an exact, identical replica of the Left directory.
• Action: Files marked -> are copied Left ➔ Right. Files on the Right that do not exist on the Left (<- Right missing on Left) are permanently removed from the Right directory.
• Use Case: Creating pristine backup mirrors on external backup disks or NAS shares.

4.5 Pre-Execution Safety & Audit Logging¶

• Inspect Before Sync: Review the populated table carefully. You can see exact relative paths and the operational reasons for every transfer.
• Stop Control: If a large comparison or synchronization job needs to be aborted, click Stop. The background thread terminates safely without leaving corrupted partial files.
• Automated Audit Log: Every copy, overwrite, and deletion executed during synchronization is recorded in ATBCmder's internal Operations Log (LogCategory.COPY_MOVE_LINK, LogCategory.DELETE).

5. Advanced File Search & Feed to Listbox (Alt+F7 / ⌥F7 / cm_Search)¶

Locating specific files across nested folder structures is a common administrative bottleneck. ATBCmder provides a high-performance Advanced File Search Dialog (SearchDialog, mapped to fFindDlg.pas), combining native macOS Spotlight indexing with a deep filesystem scanning engine and the indispensable Feed to Listbox capability.

Figure 5.3: Advanced File Search dialog with multi-filter parameters, deep scan controls, and the Feed to Listbox button.

5.1 Launching Search¶

• Press Alt+F7 (⌥F7) in any panel, or choose Commands ➔ Search Files....
• The search dialog opens with the Search in directory field pre-filled with the active panel’s current path.

5.2 Dual Search Backends: Spotlight vs. Deep Scan¶

ATBCmder features two specialized search worker engines:

                  ┌───────────────────────────────────────────────┐
                  │          Search Query Triggered               │
                  └───────────────────────┬───────────────────────┘
                                          │
                  ┌───────────────────────┴───────────────────────┐
                  ▼                                               ▼
    ┌───────────────────────────┐                   ┌───────────────────────────┐
    │  Spotlight Engine         │                   │  Deep Scan Engine         │
    │  (SpotlightSearchWorker)  │                   │  (DeepScanWorker)         │
    ├───────────────────────────┤                   ├───────────────────────────┤
    │ • Uses macOS mdfind       │                   │ • Recursive os.scandir    │
    │ • Millisecond results     │                   │ • Scans unindexed drives  │
    │ • APFS metadata indexed   │                   │ • Network shares (SMB/NFS)│
    │ • Standard local storage  │                   │ • Raw text/regex parsing  │
    └───────────────────────────┘                   └───────────────────────────┘

1. Spotlight Search Engine (SpotlightSearchWorker): On macOS, clicking Start Search (or pressing Enter) utilizes the system’s Spotlight metadata index (mdfind). It retrieves thousands of matching paths across gigabytes of storage in a fraction of a second.
2. Deep Scan Engine (DeepScanWorker): Clicking Deep Scan bypasses system indexing and performs a direct, recursive filesystem traversal. This is essential when searching:
3. External USB drives or SD cards that have Spotlight indexing disabled.
4. Remote network file shares (SMB, SFTP, FTP, WebDAV).
5. Developer build directories excluded via .metadata_never_index.

5.3 Multi-Filter Search Criteria¶

Fine-tune search queries using granular parameters across the General and Advanced Filters groups:

• File Names Pattern:
• Wildcards: Standard shell wildcards such as *.py, invoice_2026_*.pdf, or test_??.go.
• Substrings: Entering draft finds any file or folder containing "draft".
• Regular Expressions: Check Regular Expression to enable full regex syntax (e.g. ^v\d+\.\d+\.(json|xml)$).
• Search for Text (In-File Search):
• Searches for UTF-8 and ASCII string content inside text, source code, and document files.
• Check Case sensitive content search for exact case matches.
• File Size Range:
• Set Min size and Max size in kilobytes (KB). Setting Max size to 0 leaves upper bounds unlimited.
• Date Range:
• Specify Modified within last N days (e.g., 7 days to find work from the past week).

5.4 Quick Inspection in Search Results¶

While browsing search results in the results list:

• View File (F3): Instantly opens the highlighted search result in the Universal Lister.
• Edit File (F4): Opens the file directly in the built-in Text Editor.
• Go to File (Enter / Go to File): Closes the search dialog, navigates the main panel to the file's parent directory, and places the cursor directly on the file.

5.5 The Power of "Feed to Listbox"¶

The most transformative feature of orthodox file managers is Feed to Listbox:

┌────────────────────────────────────────────────────────────────────────────────────────┐
│ SEARCH RESULTS (Flat Virtual Panel Tab)             OPPOSING PANEL (Destination)       │
│ [Search: *.log modified < 30 days]                 /Volumes/ArchiveStorage/Logs        │
├──────────────────────────────────────────────┬───┬─────────────────────────────────────┤
│  Name                         Size   Folder  │   │  Name                        Size   │
│  ▸ [..]                              --:--   │   │  ▸ [..]                             │
│  ✔ app_server.log            14 MB   /var/log│ C │  ▸ archive_2025             <DIR>   │
│  ✔ auth_audit.log             2 MB   /etc/sec│ O │                                     │
│  ✔ worker_3.log              88 KB   /opt/app│ P │                                     │
│  ● access.log               512 KB   /var/log│ Y │                                     │
├──────────────────────────────────────────────┴───┴─────────────────────────────────────┤
│  [3 items selected] ➔ Press F5 to copy all matching files into destination folder!     │
└────────────────────────────────────────────────────────────────────────────────────────┘

1. In the Search Dialog, once matching files are found, click the Feed to listbox button.
2. ATBCmder closes the dialog and opens a new virtual search results tab in the active panel.
3. Rather than navigating to each folder individually, all matching files from different directory depths appear in a single, flat table.
4. Execute Any Commander Action:
5. Select all or specific items (Space, +, Cmd+A).
6. Copy (F5) or Move (F6) matching files across diverse folders into a single destination folder in the opposing panel.
7. Batch Multi-Rename (Ctrl+M) all matching search results simultaneously.
8. Securely Delete (F8 or Alt+Delete) unwanted temporary files across an entire project hierarchy in one stroke.

6. Spotlight Integration & Semantic Command System (/ & Ctrl+Shift+F)¶

Modern workflows require agile querying beyond rigid filter dialogs. ATBCmder integrates macOS Spotlight indexing directly with a Natural Language Semantic Command System accessible from the embedded command bar at the bottom of the main window.

Figure 5.4: The Semantic Command Bar parsing a natural language query with live auto-completion templates.

Figure 5.5: Semantic Search results displayed directly inside the active panel.

6.1 Activating Semantic Commands¶

• Press /: In the active file panel, simply press the slash key (/). ATBCmder immediately focuses the bottom command edit bar, pre-populating it with /.
• Spotlight Search Shortcut: Press Ctrl+Shift+F (⌃⇧F) or Cmd+Shift+F to open the semantic filter interface.
• Dismiss: Press Escape to clear the filter and restore the standard directory listing.

6.2 Scopes: Local (/) vs. Global (//)¶

ATBCmder differentiates between folder-level filtering and system-wide discovery using prefix conventions:

1. Local Directory Scope (/<query>)¶

Queries starting with a single slash operate exclusively on the directory open in the active panel (and its subfolders if recursive options are specified):

• /larger than 10MB: Shows only files larger than 10 Megabytes in the current folder.
• /> 50MB: Numeric shorthand for size filtering.
• /today modified pdf: Filters for PDF documents modified within the last 24 hours.
• /images: Displays only raster and vector image formats.
• /source code: Shows Python, C++, Rust, Go, JavaScript, and other source files.
• /contains "API_KEY": Filters for text files containing the string "API_KEY".
• /hide *.log: Hides log files from the active display.

2. Global System Scope (//<query>)¶

Queries starting with a double slash query the entire macOS system volume via Spotlight:

• //today modified pdf: Finds all PDF documents modified today across your entire Mac.
• //larger than 1GB dmg: Locates all disk image installers exceeding 1 GB.
• //code contains "OAuth2Handler": Finds all source files system-wide containing "OAuth2Handler".

6.3 AI-Assisted Semantic Queries (? or /?)¶

When configured with an AI provider (Google Gemini, OpenAI, Anthropic Claude, or local Ollama) in Preferences ➔ Semantic Filter:

• Prefixing a query with ? or /? routes the natural language instruction through an LLM parser.
• Example: /? find all final invoices sent to client Acme last quarter over $5000
• The AI translates complex human phrasing into precise Spotlight metadata attributes (kMDItemFSSize, kMDItemContentModificationDate, kMDItemTextContent), displaying matching files instantly in the panel.

6.4 Auto-Completion, Catalog (/help), and History (/history)¶

As you type into the semantic command edit box:

• Interactive Completion Popup: A dropdown menu (SemanticCompletionPopup) displays contextual template suggestions based on the built-in catalog (semantic-command-templates.xml). Use Down and Up arrows to highlight suggestions and press Tab or Enter to accept.
• Help Catalog (/help): Typing /help opens the Semantic Command Help Dialog, listing dozens of searchable examples across categories (Size, Date, File Type, Content, Tagging). Double-clicking any entry inserts it into the command line.
• Command History (/history): Typing /history displays a chronological log of all previously executed semantic commands with execution timestamps, allowing instant recall.

6.5 Instant Panel Action Modifiers¶

The semantic command bar can also manipulate panel selections and sorting without touching the mouse:

7. Essential File Utilities & Data Integrity¶

Beyond search and batch renaming, ATBCmder integrates a suite of essential system utilities designed to manage large files, audit security, and verify cryptographic integrity.

7.1 Large File Splitter (cm_FileSpliter / cm_Split / Alt+F6)¶

When transferring massive disk images, video archives, or virtual machine containers across storage devices with filesystem size limits (such as FAT32’s 4 GB boundary) or email attachment limits, the File Splitter (SplitWorker) divides files into numbered sequential segments:

1. Select the large file in the active panel.
2. Choose Files ➔ Split File... (or trigger cm_Split).
3. Choose the destination directory (defaults to the opposing panel).
4. Select a standard chunk size preset or enter a custom byte size:
5. 1.44 MB: Legacy 3.5" Floppy disk.
6. 700 MB: Standard CD-R capacity.
7. 4.7 GB: Single-layer DVD-R capacity.
8. 100 MB: Standard upload chunk.
9. Custom Size: User-defined byte, KB, MB, or GB threshold.
10. Click OK. ATBCmder splits the source file in a background worker thread, creating .001, .002, .003... sequence files.

7.2 File Linker & Combiner (cm_FileLinker / cm_Combine / Alt+F7)¶

Reassembling split file chunks into the original intact file is seamless:

1. In the file panel, highlight the first split part (must end with extension .001).
2. Choose Files ➔ Combine Files... (or trigger cm_Combine).
3. ATBCmder automatically detects all sequential parts (.001, .002, .003... up to .999).
4. Select the output filename and target directory.
5. Click OK. The background worker (CombineWorker) sequentially concatenates the parts back into an exact byte-for-byte binary replica.

7.3 Cryptographic Checksums & Verification (cm_CheckSumCalc, cm_CheckSumVerify)¶

Verifying that downloaded files, disk images, or archive backups have not been corrupted or tampered with is vital for data integrity. ATBCmder includes a built-in Checksum Calculator and Verifier (ChecksumDialog).

┌────────────────────────────────────────────────────────────────────────────────────────┐
│ Checksum Calculator                                                                    │
├────────────────────────────────────────────────────────────────────────────────────────┤
│ Hash Algorithm: [ SHA256           ▾]                                                  │
├────────────────────────────────────────────────────────────────────────────────────────┤
│ 3a491d90bc1f42013149db82a890471b67823f40d12e8424e6a00a120894fe83  arch_linux.iso       │
│ 8f14e45fceea167a5a36dedd4bea25431846b9a898492efd727402c3ef30b65a  rootfs.tar.gz        │
│ e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855  empty_manifest.txt   │
├────────────────────────────────────────────────────────────────────────────────────────┤
│  [Progress: 100%] Hashing completed.                                                   │
│  [Calculate]    [Stop]    [💾 Save to File]                                 [Close]    │
└────────────────────────────────────────────────────────────────────────────────────────┘

Calculating Hashes (cm_CheckSumCalc / Ctrl+X)¶

1. Select one or more files in the panel.
2. Choose Files ➔ Calculate Checksum... (or press Ctrl+X).
3. Select your desired algorithm: MD5, SHA1, SHA256, or SHA512.
4. Click Calculate. The worker streams files through 64 KB chunks in the background without locking the interface.
5. Click Save to File to export the hashes into a standard .sha256 or .md5 manifest file.

Verifying Checksum Manifests (cm_CheckSumVerify)¶

1. Choose Files ➔ Verify Checksums....
2. Select an existing checksum file (.sha256, .md5, .sha1, .sha512, or .sfv).
3. ATBCmder automatically parses the manifest, locates corresponding files in the same directory, recalculates hashes on disk, and presents a color-coded status report:
4. OK: File matches checksum perfectly.
5. FAILED: Data corruption or modification detected!
6. MISSING: Referenced file not found in directory.

7.4 Secure File Shredding / Wipe (cm_Wipe / Alt+Delete / ⌥⌫)¶

Standard file deletion merely unlinks directory entries, leaving raw data blocks intact on disk where recovery utilities can extract them. When handling confidential keys, credentials, or proprietary source code, use Secure Delete / Wipe (cm_Wipe):

1. Select the confidential files or directories.
2. Press Alt+Delete (⌥⌫) or choose File ➔ Secure Delete (Wipe)....
3. Confirm the security alert prompt.
4. The Cryptographic Multi-Pass Shredding Sequence (wipe_path):
5. Pass 1: Overwrites the entire file byte length with cryptographically secure pseudo-random bytes (os.urandom).
6. Pass 2: Overwrites the entire file with null zero bytes (\x00).
7. Pass 3: Overwrites with fresh random bytes.
8. Hardware Sync: Calls os.fsync() on the underlying file descriptor to force the operating system and storage controller cache to write data to physical media.
9. Truncation & Unlink: Truncates the file to 0 bytes before calling os.unlink().
10. Directory Scrubbing: Recursively wipes all contained files before unlinking parent directories.

7.5 Embedded System Terminal (Ctrl+J / ⌃J / cm_RunTerm)¶

While ATBCmder excels at graphical dual-panel workflows, shell access is often required for compilation, git branches, or server management:

• Press Ctrl+J (⌃J) or choose Commands ➔ Run Terminal.
• ATBCmder immediately opens macOS Terminal.app (or your configured default terminal emulator) with its working directory initialized to the exact path open in the active panel.
• No typing cd /Users/... or dragging folders into terminal windows required.

8. ⚡ Pro Tips & Deep Dive Automation Workflows¶

8.1 Recipe: Recursive Search ➔ Feed to Listbox ➔ Multi-Rename¶

Objective: Strip version numbers from hundreds of asset files scattered across 50 nested subfolders.

1. Open the project root in the Left Panel.
2. Press Alt+F7 to open Search.
3. In File names pattern, enter: *_v[0-9]*.png.
4. Click Start Search. Once matching assets appear, click Feed to listbox.
5. In the resulting virtual panel tab, select all files with Cmd+A.
6. Press Ctrl+M to launch the Multi-Rename Tool.
7. In Find, enter: _v\d+. Enable Use Regular Expressions (Regex).
8. Leave Replace with empty.
9. Verify the live preview table shows clean filenames without version suffixes.
10. Click Start Rename. ATBCmder renames every file across all 50 subfolders instantly!

8.2 Recipe: Safe Cloud & NAS Backup Mirroring with Asymmetric Sync¶

Objective: Maintain an identical offsite mirror of your documents on an external SSD or SMB NAS drive without duplicate files accumulating.

1. Open local ~/Documents in the Left Panel.
2. Open /Volumes/BackupSSD/Documents in the Right Panel.
3. Press Shift+F12 (cm_SyncDirs).
4. In Settings, ensure Compare Subdirectories is checked.
5. Check Asymmetric (Delete target if missing in source).
6. Click Compare.
7. Review the list:
8. Blue/Green arrows (->) indicate files that will be copied to the backup.
9. Red deletions (<-) indicate outdated files on the backup disk that you have since deleted locally.
10. Click Synchronize. Your backup drive is now a mirror of your local folder.

8.3 Recipe: Forensic Hash Manifests Before Long-Term Archive Storage¶

Objective: Calculate and store cryptographic checksums for a multi-terabyte project before moving it to cold tape or cloud glacier storage.

1. Navigate to the directory containing your project deliverables.
2. Select all items (Cmd+A) and press Ctrl+X (cm_CheckSumCalc).
3. Set Algorithm to SHA256.
4. Click Calculate. The streaming hash worker processes the files in the background.
5. Click Save to File and name it MANIFEST-SHA256.txt.
6. Whenever you retrieve the files years later, simply select MANIFEST-SHA256.txt and run Verify Checksums to guarantee zero bit rot or silent corruption.

8.4 Recipe: Combining Natural Language Semantic Filtering with Flat Branch View (Cmd+B)¶

Objective: Find and organize all media files across a complex deep directory structure without opening search dialogs.

1. Highlight your top-level project folder and press Cmd+B (cm_FlatView) to flatten all subfolder contents into a single list.
2. Press / to focus the Semantic Command Bar.
3. Type: /images larger than 5MB.
4. The flattened list instantly isolates high-resolution images across every nested directory.
5. Press /select all visible, then press F5 to copy them all into an organized target directory in the opposite panel.
6. Press Cmd+B again to restore normal hierarchical tree browsing.

9. Safety, Performance & System Alerts¶

10. Master Dual-Matrix Keyboard Reference Table¶