← All guides

Upload screenshots from iPhone to a remote server

Send an iPhone screenshot to Codex or another image-capable tool on your SSH server: upload over SFTP, insert the remote path, then send your instructions.

Guide 05 · 3 min read · Updated 2026-11-09 · Current release: 1.1.0. Diagrams illustrate the workflow, not app screenshots.

Before you begin

Connect to your own SSH server with SFTP support and a writable directory. Terminal attachments require Pro on iPhone and iPad; Files upload remains free. Your remote tool must separately support reading image files.

  1. Open the right terminal

    Connect to the correct server and open your remote tool or tmux session. Check the server and working directory. Tap the paperclip action labelled Attach image or file.

  2. Choose an upload or editing path

    For an unchanged image, choose Choose photos, Choose files, or Paste image or file in Attach to Terminal. These upload paths do not require editing. If you want to crop or annotate first, choose Edit screenshot before uploading instead, then select your image. Grant access through the system picker.

  3. Review edits before uploading

    For the editing path, crop or mark the problem, remove visible credentials or private messages, then tap Next and confirm the destination before uploading. Skip this step for an unchanged-file upload. See the editing walkthrough. Editing and terminal attachments require mobile Pro.

  4. Review the uploaded reference

    Shinphony uploads over SFTP and inserts a remote file reference without pressing Enter. Add your instructions, such as “Please inspect this screenshot.” The path belongs to the server, not your iPhone. For the free workflow, use Files → More actions → Upload files, then reference the uploaded path manually.

  5. Send when you are ready

    Check that the active terminal is your intended tool, then submit the prompt yourself. Image support depends on that tool and model. At a plain shell prompt, do not execute a file path as though it were a command.

A complete remote workflow

Preview a private development page, send a screenshot to your remote tool, then set up task notifications. Check each guide’s version and Pro requirements.

Get Shinphony for iPhone and iPad ↗

If something gets in the way

The image is still in iCloud

Download it in Photos or Files first, then select it again. Keep Shinphony open until upload finishes.

Permission denied or unexpected destination

Check the destination and use a writable remote folder. The terminal and Files can have different directories. Never loosen production permissions just to make an upload succeed.

The remote tool cannot see the image

Check the exact uploaded path. A tool inside a container or sandbox may not share the SSH host filesystem; place the file in its allowed workspace.

Next guide →Preview a remote localhost website on iPhone over SSH

Still need a hand?

Tell us your platform, app build, and the steps you tried. Never send passwords or private keys.

Contact support