README.md

remote-edit for atom.io

Atom package to browse and edit remote files using FTP and SFTP.

Key features

• Add FTP/SFTP hosts graphically (FTPS not supported at the moment)
• Supports password, key and agent authentication
• Browse files through a select list
• Automatically upload file on save
• Multi-window support (ie. server settings and downloaded files are serialized and accessible across multiple Atom windows)

Security concerns

• By default, all information is stored in cleartext to disk. This includes passwords and passphrases.
• Passwords and passphrases can alternatively be stored in the systems default keychain by enabling it in the settings page for remote-edit. This is achieved using node-keytar and might not work on all systems.

Keyboard shortcuts

Shift+e Edit hosts. Usable when selecting hosts (Browse).

Shift+d Delete hosts or downloaded files. Usable when selecting hosts (Browse) or open files (Show open files).

Windows / Linux specific

Ctrl+Alt+b Select host.

Ctrl+Alt+o Show downloaded files.

Mac OS X specific

Ctrl+Cmd+b Select host.

Ctrl+Cmd+o Show downloaded files

Tips and tricks

SSH auth with password fails

On some sshd configuration (Mac OS X Mavericks), if PasswordAuthentication is not explicitly set to yes, ssh server will not allow non-interactive password authentication. See this issue for more in-depth information.

Agent authentication when using SSH

The package uses ssh2 to connect to ssh servers, and also use the default construct in this package to authenticate with an agent. On Windows, the agent will be set to "pageant", otherwise it assumes a \ix system and uses "process.env['SSH_AUTH_SOCK']" to get the agent. This can be overridden in the settings.

Screenshot

Available commands

Add a new FTP host

Add a new SFTP host

Edit existing host

Select host

Browse host

Show downloaded files

Settings window