Skip to content

Locations and mounts

Each Newt pane displays a location supplied by a filesystem backend. A location may be a local directory, a remote machine, an object store, an archive, a disc image, or a set of search results.

The same navigation, viewer, selection, and file-operation commands are used where the backend supports them. Read-only locations disable operations that would modify their contents; see Filesystem capabilities for what each one supports.

Press Mod + Shift + L or use the filesystem selector in the pane header. The selector lists mounted locations first, with a check mark on the current one, then the types you can mount: S3… and SFTP… (each shown only while no filesystem of that type is mounted) and Remote…, which opens the Connect dialog to mount a target in the pane.

The selector also lists mounted volumes, such as USB drives, disk images, and network shares, under the filesystem they belong to, with their free space. Selecting one just opens its folder. Turn off Volumes in VFS Selector under Hot Paths in Settings to hide them. On Windows, filesystems are listed one drive at a time, with labels and mapped or substituted targets where available.

Mounted S3, SFTP, and remote-agent filesystems remain available until you unmount them. Use the × beside a mount in the selector, or highlight it and press Delete; Disconnect VFS in the Command Palette closes the filesystem the active pane shows. Closing a remote-agent mount also ends its connection.

Archives, disc images, compressed files, and search results are temporary and are not listed in the selector. Newt keeps them mounted while either pane’s current location or navigation history still refers to them, then releases them automatically.

On Windows, press F11 to open the system Map Network Drive dialog; a successful mapping opens in the invoking pane. Press literal Alt + F11 on a mapped network drive to confirm and disconnect it. Newt does not force-disconnect a drive with open handles.

Virtual locations have display paths such as s3://bucket/key or sftp://host/path, which are not necessarily paths a shell can use. When a pane is on a location without a native shell path, the terminal keeps its existing working directory.

Opening a terminal from search results uses the directory that was searched. Full remote sessions are different: their terminals run on the session target and ordinary target-local paths work normally.

Local and remote-agent locations refresh as changes occur. S3 and SFTP panes refresh after Newt’s own changes, but changes made outside Newt appear only after you run Refresh File List from the Command Palette (it has no default shortcut, though you can bind one in Settings). See Filesystem capabilities for details.