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.
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.
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.
- 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.
- Sign into your Nova Developer account to publish Extensions to the Extension Library
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 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.
Manage customized sidebar layout configurations and set the default layout for new windows. New sidebar layouts can be created from the View menu.
Sidebar Dock Icon Size
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
- 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.
Choose a bright, dark, or custom theme to apply to Nova’s markdown preview.
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.
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.
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.
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.
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.
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.
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.
- 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 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.
- Select the font used in Nova’s editor.
- Line Height
- Set the line height used in Nova’s 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.
- Enables the use of .editorconfig files to automatically set indentation style, line endings, and more.
- Enables preview tabs to detect when you’ve stopped typing in a document and automatically reload to reflect the changes made.
- 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.
- 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.
- 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
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.
Settings related to the indentation behavior used in Nova’s editor.
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 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.
- 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.
- 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.
- Trim whitespace from whitespace-only lines
- When enabled, Nova will remove extra whitespace from otherwise-empty newlines.
Settings for changes made to media files using Nova’s editing tools.
- 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.
- 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.
Set Nova’s Terminal theme to match the Editor Theme, Window Theme, or customize the theme to your taste.
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.
- 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.
Panic Sync is a free and secure way to sync your Servers, keys, and passwords between devices and other Panic applications.
Learn more about Panic Sync.
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
- Google Drive
- Microsoft Azure
- Microsoft OneDrive
- Microsoft OneDrive for Business
- OpenStack Swift
- Rackspace CloudFiles
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.
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.
To edit a Server or Group, select it, then click the pencil icon below the Server list.
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.
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.
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….
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.
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.
- 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.
Custom Cloud Server Upload Headers
Use the checkboxes to the left of each custom header to quickly enable or disable it.
- 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.
- The name of the header (for example,
- The value to set for this header (for example,
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.
To delete a rule, click the minus button at the bottom of the File Rules panel.
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.
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.
- 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?
- 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.