Help

Import your sessions

Wayfinder reads the sessions other apps saved, in their folders. It shows everything that would come in before it writes anything, and says what it leaves out and why.

Hosts in your own ~/.ssh/config need no import: they are in the sidebar from the first launch.

How

1. Choose File › Import Sessions… in the menu bar, or use the arrow on the + beside the sidebar's search field.
2. Pick the file another app exported, or several. A folder works too.
3. Look over the list, and choose where the sessions go: the sidebar, a new group, or a group you have.
4. Click Import.

What to export from each app

MobaXterm

In MobaXterm, right-click User sessions and export all sessions to a file, which ends in .mxtsessions. Or take MobaXterm.ini: beside the program in the portable version, in %APPDATA%\MobaXterm in the installed one. Folders come along as they are.

PuTTY

On Windows, PuTTY keeps its sessions in the registry. Export them in a Command Prompt, then copy putty.reg to your Mac:

reg export HKCU\Software\SimonTatham\PuTTY\Sessions putty.reg

On Linux or a Mac, choose the folder ~/.putty/sessions. The file chooser shows hidden folders, so ~/.putty is there.

FileZilla

Choose sitemanager.xml, which is in ~/.config/filezilla on a Mac or Linux and in %APPDATA%\FileZilla on Windows. A file from File › Export in FileZilla works too. SFTP and FTP sites become storage, and so do S3 and WebDAV sites.

WinSCP

Choose WinSCP.ini, from a portable WinSCP or from Tools › Export/Backup Configuration. If WinSCP keeps its settings in the registry, export them instead:

reg export "HKCU\Software\Martin Prikryl\WinSCP 2\Sessions" winscp.reg

Cyberduck

Choose the bookmark files, which end in .duck. Dragging bookmarks from Cyberduck to the Finder makes them.

An ssh_config file

Any ssh_config file, such as one a colleague shares. Each named host comes in with what applies to it, defaults under Host * included. Patterns are not hosts and are left out.

What comes along

• SSH sessions become hosts, with their user, port, jump hosts and key.
• SFTP, FTP, S3, WebDAV and SMB sessions become storage, next to your hosts.
• Telnet, serial, Remote Desktop and VNC sessions become connections in the same groups.
• Folders from MobaXterm, FileZilla and WinSCP stay folders.
• Nothing is added twice. A session with the same address, user and port as one already in Wayfinder is left as it is.
• Names that cannot be host names, such as one with spaces, get dashes instead. The import window shows the old name beside the new one.

What stays behind

• Passwords. Those apps keep them encoded, not protected, so Wayfinder does not read them. An SSH or SFTP password is asked for when you connect, and kept in your Keychain if you tick Remember. An FTP password or an S3 secret key goes in the connection's Edit window.
• PuTTY keys (.ppk), which OpenSSH cannot read. Convert one once with PuTTY's puttygen (on a Mac, brew install putty), then pick it in the host's Edit window:

  puttygen key.ppk -O private-openssh -o ~/.ssh/key

• Keys that are not on this Mac. A session that named a key Wayfinder cannot find in ~/.ssh logs in with your usual keys until you pick one.
• Windows COM ports. A serial console asks for this Mac's port the first time it opens.
• Kinds Wayfinder does not open, such as XDMCP, Mosh or WSL sessions, are listed with the reason.

Royal TSX, Termius and other apps

Wayfinder does not read Royal TSX, Termius or SecureCRT files yet. If those hosts are also in an ssh_config file, import that. And tell us at support@versaminds.live which app you are coming from: it helps us choose the next importer.

Next: Jump hosts