ghosthand file push

Usage

1ghosthand file push <local file> <iphone path>

Options

Option	Description
`--app [bundle id]`	Use the Documents folder of this app (only apps with file sharing, see app list) instead of the media folder

Also takes the global options.

Details

<iphone path> is the full path of the new file, with its name. MCP: send data (base64, up to about 3 MB) and path (the iPhone destination), never source. 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.

Examples

12$ ghosthand file push -l 42 report.pdf /Downloads/report.pdf
$ ghosthand file push -l 42 movie.mp4 /Documents/movie.mp4 --app org.videolan.vlc-ios

MCP tool

The same command is the MCP tool file-push; flags are arguments.