file-remove

file-removeTOOL

Remove a file, or a folder with everything in it, on the iPhone over USB

Refuses /DCIM: a Camera Roll file removed over USB stays in Photos as a broken photo (tested on iOS 18.6). Use photo delete. Files go over USB (AFC), no Developer Mode. Paths start with /. The default root is the iPhone's media folder (/var/mobile/Media): /DCIM Camera Roll: photos, videos, screenshots (IMG_0001.PNG ...). Use the photo commands /Downloads iOS download databases, not the Files app /Books, /PublicStaging, /iTunes_Control, /PhotoData (mostly not readable)

The Files app ("On My iPhone") and app data are not in this folder. --app <bundle id> reaches an app's Documents (/Documents/...), only for apps with [file sharing] in app list.
A file copied to /DCIM does not appear in Photos. To get a photo or video into Photos (for TikTok, Instagram): ghosthand upload <file>, open the link in Safari, tap Save, then Save Video or Save Image (see upload --help). Offline: push it to VLC's Documents (--app org.videolan.vlc-ios), then Files > Share > Save Video. Steps: https://ghosthand.dev/docs/send-media
Works while the iPhone is locked, after its first unlock since boot.

CLI flags in this text are arguments: --app = app

Examples (arguments): {"lease":"studio:42","path":"/Downloads/report.pdf"}

Parameters

app?string

Bundle id of an app with file sharing (see app-list): the path is then in its container, e.g. /Documents/a.pdf

lease *string

Lease id exactly as acquire printed it, e.g. "studio:42"

mac?string

Mac slug from list, e.g. "studio". Needed when several Macs are online

path *string

Absolute iPhone path

Request example

{
  "method": "tools/call",
  "params": {
    "name": "file-remove",
    "arguments": {
      "app": "string",
      "lease": "string",
      "mac": "string",
      "path": "string"
    }
  }
}