StructorDocs
Main workspace Reversible

Control what Structor touches

Every folder keeps independent sync, organization, indexing, duplicate, and image settings. Folder rows expose fast actions; the expanded workspace provides Explore, Settings, and Activity views.

Structor · Folder details
Expanded Structor folder with Explore Settings and Activity tabs
Expand a folder to inspect its current tree, configure organization and AI helpers, or review reversible sync history.

Folder list

Connected or paused

The status dot and Sync switch show whether Structor is actively watching that folder. Turning Sync off preserves its settings.

Search folders

The folder search filters by displayed folder name or path. It does not search files inside those folders.

Organize now

Forces a run immediately instead of waiting for the configured interval and drains eligible pending files.

Remove from list

Stops tracking and removes the folder record. Files and folders already on disk stay in place.

Expanded folder views

TabUse it for
ExploreBrowse current files and folders, see size/count summaries, reveal paths, and watch live organization progress
SettingsSet schedule, tracking scope, exclusions, organization depth, indexing helpers, and image compression
ActivityReview recent sync batches, revert one or all visible batches, and inspect created subfolders

Sync and tracking scope

  1. 01

    Choose an interval

    Use Never for manual organization, or select a schedule from every 5 minutes through every 2 months. Scheduled runs occur only while the folder is synced and Structor has active access.
  2. 02

    Choose root or nested tracking

    Keep Subfolders on to include nested directories. Turn it off when only files directly inside the selected root should participate.
  3. 03

    Skip sensitive or noisy folders

    Open Skipped folders, choose nested directories, and save. Excluded paths stay untouched by organization and indexing.

Folder organization

The Folder Organization switch controls whether Structor moves files. Turning it off leaves Sync available for other folder features, but organization becomes manual/off for file movement.

DepthClassificationExample
BasicFile typeDownloads/invoice.pdf → AI/Documents/invoice.pdf
DetailedType and purposeDownloads/invoice.pdf → AI/Documents/Invoices/invoice.pdf
AdvancedType, purpose, and detailDownloads/invoice.pdf → AI/Documents/Invoices/2026/invoice.pdf

During a run, the folder row reports phase, percentage, current detail, and moved count. Explore refreshes after completion.

AI helpers and indexing

Semantic search

Queues eligible files for text and visual indexing so the Search screen can match concepts rather than filenames alone.

Duplicate cleanup

Uses exact fingerprints plus text and visual similarity to build reviewable duplicate groups.

Image compression

Compresses supported images after they move into the organized tree and records original metadata for reverts.

Backup retention

Keeps original images in managed backup storage for 1 week through 1 year. Open backups in Finder reveals that storage. See Image optimization and backups before enabling it on irreplaceable photos.

Index status

When Semantic search or Duplicate cleanup is enabled, the helper panel reports:

  • Indexed: files currently available to search and duplicate analysis.
  • Queued: files waiting for processing.
  • Active: files being processed now.
  • Failed: files that could not be indexed.
  • Last error: latest indexing failure, when available.

Use Reindex after large external moves, edits, model replacement, or when index counts look stale.

Activity and reverts

Only sync batches that moved files appear under Recent syncs. Each row shows its time, moved count, and an example destination.

  • Revert moves files from one sync back to their recorded previous paths.
  • Revert all reverses every sync currently listed.
  • Revert latest sync in the folder action menu targets the newest batch.
  • Created subfolders lists directories Structor created and can reveal them in the file manager.
Structor documentation