General

General

Launcher

Determines if the Launcher window is displayed when starting Nova with no projects open, or after closing all open projects.

You can also choose if you would like projects to be automatically added to the project list when opened or created. You can also disable the animated effects displayed in the Launcher.

Privacy

Determines whether or not crash reports and/or anonymous usage data are sent to Panic. Read a clear, simple explanation of exactly what is sent – and why – on our website.

Software Updates

Nova has built-in automatic software updates.

By default, updates will be downloaded in the background while you work, as they become available. You will be prompted to relaunch Nova when an update is ready to be installed.

If automatic updates are disabled, Nova will not check unless you manually click the Check for Updates button.

You can also choose whether to be alerted to new updates once your included year of updates has expired.

Extensions

Extensions
Allow Nova to automatically update extensions to the latest version available in the Extension Gallery.
Extension Development
Show or Hide items in the Extensions menu intended for extension developers.
Account
Sign into your Nova Developer account to publish Extensions to the Extension Library

Git Accounts

Git Accounts

Nova supports adding accounts from Git service providers, including GitHub, GitHub Enterprise, GitLab.com, and self-hosted GitLab instances. To add an account, click the button in the lower left and select the service for the account you want to add.

Depending on the service, you may be prompted to login to your account directly, or provide an access token you can use to authenticate. Once the account is set up, you can set a description for the account, configure whether to clone repos using HTTPS or SSH, and specify which key to use if cloning over SSH.


Behaviors

Behaviors

Behaviors allow Nova to respond to certain events by performing one or more actions, such as playing a sound, displaying a notification, showing a specific Sidebar, or running a script. Actions can be triggered by a number of events, for example:

  • A build starts, generates issues, succeeds, or fails.
  • A Run Task starts, generates output, generates issues, completes, or exits unexpectedly.
  • Publishing starts, succeeds, or fails.

To change a behavior, choose it from the list on the left, then configure the options on the right as desired. A checkmark appears next to items in the list that have behaviors associated with them.


Workspace

Workspace

Manage customized sidebar layout configurations and set the default layout for new windows. New sidebar layouts can be created from the View menu.

Increase/decrease the size of the icons displayed in the Sidebar Dock

Default Spilt Direction

Choose whether new splits are created below or to the right of the currently active view

Documents

Open documents with single-click (transient)
After opening a document from the Files sidebar with a single click, it will only stay open until another file is selected. Documents that are modified or opened via double click will remain open in the editor.
Open an empty editor for new windows
When enabled, Nova will automatically display a new document in the editor when a new window is opened.
Automatically save changes when closing documents
Automatically saves changes to a document when it is closed in the editor.
Automatically save changes when invoking tasks
Automatically saves changes to a document when a task is initiated.

Markdown Stylesheet

Choose a bright, dark, or custom theme to apply to Nova’s markdown preview.


Theme

Theme

Select the desired theme for Nova’s Windows and Editor. You can install more themes from the Nova Extension Gallery.

Optionally, you can select different themes to be applied to Nova when your Mac switches between Light and Dark system appearances. You can choose whether to use a contrasting appearance for Command Palettes, which will make Command Palettes use a dark appearance with light themes (and vice versa). You can also select between different Dock icons.


Key Bindings

Customize any of Nova’s keyboard shortcuts here.

Choose Manage Key Bindings… from the Key Bindings Set pop-up menu to add or remove additional sets of key binding configurations.

Extensions may also add sets of key bindings. Choose the desired set from the Key Bindings Set pop-up menu.

Key Bindings

Tools

Tools

Nova has an optional command line tool that can be installed for performing specific operations via a local terminal.

Automatically request environment from login shell
Ensures that enviroment variables from your login shell are availible when using Build & Run tasks within Nova.

You can also view existing environment variables detected by Nova, or set custom global values to be used in conjunction with Build & Run tasks.

See Environment Variables for details about how Nova sources environment variables made available to extensions and tasks.


Files

Files

Files Sidebar

When the navigation controls are enabled, the Files sidebar will show path, back, and forward buttons for navigation and double-clicking on a folder will navigate into it instead of expanding the directory in tree view.

View Options

Configure Nova’s Files Sidebar and File Browsers.

Show hidden files
Show hidden files, such as dot files.
Show ignored files
Show ignored files, as defined by the Ignored Files section at the bottom of the preferences pane.
Show folders above files
Displays all folders at the top of the browser before listing files. If unchecked, folders and files are intermingled.
Use Finder icons
Display the actual Finder icon for each file, rather than a built-in Nova icon. If enabled, this may incur a slight speed penalty when reading file listings from disk.

Files Sidebar Item Size

Choose small, medium, or large icons for the Files sidebar, or use the behavior set in System Preferences > General.

Drag & Drop

Choose whether dragging a file from the Files Sidebar opens the file in a new tab or split view, or whether it inserts the file path into the document you drag it into. Holding the Option key while dragging will perform the opposite action of the one selected here.

Find & Replace

Enable or disable Nova’s access to the macOS global find pasteboard. If checked, enables Nova to pre-fill the find field with text that you have copied from another application. Some users prefer to turn this off due to privacy or security concerns.

Source Control

Enable or disable Nova’s built-in support for Git version control. Useful if you want to prevent conflicts with outside version control tools, or simply don’t use Nova’s Git integration.

Ignored files

A list of patterns to be matched against files and folder names. Matched files will be ignored by find and indexing operations. By default, this list contains a few well-known hidden or ephemeral file types that generally serve no purpose being displayed in Nova’s file browser. You can create your own list as desired.

Ignore files excluded by Git
If checked, Nova will also ignore files as specified by .gitignore files in your projects.

Editor

Editing

Editing
Insertion Point
Choose what type of insertion point is displayed in the editor: Vertical Bar, Block, or Underline. You can also opt to disable blinking the insertion point.
Show
Show or hide various parts of the editor UI or source code adornments.
Status View
Configure when the editor status view overlay is displayed or hidden.
Font
Select the font used in Nova’s editor.
Line Height
Set the line height used in Nova’s editor.
Letter Spacing
Increase or decrease the space between characters in the editor.
Editor Overscroll
The amount of additional space to add to the end of a document’s scroll area beyond its last line.
Default Text Encoding
The default text encoding to use for new documents created in Nova’s editor.
Default Line Endings
The default line endings to use in new documents created in Nova’s editor. You can also choose to show an alert upon opening a file if it contains inconsistent line endings.
EditorConfig
Enables the use of .editorconfig files to automatically set indentation style, line endings, and more.
Preview
Enables preview tabs to detect when you’ve stopped typing in a document and automatically reload to reflect the changes made.

Syntax

Default Syntax
The default syntax mode to use for new documents.
Custom File Types
If your projects use a custom file extension, you can map it to a specific syntax mode here.
Syntax

Identifiers

Select prefix when double-clicking variables
Some programming languages prefix variable names with a special character, such as a dollar sign. If this setting is enabled, double clicking a variable to select it will include this prefix in the selection. Otherwise, the prefix will be excluded.
Highlight instances of symbol at cursor
When enabled, Nova will highlight other occurrences of the symbol at the insertion point that are within the current scope.

Completions

Suggest completions while typing
Enable or disable Nova’s autocompletion functionality.
Accept completions with:
Select whether to use the Return or Tab keys to confirm a completion.
Suggest clips while typing
Enable or disable autocompletion for Clips.

Brackets & Tags

Use rainbow brackets
Enable or disable multi-colored brackets in Nova’s editor. This can help distinguish bracket pairs in deeply nested code.
Insert and consume matching brackets
If enabled, typing an open bracket will automatically insert its counterpart, and deleting an open bracket will consume its counterpart, if there is no other text between them. Typing a closed bracket over an automatically inserted closed bracket will simply jump over it. If disabled, brackets are treated like any other typed character.
Wrap selection in typed brackets
When enabled, if you type an opening bracket with a text selection in place, the selected text will be wrapped in that bracket pair. If disabled, the text will be replaced with what you typed.
Highlight matching brackets and tags at cursor
When enabled, Nova will highlight the matching bracket or HTML tag, if any, that matches the one located at the insertion point.
Automatically complete closing tags
When enabled, Nova will automatically close the innermost open HTML tag when you type </

Language Servers

Display completions and/or contextual hover information provided by an installed Language Server extension.

This feature requires the installation of an extension compatible with the Language Server Protocol (LSP) for the programming language you’re using.

Indentation

Settings related to the indentation behavior used in Nova’s editor.

Indentation

Set your preferred indentation character (tabs or spaces), as well as the default tab width.

Nova can also auto-detect if a file is using tabs or spaces for indentation when opening it and adopt the corresponding method for that file.

Indentation Guides

Indentation guides visually align the left edge of each indentation level in your code with a thin vertical line. They may be styled with a single color, rainbow colors, or be turned off entirely.

Wrap lines to editor width
Enable or disable soft-wrapping of lines that would extend beyond Nova’s editor window. Optionally, soft-wrapped lines can be indented by a specific number of spaces. If Indent wrapped lines to match leading whitespace is checked, the indentation of soft-wrapped lines will be relative to the indentation of the previous line, otherwise it will be relative to column 1.
Show wrap guide
The wrap guide is a thin vertical line that appears in the editor at the given column. This can be useful if you manually hard wrap your lines to a certain width, such as 72 or 80 columns.

Typing

Automatically indent new lines
When enabled, Nova will automatically indent new lines to match the flow of the document’s existing indentation.
Adjust indentation of inserted text
When enabled, Nova will automatically indent inserted text to match the flow of the document’s existing indentation.
Reformat indentation of pasted text
When enabled, Nova will automatically indent pasted text to match the flow of the document’s existing indentation.

Saving

Automatically trim trailing whitespace
When enabled, Nova will automatically detect extra whitespace at the end of the document and remove it when saving.
Ensure a trailing newline at the end of files
When enabled, Nova will add a newline to the end of your document when saving if one is not already present. Useful if your build process involves combining multiple files.

Options

Trim whitespace from whitespace-only lines
When enabled, Nova will remove extra whitespace from otherwise-empty newlines.

Media

Settings for changes made to media files using Nova’s editing tools.

Media

Terminal

General

Terminal: General
Font
Choose the font and font size for Nova’s Terminal as well as optionally enable font smoothing.
Beep Style
The terminal “beep” can be traditional audio, a visual flash, both, or neither.
Title
Choose which pieces of information from the current Terminal session should be displayed in the session’s tab label. When using a remote terminal session, some information may not be available.
Show Activity Indicator
When enabled, Nova will display a spinner in the active session tab while operations are in progress.
New Terminals open with
Select the default working directory for new local Terminal tabs.

Theme

Terminal: Theme

Set Nova’s Terminal theme to match the Editor Theme, Window Theme, or customize the theme to your taste.

Keyboard

Terminal: Keyboard

Specify the escape sequences sent when pressing certain keys in Nova’s Terminal. You can also enable Use Option as Meta key and Delete sends Control-H.

Advanced

Terminal: Advanced
Prompt before closing
Whether or not Nova will prompt you for confirmation before closing Terminal tabs, and under what circumstances.
Declare terminal as
Adjust this setting to change how Nova’s Terminal declares itself to remote hosts.
Local Shell
Select which shell to open by default for a Local Terminal.
Send Mouse Events
Whether mouse events in Nova’s Terminal, such as clicks, should be sent to the host.
Detect URLs/Detect local files
Choose whether to detect URLs and local file paths in the Terminal, and allow you to click them as links.

Sync

Panic Sync is a free and secure way to sync your Servers, keys, and passwords between devices and other Panic applications.

Sync

Learn more about Panic Sync.


Servers

The Servers tab allows you to create, edit, and organize remote server destinations, which are used throughout Nova.

Nova supports connecting to the following services in addition to standard FTP, SFTP, and WebDAV based servers:

  • Amazon S3
  • Backblaze B2
  • Box.com
  • DreamObjects
  • Dropbox
  • Google Drive
  • Microsoft Azure
  • Microsoft OneDrive
  • Microsoft OneDrive for Business
  • OpenStack Swift
  • Rackspace CloudFiles
Servers

Adding a new Server

Add a new Server by clicking the at the bottom of the panel.

Fill out the form that appears with the information required to connect to your server. If you don’t know this information, ask the person who administrates the server.

Organizing Servers

Nova Servers can be organized into Server Groups. To create a new Group click the icon, type a name for the Group, and press return.

Servers and Server Groups that you have created can be rearranged by dragging them with the mouse.

To organize Servers automatically, click the gear icon below the Server list and choose an option from the *Arrange By sub-menu.

Editing Servers

To edit a Server or Group, select it, then click the pencil icon below the Server list.

Deleting Servers

To delete a Server or Server Group, select it, then press the delete key.

Importing and exporting Servers

To export a file containing information about all your Nova Servers, click the gear icon at the bottom of the Server list, then choose “Export Servers…”

To import Servers or Favorites exported from another copy of Nova (or certain other file transfer applications), click the gear icon at the bottom of the Server list, then choose “Import Servers…”

Unregistered trial versions of Nova cannot import or export Servers. Please purchase Nova to enable this feature.

Syncing Servers between devices

Nova can sync your Servers, Keys, and connection information between devices and other Panic applications using a Panic Sync account.

You can create a new account (or log into an existing account) in Preferences > Sync.

Unregistered trial versions of Nova cannot use Panic Sync. Please purchase Nova to enable this feature.

More information about Panic Sync can be found on our website.


Keys

Nova supports SSH keys for authenticating SFTP connections. Keys in this list can be used to connect to your servers, and if Panic Sync is enabled, they will be synced to your other devices.

For security considerations of syncing SSH keys, and the methods we use to protect your data, please read our Panic Sync page.

Keys

To add a key to the list, click the at the bottom of the panel. To add an existing key, choose Import Keys…. To create a new key, choose Generate Key….


Transfers

Transfers

Transfers

When An Item Already Exists…

These settings tell Nova what to do when transferring an item to a location where an item with the same name already exists. By default, Nova will ask you what to do.

Replace means delete the item in the destination and replace it with the item being transferred.

Merge means the contents of the source and destination folders will be compared, existing items overwritten, new items uploaded, and items no longer existing in the source folder will be left in place in the destination.

Resume will attempt to finish a partially-transferred file. This is not supported by every protocol or every server.

Be aware of the difference between replacing and merging folders to avoid data loss. Replacing a folder deletes the entire destination folder them transfers a fresh copy.

Bandwidth

Limit the total bandwidth used by uploading and downloading in Nova.

If you have a relatively fast network connection (above 1 MB/sec), these settings can be unreliable, and should be avoided.

Transfer up to ___ files simultaneously

The number of items in the transfer queue that may be actively transferring at any given time.

Need to limit the number of simultaneous connections to your server instead? Head to the Advanced Preferences.

Transfer Options

Use passive (PASV) mode for data transfers
Check this box to use passive mode by default for FTP transfers. Note that each of your saved Servers has a setting for this that will override this global setting. Passive mode is almost always the correct choice. In passive mode, data connections are established from your computer to the server, rather than the other way around.
Play alert sound
Play a sound when a transfer is completed, if desired.

FTP ASCII File Extensions

Items with these file extensions will be transferred using ASCII mode when the FTP protocol is in use. If an extension is not on this list, it will be transferred in Binary mode.

ASCII mode attempts to convert the line endings of text files from client-native to server-native. If a binary file is inadvertently transferred in ASCII mode, it will be corrupted. This is a legacy setting that only applies to FTP connections. Other protocols exclusively transfer files as binary.

Cloud

Use this panel to add custom headers when uploading to cloud servers like Amazon S3 or Microsoft Azure. These headers are used to set metadata and enable additional functionality.

Transfers: Cloud

Custom Cloud Server Upload Headers

Use the checkboxes to the left of each custom header to quickly enable or disable it.

Extension
Your custom headers will be applied when uploading files with this file extension (for example, .html). To apply custom headers to all uploads, select Default.
Name
The name of the header (for example, x-amz-storage-class).
Value
The value to set for this header (for example, REDUCED_REDUNDANCY).

Rules

File Rules

File Rules are applied to file browser listings and Synchronize operations. Items matching a rule’s conditions can be:

  • skipped in file transfers,
  • hidden from file browser listings,
  • or shown regardless of the current global setting for showing invisible files

Click the button at the bottom of the File Rules panel to add a new rule. A checkbox to the left of a rule’s name indicates whether the rule is currently being applied to file browser listings. To make a rule that is applied to Synchronize operations but not general file listings, leave this box unchecked.

Using the pull-down menu to the right of the rule’s name, choose what will happen to items matching the condition of this rule: Skip, Show, or Hide.

Add one or more conditions to define your rule.

Rules support regular expressions. To add a regex condition, choose the field to match against (Name, Path, Date, Size, Kind), then choose matches, and enter your regex in the text field.

Transfers: Rules

To delete a rule, click the minus button at the bottom of the File Rules panel.

Permissions

By default, Nova lets the server determine the permissions of files it uploads. If necessary – and if your server supports it – Nova can be configured to explicitly set permissions by file type and protocol.

To enable explicit permissions setting, check the box next to a file extension. Default File and Default Folder apply to all files and all folders, respectively. Click the button below the panel to add a new file extension to the list. Click the minus button to delete a file extension.

Click through each of the protocols to see what permissions will be set when uploading. Make changes as necessary.

Advanced

Advanced Preferences

Proxy Server

If you need to connect to your server through an FTP proxy, enter the connection details here. Otherwise, leave these settings untouched.

Nova supports the following types of proxy servers:

  • Type 1
  • Type 2
  • Type 3
  • Type 4
  • Type 5
  • Type 6
  • Type 7
  • Type 8
  • Type 9
  • Type 10
  • SOCKS 4
  • SOCKS 4a
  • SOCKS 5
Try to Keep Idle Connections Alive
If enabled, Nova will periodically send a command while idle to prevent the connection from being closed.
Verbose logging
Adds additional logging to connection transcripts to help troubleshoot issues.

SFTP Proxy Server

If you need to connect to your server through and SFTP proxy server that requires password based authentication, enter the proxy server password here. Otherwise, leave this field blank.

Advanced Server Settings

FTP isn’t a strictly-defined standard, so not all FTP servers work the same way. Use these settings to apply special case settings to individual servers. It is recommended you not adjust these settings unless you are specifically having problems with FTP connections and are advised by our support team.

Advanced Server settings
Server List
The server these settings will apply to. Default means all FTP servers. Click the button at the bottom of the list to add a new server, or the minus button to delete the selected server.
Server Type
If you know the specific software package your FTP server uses, choose it here. (This can be helpful if Nova is misbehaving with your server.)
List Spacing
Does your server use one space or two spaces to separate columns in file listings?
Text Encoding
The text encoding used for file listings.
Text Composition
The normalization format of unicode text. Linux- and Windows-based servers use NFC, while OS X-based servers use NFD. (Read more about unicode normalization formats.)
Limit Connections
If your server places a limit on simultaneous connections, enter it here.
Connect Timeout
How long shall Nova wait for the server to respond to a connection attempt?
Busy Retry
How long shall Nova wait between retries in the event your server is busy?
Advanced
Preserve modification dates
If enabled, Nova will attempt to reset the modification date of an uploaded file to match the local modified date.
Tickle server during long transfers
Periodically end a command to keep the control connection alive while waiting for a transfer on the data connection to finish.
Use FEAT command
Send the FEAT command when connecting to find out which extensions the server supports.
Use MLST command
If available, use the MLST extension for detailed/standardized file listings.
Use CCC command
If enabled, a connection made via FTP with TLS/SSL will revert back to plaintext after a secure connection is established.
Use PRET command
Use the PRE Transfer command
Use TLS v1.2 encryption
Applies to connections via FTP with TLS/SSL and FTP with Implicit SSL.

This article was last updated on June 23, 2021