Settings
File → Settings... (on macOS also Cmd+,). The window has five groups and scrolls on smaller screens. OK saves the changes and applies them immediately; Cancel or Esc discards them.
macOS: If you have several windows open, a change takes effect immediately in the window from which you opened Settings. The other windows pick up the new values the next time the app starts.
Panels and files
| Field | Default | Effect |
|---|---|---|
| Show hidden files | yes | the same as View → Show Hidden Files |
| Refresh local files when entering a folder | yes | when off: going back to a folder on disk you have already visited shows the remembered list (faster, but it may be out of date) |
| Remember the cursor on the folder you leave | yes | after going to the parent folder, the cursor lands on the folder you came from; when off: at the top of the list |
| Left panel default sort | Name, Ascending | column (Name, Size, Modified date, Permissions) and direction |
| Right panel default sort | Name, Ascending | same as above |
| Size unit | Bytes (B) | Bytes (B), Kilobytes (KB) or Megabytes (MB) in the Size column |
Copying and moving
| Field | Default | Effect |
|---|---|---|
| Default button in the conflicts dialog | Skip Duplicates | which button in the File Conflicts dialog Enter selects |
| After copy/move, remove macOS metadata files (._*, .DS_Store) | no | cleans up these files in the destination folders (more) |
Network connections
| Field | Default | Range | Effect |
|---|---|---|---|
| FTP/SFTP timeout | 10 s | 0.1–600 s | how long to wait for a connection to the server |
| FTP/SFTP transfer timeout | 3 s | 0.5–600 s | how long to wait for data during a transfer before the app decides the server is not responding |
| Retry FTP/SFTP on timeout | yes | retries the transfer after a timeout | |
| Retry count | 3 | 0–100 | how many times to retry (available when retrying is on) |
| Verify FTP/SFTP copy integrity | no | verifies each file with a SHA-256 checksum (more) | |
| Fast FTP/SFTP (no upfront conflict scan or date preservation) | no | fast mode | |
| Refresh FTP/SFTP when entering a folder | yes | when off: server folders you have already visited show the remembered list | |
| FTP/SFTP - full details | yes | the conversation with the server in the connecting, preparation, transfer and download windows | |
| Network share connect timeout | 10 s | 1–120 s | macOS: how long to wait for a share to mount from a favorite path |
New timeouts apply to connections made after the change; transfer options also apply to connections that are already open.
Appearance and language
| Field | Default | Effect |
|---|---|---|
| Theme | System | System (follows the system), Light or Dark |
| Font | (system) | the font family for the whole app; "(system)" is the system monospaced font (Menlo on macOS, Consolas on Windows) |
| Font size | 12 px | 8–32 px; empty field = the system default size |
| Row spacing | 4 px | 0–20 px; less = more rows on screen |
| Language | Polski | Polski or English — the same as the Language menu |
After you increase the font size, column headers may not fit — widen the columns by dragging their edges.
File preview
| Field | Default | Effect |
|---|---|---|
| Wrap photo and film browsing (after the last one go back to the first) | no | the arrow keys in the preview go from the last file to the first and vice versa |
| Browse everything viewable with arrows (photos and films together) | no | photos and videos in one sequence instead of separately; takes effect from the next F3 |
App files
Everything the app saves is in the settings folder:
| Path | |
|---|---|
| macOS | ~/Library/Application Support/FlyingFiles/ (in Finder: Go → Go to Folder…, then paste the path) |
| Windows | %APPDATA%\FlyingFiles\ (paste it into the File Explorer address bar) |
| File | Contents |
|---|---|
settings.toml | settings, panel paths, window size, column widths, saved connections (without passwords), favorite paths and terminals |
settings.toml.bak.1 … .bak.5 | previous versions of the settings file |
settings.toml.bak.0 | a one-time copy of the file from before its first save (never overwritten) |
network-mounts.toml | macOS: network share addresses for mounting shares again |
logs/transfers.log | the log of transfers and server conversations (passwords masked); older parts .1–.3 |
Server passwords are stored in the macOS Keychain or in Windows Credential Manager, under the name FlyingFiles FTP.
settings.toml is a plain text file in TOML format. You can read and edit it while the app is closed — the app keeps any keys it does not recognize.
Common tasks
Restoring the default settings
Quit the app and rename settings.toml (e.g. to settings.old.toml). The next time it starts, the app begins with the default settings. Saved connections, favorite paths and terminals are in the same file — with a fresh file they will be gone.
Undoing an unwanted change
Quit the app, copy the backup you want, settings.toml.bak.N, over settings.toml, and start the app.
Moving settings to another computer
Copy settings.toml to the settings folder on the new computer (with the app closed). Connections, favorite paths and terminals come with it, but passwords do not — you enter them the first time you connect to each server. The file works across macOS and Windows, but in that case you need to fix local paths (e.g. in favorite paths).
Turning off the transfer log
The log helps diagnose copying problems and never leaves your computer. If you do not want it, start the app with the environment variable FLYINGFILES_TRANSFER_LOG=0. The FLYINGFILES_TRANSFER_LOG_DIR variable points to a different log folder, and FLYINGFILES_CONFIG_DIR to a different settings folder.
FlyingFiles 1.0.0 · Features added after 1.0.0 are marked in the text.