Skip to content

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

CopyCraft

CopyCraft is a native macOS file transfer utility built for moving large batches of files quickly and safely. It combines a focused four-step workflow with a storage-aware copy engine that adapts its concurrency to the selected destination.

Highlights

  • Native Swift 6, SwiftUI, and AppKit implementation
  • Four-step workflow: files, destination, preferences, and transfer
  • Fast APFS clones with an automatic byte-copy fallback for other file systems
  • Automatic SSD, mechanical HDD, external drive, and network volume detection
  • Storage- and workload-aware concurrency tuned for the selected destination
  • Auto, Sequential, and Fast performance modes
  • Keep Both, Replace Existing, and Skip Existing conflict strategies
  • Optional removal of originals after a successful copy
  • Pause, resume, cancel, retry, and progress reporting
  • Separate navigation history for source and destination pickers
  • App Sandbox support with scoped read/write access
  • Borderless, transparent, rounded macOS window

Storage-aware performance

CopyCraft inspects the destination volume through Disk Arbitration and IOKit when a folder is selected. It then chooses a transfer profile designed for that storage type:

Destination Copy strategy
Solid-state drive Up to 8 parallel copies
Mechanical hard drive 1 stream for large files, 2 streams for large batches of small files
Network volume Up to 2 parallel copies
Unidentified external drive Up to 3 parallel copies
Other or unidentified local volume Up to 4 parallel copies

In Auto mode, CopyCraft combines the detected storage type with the planned file count and average file size. Sequential forces one stream, while Fast uses the highest safe concurrency assigned to the detected drive class. The selected profile and file-system type are displayed in the destination step, and the active stream count appears during transfer.

Actual throughput still depends on file sizes, connection speed, drive condition, and the source and destination hardware.

File-system support

  • APFS: Read/write with clone optimization when supported.
  • Mac OS Extended: Read/write through the standard copy fallback.
  • exFAT: Read/write through the standard copy fallback, suitable for Mac and Windows interoperability.
  • NTFS: macOS can normally read NTFS sources but cannot write to NTFS destinations without a compatible third-party read/write driver.
  • Network volumes: Supported when the mounted destination grants write access.

CopyCraft currently accepts regular files as sources. Source-folder recursion is not yet supported.

Safe transfer behavior

Before copying, CopyCraft validates that every source still exists and is a regular file, confirms that the destination is a writable directory, and removes duplicate source selections. It deliberately does not enumerate or compare every name in the destination folder. Each copy uses an exclusive destination create, and conflict handling runs only when the file system reports that a specific name already exists. This avoids the long up-front directory scan that can make large exFAT folders especially slow on mechanical disks.

When Remove originals after copying is enabled, only files that were copied successfully are removed. Skipped files and files that encounter an error remain at their source location.

For replacement operations, the incoming file is first copied to a temporary file in the destination and then swapped into place. This avoids deleting the existing destination before the replacement copy is ready.

Requirements

  • macOS 26.5 or later
  • Xcode 26.6 or later
  • Swift 6

Build and run

  1. Open CopyCraft.xcodeproj in Xcode.
  2. Select the CopyCraft scheme and the My Mac destination.
  3. Configure a development team if signing is required.
  4. Build and run with ⌘R.

You can also build from Terminal:

xcodebuild \
  -project CopyCraft.xcodeproj \
  -scheme CopyCraft \
  -configuration Debug \
  -destination 'platform=macOS' \
  build

Architecture

CopyCraft/
├── ContentView.swift            Four-step interface and reusable UI components
├── FileTransferViewModel.swift  Transfer planning, state, and copy execution
├── StorageProfiler.swift        Destination volume and physical-media detection
├── FileOperationEnums.swift     Conflict, state, and user-facing error models
└── FileFlowApp.swift            App entry point and borderless window setup

File operations run outside the main actor. UI progress updates are batched so thousands of individual file completions do not overwhelm the main thread.

Privacy and permissions

CopyCraft performs transfers locally and does not upload files or file names. The app uses the macOS App Sandbox and opens security-scoped access only for the files and destination folder selected by the user. Scoped access is closed automatically when the transfer ends.

About

CopyCraft is a native macOS file transfer utility built for moving large batches of files quickly and safely. It combines a focused four-step workflow with a storage-aware copy engine that adapts its concurrency to the selected destination.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages