XFiles
XFiles User guide

XFiles user guide

XFiles is a file manager for iPhone and iPad. It shows the folders on your device and on your servers in one tree, in two panes, and it has an SSH terminal for the servers you reach over SFTP.

This page covers the iPhone and iPad app. You can open it at any time from Settings → User Guide in the app.

Five things worth knowing first

  1. Tap a folder to open it in place, under its row. Tap it again to close it.
  2. Long-press a row to select it and see what you can do with it.
  3. Swipe sideways on iPhone for the second pane. Copy and Move send the selection there.
  4. Add location, the last row of each pane, adds a server or a folder from another app.
  5. In the SSH terminal, Paste takes images and files, not only text. See how.

Browse the tree

Each pane is one tree. Its top level lists your locations: On My Device (XFiles' own storage on this device), the folders you added from other apps, and your network locations.

Two switches in Settings → Browsing change how the tree behaves:

Two panes

XFiles has two panes, so the place you copy from and the place you copy to are both open.

To use a single pane on iPhone, turn off Settings → Browsing → Dual pane on iPhone. Copy and Move then ask where to put the files.

Add servers and folders

Tap Add location, the last row of each pane.

A server or a cloud drive

  1. Choose Network location.
  2. Tap Protocol and pick one: SFTP (SSH), FTP, FTPS, WebDAV, Nextcloud, SMB / NAS, S3 Object Storage, HTTP Directory, Google Drive, Dropbox, OneDrive, Jellyfin or Emby.
  3. Fill in the address and sign-in details, then tap Save.

The location appears at the top level of both panes. Its address and password stay on this device.

To change or remove one, open Settings → Network locations. Tap ⓘ to edit it. Swipe left to delete it; this removes it at once and does not touch the files on the server.

A folder from this device or another app

Choose Local folder and pick a folder in the system picker: a folder in iCloud Drive, on a USB drive, or one that another app shares. It shows up at the top level with a Pinned badge. To remove it from XFiles, go to Settings → Pinned folders, swipe left on it and tap Unpin. The folder itself is not deleted.

Select, copy, move, delete

Long-press a row. This selects it and opens its menu. For a file that is Preview, Select, Copy to…, Move to…, Share…, Rename… and Delete. Long-press more rows to add them to the selection. The bottom toolbar then shows how many are selected, with Copy, Move, Share and Delete; ✕ clears the selection.

Copy or move

Unless you pick another rule, a file whose name is already taken is kept beside the existing one, as name (1).ext.

A chip above the toolbar shows the progress, and you can keep browsing meanwhile. Tap the chip for the details or to cancel. If iOS pauses a long copy while XFiles is in the background, the chip reads Paused — tap to resume; it continues from where it stopped.

Delete and share

Delete acts at once. XFiles does not ask again and has no trash, so a deleted file cannot be brought back from the app.

Share hands files to another app through the system share sheet. A file on a server is downloaded first. Folders cannot be shared.

New items, rename, search

With nothing selected, the bottom toolbar has:

Rename… is in the long-press menu of a file or folder. On a network location's top row it renames the saved location.

Open and edit files

FileWhat you get
Text and codeA text view. Tap Edit, change it, tap Save. Edit shows only where the folder can be written to.
MarkdownPreview or Source. In Preview, tap a task box to tick it; the change is saved to the file.
JSON, JSON LinesTree or Source. Tap an item to fold it or to see its path; Copy Value and Copy Path are at the bottom.
Session logs of Claude Code and Codex (.jsonl)Chat shows the session as a conversation, with the tool calls. Tree and Source show the raw log.
ImagesFull screen. Pinch to zoom; tap to hide or show the close button.
Video and audioPlays in the system player.
PDF and other documentsThe system preview.
ArchivesZIP, 7z, RAR, TAR, GZ, BZ2 and XZ open as folders. Copy out the files you need. You cannot copy into an archive.

Other apps and the Files app

SSH terminal Pro

Every SFTP location has a terminal on the same server.

Open it

The buttons at the top

✕ (left)Close the terminal.
PaperclipAttach a photo or a file. See the next section.
Input Bar (a box with a pencil)Switch the input bar on or off.
Reconnect (a round arrow)Connect again.

The buttons fade after a moment so they do not cover the screen. Double-tap the top of the screen to bring them back.

The key row above the keyboard

Swipe the row sideways for two more pages: symbols, then F1 to F12 with ins, del, pgup and pgdn. An iPad, or an iPhone in landscape, shows two pages side by side.

On the screen

Input bar: type a whole line first

Tap the Input Bar button. You then type in an ordinary text field, where you can move the cursor and correct what you wrote, and tap Send to run it. It suits long commands, prompts for a coding agent, and Chinese, Japanese or Korean input.

Draft: write long text and keep it

Long-press the terminal and tap Draft. Write as much as you like and tap Insert: the text is typed at the cursor without pressing Return. History keeps the drafts you inserted; pin the ones you use often.

When the connection drops

XFiles reconnects by itself after a lost signal or when you come back to the app. After you type exit it stays closed until you tap Reconnect. A plain shell starts over after a reconnect; to keep your programs running, see Keep terminal sessions running.

Paste images and files into the terminal Pro

A terminal only takes text, so XFiles does the rest: it uploads the image or file to the server and types its path where your cursor is. A command, or a coding agent running in the terminal, can then read the file from that path.

Paste

  1. Copy an image or a file anywhere on the device: a screenshot, a photo in Photos, a file in Files.
  2. In the terminal, long-press the screen and tap Paste. With the input bar on, long-press in the bar and tap Paste.
  3. A chip at the top shows the upload. Then the path appears, in quotes, at the cursor.

Or pick one

Tap the paperclip at the top (the + key in the input bar when it is on) and choose:

What happens to the file

For example, type cp , paste a photo, then type the destination:

cp '/tmp/xfiles-3f9a…-IMG_2041.jpg' ~/site/images/

Most servers clear /tmp from time to time. Move a file you want to keep.

Keep terminal sessions running Pro

iOS closes an SSH connection soon after you leave an app, and whatever runs in a plain shell stops with it. A terminal multiplexer on the server (tmux, Zellij or Herdr) keeps it running, and XFiles reattaches to it each time it connects.

Turn it on in Settings → Network locations → ⓘ → Keep sessions running. That screen checks what is installed on your server and shows the install command. The full walk-through is on its own page: Keep terminal sessions running.

Port forward Pro

A port forward lets this device open a service that only the server can reach, such as an admin page on your NAS or a dev server on localhost.

  1. Long-press the SFTP location and tap Port Forward, then +.
  2. Enter the Remote host as the server sees it (leave it empty for the server itself) and the Remote port. Tap Save.
  3. Switch the forward on. Tap its row to Copy Address or to Open it in the in-app browser.

The address is 127.0.0.1 and a port on this device. Safari and other apps can use it while XFiles stays open.

Free and Pro

Open Settings → Upgrade to XFiles Pro to see the plans. Restore Purchases is on the same screen, for a new device or after reinstalling.

Get help

Tap Settings → Send Feedback to tell us what you think in a short form; no mail app needed. Contact Support writes an email that already carries your app and iOS versions. You can also write to nearby@local1st.app.