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
- Tap a folder to open it in place, under its row. Tap it again to close it.
- Long-press a row to select it and see what you can do with it.
- Swipe sideways on iPhone for the second pane. Copy and Move send the selection there.
- Add location, the last row of each pane, adds a server or a folder from another app.
- 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.
- Tap a folder to open it under its row. Tap it again to close it. An archive such as a ZIP opens the same way.
- Tap a file to open it.
- The pill at the top shows where you are. Tap any part of the path to jump back to that folder.
- Refresh in the bottom toolbar reloads the folder you are in.
Two switches in Settings → Browsing change how the tree behaves:
- Show hidden files shows names that start with a dot.
- One folder per level closes the folders beside the one you open, so the tree stays short. It is on at first. Turn it off to keep several folders open side by side.
Two panes
XFiles has two panes, so the place you copy from and the place you copy to are both open.
- On iPad the panes sit side by side. Tap in a pane to work in it.
- On iPhone the second pane is one swipe to the side. The chip at the top names the folder open in the other pane; tap it to switch.
- With something selected, Copy and Move in the toolbar send it straight to the folder open in the other pane. If that folder cannot be written to, the buttons are dimmed.
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
- Choose Network location.
- 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.
- 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
- To the other pane: open the destination folder in the other pane, select the files, and tap Copy or Move in the toolbar.
- To any folder: choose Copy to… or Move to… from the long-press menu. Tap through Places to the folder and tap Choose. The same sheet has When a file already exists: Skip existing, Overwrite or Keep both.
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:
- New Folder and New File, created in the folder you are in. A new text file opens in the editor.
- Search, which finds file and folder names under the folder you are in, including its subfolders. Type at least two characters. Tap a result to go to it.
- Refresh.
- More, with Settings and Open Folder (the same as Add location → Local folder).
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
| File | What you get |
|---|---|
| Text and code | A text view. Tap Edit, change it, tap Save. Edit shows only where the folder can be written to. |
| Markdown | Preview or Source. In Preview, tap a task box to tick it; the change is saved to the file. |
| JSON, JSON Lines | Tree 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. |
| Images | Full screen. Pinch to zoom; tap to hide or show the close button. |
| Video and audio | Plays in the system player. |
| PDF and other documents | The system preview. |
| Archives | ZIP, 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
- Save something into XFiles: in another app, tap Share and choose XFiles. The item is saved in On My Device.
- Reach your servers from other apps: XFiles is a location in the Files app. Inside it are On My Device, your pinned folders and the network locations that can be written to. In any app's Save or Open dialog, choose XFiles and then a folder inside it. If XFiles is not listed in Files, turn it on in Files' list of locations.
SSH terminal Pro
Every SFTP location has a terminal on the same server.
Open it
- Long-press the SFTP location, or anything inside it, and tap Open Terminal.
- Or open Settings → Network locations and tap the SFTP location.
The buttons at the top
| ✕ (left) | Close the terminal. |
| Paperclip | Attach 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
- ctrl, alt and ⇧ (Shift) apply to the next key: tap ctrl, then c, for Ctrl-C. Tap ⇧, then tab, for Shift-Tab; ⇧ before an arrow sends Shift and that arrow.
- Long-press alt for a new line without sending the command.
- Hold an arrow, pgup or pgdn to repeat it.
- ✋ decides what a swipe does in a full-screen program such as vim or tmux: scroll that program like a mouse wheel, or select text on the screen.
- ⌨ swaps the keyboard for a panel of symbols (
[ ] { } < > & # $and more). Tap it again to go back. - To change the keys, open Settings → Terminal Key Bar. Tap a key to change or remove it, touch and hold one to move it, and add or delete pages.
On the screen
- Drag to scroll back through earlier output.
- Pinch to make the text smaller or larger. XFiles remembers the size.
- Long-press to select text, then tap Copy. Double-tap selects a word.
- The same long-press menu has Paste and Draft.
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.
- Return starts a new line in the bar. Send sends the text and presses Return.
- With the bar empty, Send presses Return on its own, and Backspace deletes on the server's line.
- The keys on the key row still go to the server, so ctrl c, the arrows and tab work as before.
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
- Copy an image or a file anywhere on the device: a screenshot, a photo in Photos, a file in Files.
- In the terminal, long-press the screen and tap Paste. With the input bar on, long-press in the bar and tap Paste.
- 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:
- Photo Library: up to ten photos at a time. XFiles does not need access to your whole library.
- Choose Files: any files the Files app can reach.
- Paste from Clipboard: shown when the clipboard holds an image or a file.
What happens to the file
- It is uploaded over the same SFTP connection to
/tmpon the server, asxfiles-…-name, readable only by your account. If/tmpcannot be used, it goes to your home folder. - Each file can be up to 32 MB.
- Nothing is run for you. The path is typed and waits for you to press Return or to write a command around it.
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.
- Long-press the SFTP location and tap Port Forward, then +.
- Enter the Remote host as the server sees it (leave it empty for the server itself) and the Remote port. Tap Save.
- 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
- Free: everything on this device, and three saved network locations of any kind.
- XFiles Pro: unlimited network locations, the SSH terminal and port forwarding.
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.