BBEdit
com.barebones.bbedit
BBEdit settings
Configuration Keys (404)
Showing 404 of 404 keys
| Key | Type | Description | Default | Range |
|---|---|---|---|---|
PFC_SegmentedControl_0stringrequired | string | — | Default: — | Range: — |
ApplicationAppearanceModeintegerApplication Appearance | integer | Offers you three choices to control BBEdit’s appearance. | Default: 0 | Range: Use system appearance (0), Light (1), Dark (2) |
SelectedColorSchemeNamestringEditor color scheme | string | Allows you to easily select any existing color scheme. | Default: "BBEdit Light" | Range: BBEdit Classic, BBEdit Dark, BBEdit Light, BBEdit Retro Dark, BBEdit Retro Light, Douce nuit 4, Dusk, Ponies, Seafoam, Toothpaste, Xcode Dark |
Editor color scheme (dark mode) | string | Allows you to easily select any existing color scheme. | Default: "BBEdit Dark" | Range: BBEdit Classic, BBEdit Dark, BBEdit Light, BBEdit Retro Dark, BBEdit Retro Light, Douce nuit 4, Dusk, Ponies, Seafoam, Toothpaste, Xcode Dark |
StatusBarSizeModeintegerStatus bar item size | integer | Controls whether the text and icons displayed in the navigation bar, the status bar, and in the sidebars of editing, project, and differences windows are of normal, large, or extra-large size. | Default: 0 | Range: Normal (0), Large (1), Extra Large (2) |
List display font size | real | Controls the size of the system font used to display text in browser list panes, including disk browsers, search results browsers, FTP/SFTP browsers, etc. | Default: 11 | Range: 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24 |
WhichAppIconintegerApplication icon | integer | Allows you to control which icon BBEdit presents in the Finder (if possible) and in the Dock (while the application is running). | Default: 0 | Range: Default (0), Classic (1), Legacy (2), TextWrangler (3) |
ToolbarShowTextOptionsMenubooleanNavigation bar items: Text options | boolean | Displays the Text Options popover in the navigation bar. | Default: true | Range: — |
NavbarShowDocumentNavigationbooleanNavigation bar items: Document navigation | boolean | Displays the Document popup menu in the navigation bar. | Default: true | Range: — |
NavbarShowMarkerMenubooleanNavigation bar items: Marker menu | boolean | Displays the Marker popup menu in the navigation bar. | Default: true | Range: — |
NavbarShowFileVersionsButtonbooleanNavigation bar items: File versions | boolean | Displays the File Revisions button in the navigation bar. | Default: true | Range: — |
NavbarShowCounterpartButtonbooleanNavigation bar items: Related files | boolean | Displays the Related Files button in the navigation bar. | Default: true | Range: — |
NavbarShowDocumentIconbooleanNavigation bar items: Document status | boolean | Displays the document status icon in the navigation bar. | Default: true | Range: — |
NavbarShowFunctionMenubooleanNavigation bar items: Function menu | boolean | Displays the Function popup menu in the navigation bar. | Default: true | Range: — |
FunctionMenuSortItemsByNamebooleanNavigation bar items: Sort items by name | boolean | Displays the Function popup menu in the navigation bar. | Default: false | Range: — |
EditingWindowShowLineNumbersbooleanEditing window: Line numbers | boolean | Displays line numbers along the left edge of the window. | Default: true | Range: — |
EditingWindowShowGutterbooleanEditing window: Gutter | boolean | Displays the gutter. | Default: true | Range: — |
EditingWindowShowTabStopsbooleanEditing window: Tab stops | boolean | Displays tab stops as vertical grid lines within the content area of text windows, using the tab width set in the Editor Defaults panel. | Default: false | Range: — |
EditingWindowShowPageGuidebooleanEditing window: Page guide at | boolean | Displays the page guide. | Default: true | Range: — |
EditingWindowPageGuideWidthintegerEditing window: Page guide at ## characters | integer | Displays the page guide at the specified character width. | Default: 90 | Range: — |
Editing window: Guide contrast | real | Adjusts the contrast level of the page guide display region. | Default: 4 | Range: 1 – 10 |
Text status bar items: Cursor position | boolean | Displays the current location (line and column) of the insertion point, or the endpoint of the current selection range in the status bar. | Default: true | Range: — |
Text status bar items: Language | boolean | Displays the Language popup menu in the status bar. | Default: true | Range: — |
Text status bar items: Text encoding | boolean | Displays the Text Encoding popup menu in the status bar. | Default: true | Range: — |
Text status bar items: Line break type | boolean | Displays the Line Break Type popup menu in the status bar. | Default: true | Range: — |
Text status bar items: Document lock state | boolean | Displays a padlock icon in the status bar to represent the document’s current lock state. | Default: true | Range: — |
Text status bar items: Document save date | boolean | Displays the current document’s last saved date and time (if applicable) in the status bar. | Default: true | Range: — |
Text status bar items: Document statistics | boolean | Displays an item in the status bar which shows the number of characters, words, and lines in the document. | Default: true | Range: — |
Text status bar items: Instances of selected text | boolean | Displays either the number of matches for the selected text within the document, or the word surrounding the insertion point if applicable. | Default: true | Range: — |
Text status bar items: Text magnification | boolean | Displays the Magnification popup in the status bar. | Default: true | Range: — |
Open documents into the front window when possible | boolean | Controls whether BBEdit should attempt to open newly created or opened documents into the frontmost window (if possible), or whether each document should open directly into a separate text window. | Default: true | Range: — |
WatchDocumentsOnDiskbooleanAutomatically refresh documents as they change on disk | boolean | Checks if documents have changed on disk while they’re open. | Default: true | Range: — |
NSRecentDocumentsLimitintegerRemember the ## most recently used items | integer | How many files appear on the Open Recent sub-menu | Default: 15 | Range: — |
Display_FullPathInRecentMenubooleanAlways show full paths in "Open Recent" menu | boolean | Always display full paths in the Open Recent menu. | Default: false | Range: — |
StartupAndResumeActionintegerWhen BBEdit becomes active | integer | Controls what BBEdit does when you launch it, or activate it when there are no open windows. | Default: 0 | Range: Do nothing (1), New text document (0) |
Reopen documents that were open at last quit | boolean | Remember what documents (as well as disk browsers and FTP/SFTP browsers) were open when you choose the “Quit” command, and will attempt to reopen those documents the next time you launch it. | Default: true | Range: — |
Restore unsaved changes | boolean | Will preserve the contents of any unsaved document contents when you quit and restore those documents the next time you launch it. | Default: true | Range: — |
Include documents on FTP/SFTP servers | boolean | Attempt to reopen documents from remote servers when you launch BBEdit. | Default: true | Range: — |
AlwaysFetchRemoteDocumentsbooleanAlways fetch fron server | boolean | Always reconnect and reload all files previously opened from remote servers. | Default: false | Range: — |
SUSoftwareUpdateEnabledbooleanAutomatically check for updates | boolean | Automatically looks to see if a newer version is available. | Default: true | Range: — |
Early Access | boolean | Checks for pre-release versions. | Default: false | Range: — |
ChatGPTModelstringDefault model | string | The default model BBEdit should use for ChatGPT. | Default: "gpt-3.5-turbo" | Range: gpt-3.5-turbo, gpt-3.5-turbo-16k, gpt-3.5-turbo-instruct, gpt-4, gpt-4-32k |
AIWorksheetWrapResponsesbooleanWrap lines in responses | boolean | Responses should be wrapped. | Default: true | Range: — |
Wrap lines in responses to ## characters | integer | Set the character width at which lines within responses should be wrapped. | Default: 80 | Range: — |
TextCompletionTriggerintegerShow text completions | integer | Choose when BBEdit will display text completions. | Default: 1 | Range: After a delay in typing (1), Only manually (2) |
Delay XX seconds before automatic completion | real | Choose when BBEdit will display text completions. | Default: 0.5 | Range: 0 – 5 |
Include dictionary words in completion list | boolean | Will include dictionary words in the text completion list. | Default: false | Range: — |
Include system text replacements in completion list | boolean | Will include any system-wide Text Replacement triggers (as configured in the “Keyboard” system preferences) which begin with the text you typed in the completion popup. | Default: false | Range: — |
AutoInsertPairsbooleanInsert matching delimiters while typing | boolean | Typing any opening delimiter will cause BBEdit to immediately insert the appropriate closing delimiter. | Default: true | Range: — |
AutoPairsSurroundSelectionbooleanSuround selected text when typing matching delimiters | boolean | Typing an opening delimiter will cause BBEdit to surround the selected text with a matched pair of delimiters. | Default: true | Range: — |
Display instances of selected text | boolean | Will display all occurrences of the selection within the current document. | Default: true | Range: — |
Underline or Highlight | integer | Will display all occurrences of the selection within the current document via either underlining or highlighting. | Default: 0 | Range: Underline (0), Highlight (1) |
Delay XX seconds | real | Adjust the duration of the delay before BBEdit applies highlighting. | Default: 0.5 | Range: 0 – 5 |
Show tick marks in scroll bars: Instances of selected text | boolean | Shows tick marks for instances of selected text. | Default: false | Range: — |
Show tick marks in scroll bars: Live Search results | boolean | Shows tick marks for instances of Live Search results. | Default: true | Range: — |
Show tick marks in scroll bars: Spelling errors | boolean | Shows tick marks for instances of spelling errors. | Default: true | Range: — |
Show tick marks in scroll bars: Issues | boolean | Shows tick marks for instances of issues. | Default: true | Range: — |
ShowLSPDiagnosticsInLineBarbooleanShow issues | boolean | Will display LSP-generated diagnostics when available. | Default: true | Range: — |
HighlightInsertionPointbooleanHighlight insertion point | boolean | Will highlight the line that currently contains the insertion point. | Default: true | Range: — |
Use "hard" lines in soft-wrapped views | boolean | The line number bar, position display, and Line Number commands in editing views will use line and character position numbers that correspond to the “hard” line breaks actually present in the document, rather than the soft-wrapped line breaks. | Default: true | Range: — |
InsertionPointCursorTypeintegerInsertion point | integer | Choose your desired insertion point cursor style. | Default: 0 | Range: Vertical bar (0), Block (1), Underscore (2) |
Line spacing | real | Adjust the amount of space between lines of text in editing views. | Default: 1.1 | Range: 1 – 3 |
ExtraSpaceInTextViewsintegerExtra vertical space ("overscroll") in text views | integer | Allows you to specify how much empty space BBEdit should leave after the end of each document’s content. | Default: 1 | Range: None (1), Half window (2), Full window (3) |
Allow pinch-to-zoom to change magnification | boolean | Use touchpad pinch gestures to increase or decrease the magnification level of the frontmost (active) document. | Default: false | Range: — |
Enable single-click line selection | boolean | Select lines by single-clicking on them in the line number bar or gutter. | Default: true | Range: — |
Cut/Copy entire line for insertion point | boolean | The Cut and Copy commands will act upon the entire line which contains the insertion point, in order to make life easier for Windows refugees. | Default: false | Range: — |
CollapseFoldsWhenOpeningbooleanWhen opening a document: Collapse folds | boolean | Will automatically collapse all folds. | Default: false | Range: — |
When opening a document: Collapse folds below level # | real | Specifies the level to collaps folds. | Default: 2 | Range: 1 – — |
GlyphForInvisibleTabsstringInvisibles display: tabs | string | Allows you to specify alternative characters for tabs. | Default: "∆" | Range: — |
Invisibles display: line breaks | string | Allows you to specify alternative characters for tabs. | Default: "¬" | Range: — |
BBEditorFontdataDefault font | data | Controls the standard font and font size which BBEdit uses to display the contents of text windows. This is in "data" format. To get the correct entry you will need to set the font in BBEdit first, then open the preference plist file in Xcode and copy the data string from the BBEditorFont key. Omit the <> from start and end of the string. | Default: — | Range: — |
Override document setting | boolean | Will cause the default font to always prevail over any previously saved font settings associated with a given text file. | Default: true | Range: — |
Spaces per tab | real | Controls the default number of spaces that BBEdit uses to represent the width of a tab character. | Default: 4 | Range: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62, 63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, 99 |
EditorDefaultMagnificationintegerMagnification | integer | Sets the default magnification for new text documents. | Default: 100 | Range: 800, 500, 400, 300, 200, 175, 150, 125, 100, 75, 50, 33, 25, 10 |
EditorAutoIndentbooleanAuto-indent | boolean | Pressing the Return key in new windows automatically inserts spaces or tabs to indent the new line to the same level as the previous line. | Default: true | Range: — |
BalanceWhileTypingbooleanBalance while typing | boolean | Flashes the matching open parenthesis, brace, bracket, or curly quote when you type a closing one. | Default: true | Range: — |
EditorUseTypographersQuotesbooleanUse typographer's quotes | boolean | Will automatically substitutes curly (or typographer’s) quotes (“ ” ‘ ’) for straight quotes (" ') in any new documents you create. | Default: false | Range: — |
EditorAutoExpandTabsbooleanAuto-expand tabs | boolean | Inserts an appropriate number of spaces instead of a tab character every time you press the Tab key. | Default: false | Range: — |
Show invisible characters | boolean | Shows or hides non-printing characters in the window. | Default: false | Range: — |
EditorShowSpacesbooleanShow spaces | boolean | Will display placeholder characters for spaces. | Default: true | Range: — |
EditorShowTabsbooleanShow tabs | boolean | Will display placeholder characters for tabs. | Default: true | Range: — |
EditorShowLineBreaksbooleanShow line breaks | boolean | Will display placeholder characters for line breaks. | Default: true | Range: — |
EditorCheckSpellingAsYouTypebooleanCheck spelling as you type | boolean | Will automatically check spelling as you type, and underline any potentially misspelled words. | Default: true | Range: — |
EditorSoftWrapbooleanSoft wrap text to | boolean | Soft-wraps the text in the file to the right margin that you choose. | Default: false | Range: — |
SoftWrapStyleintegerSoft wrap text to: Page guide/Windows width/Character width | integer | Soft-wraps the text in the file to the right margin that you choose. | Default: 1 | Range: Page guide (1), Window width (2), Character width (3) |
EditorSoftWrapWidthintegerSoft wrap text to: Character width | integer | Soft-wraps the text in the file to the right margin that you choose. | Default: 80 | Range: — |
SoftWrapIndentationintegerSoft-wrapped line indentation | integer | Lets you specify how BBEdit should indent soft wrapped text. | Default: 1 | Range: Flush left (1), First line (2), Reverse (3) |
TabNavigatesPlaceholdersbooleanUse Tab key to navigate Placeholders | boolean | Will jump to the next placeholder in the document (if any) when you press the Tab key, or the previous placeholder if you press Shift-Tab. | Default: true | Range: — |
HomeAndEndKeysinteger"Home" and "End" key behavior | integer | This setting will have the Home and End keys perform these respective actions. | Default: 1 | Range: Scroll to begining and end of document (1), Move cursor to begining and end of current line (2), Progressive (BREIF compatible) (3) |
EnterGeneratesReturnbooleanEnter key generates Return | boolean | Will generate a line break when you press the Enter key. | Default: false | Range: — |
AllowTabToIndentTextbooleanAllow Tab key to indent text blocks | boolean | You can press the Tab key to invoke the Shift Right command, or Shift-Tab to invoke the Shift Left command. | Default: false | Range: — |
Enable Shift-Delete for forward delete | boolean | Holding down the Shift key with the Delete key makes the Delete key work the same way as the Forward Delete key on extended keyboards. | Default: true | Range: — |
EnableOSHelpKeybooleanEnable macOS "Help" key | boolean | Pressing the Insert key present on some PC-style keyboards will open BBEdit’s Help book. | Default: false | Range: — |
When auto-indenting, remove leading white space from indented line | boolean | When you type Return, BBEdit will insert a line break and strip the following whitespace, leaving the remaining text also left-aligned. | Default: false | Range: — |
Allow Page Up and Page Down keys to move the insertion point | boolean | Move the insertion point to the same relative position within the window in each new screenful of text displayed by Page Up or Page Down. | Default: false | Range: — |
Option-↑ and option-↓ move by paragraphs | boolean | The Option-Up arrow and Option-Down arrow key shortcuts will advance to the previous or next paragraph. | Default: false | Range: — |
EmulateEmacsKeyBindingsbooleanEmulate Emacs key bindings | boolean | This option allows you to use the basic Emacs navigation keystrokes to move around in editing views. | Default: true | Range: — |
DisplayEmacsStatusWindowbooleanDisplay status window | boolean | Will display a small palette which shows Emacs shortcuts as you type them. | Default: false | Range: — |
EnableEmacsMetaSequencesbooleanEnable meta sequences | boolean | Will intercept presses of the Escape key and use these to emulate a meta key to generate Emacs command sequences, at the cost of no longer being able to use the Escape key to exit full screen mode. | Default: false | Range: — |
Allow the Escape key to trigger text completion | boolean | Pressing the Escape key will trigger text completion. | Default: false | Range: — |
Default Language for New Documents | string | If you like, you can set the default language for new untitled documents. | Default: "text-file" | Range: ActionScript (actionscript), ANSI C (ansi-c), Arduino (arduino), C++ (c++), Clojure (clojure), Comma-separated Values (comma-separated-values), CSS (css), EditorConfig (editorconfig), Fortran (fortran), Fortran 9x (fortran-9x), Go (go), HTML (html), INI File (ini-file), Java (java), JavaScript (javascript), JSON (json), JSP (jsp), Lasso (lasso), Lisp (lisp), Log File (log-file), Lua (lua), Make (make), Markdown (markdown), Object Pascal (object-pascal), Objective-C (objective-c), Objective-C++ (objective-c++), Perl (perl), PHP (php), PHP in HTML (php-in-html), Python (python), R (r), Racket (racket), Rez (rez), Ruby (ruby), Ruby in HTML (ruby-in-html), Rust (rust), Sandbox Profile (sandbox-profile), Scheme (scheme), SCSS (scss), Setext (setext), Software Package Notes (software-package-notes), Solidity (solidity), SQL (Generic) (sql-(generic)), SQL (MS Transact) (sql-(ms-transact)), SQL (MySQL) (sql-(mysql)), SQL (PL/SQL) (sql-(pl/sql)), SQL (PostgreSQL) (sql-(postgresql)), Strings File (strings-file), Svelte (svelte), Swift (swift), Tab-separated Values (tab-separated-values), Tcl (tcl), TeX (tex), Text File (text-file), Textile (textile), TOML (toml), TypeScript (typescript), Unix man page (unix-man-page), Unix Shell Script (unix-shell-script), USDA (usda), VBScript (vbscript), VectorScript (vectorscript), Verilog HDL (verilog-hdl), VHDL (vhdl), Vue.js (vue.js), Xcode Project (xcode-project), XML (xml), YAML (yaml) |
Default Language for Unmapped files | string | If you like, you can set the default language for unmapped documents. | Default: "text-file" | Range: ActionScript (actionscript), ANSI C (ansi-c), Arduino (arduino), C++ (c++), Clojure (clojure), Comma-separated Values (comma-separated-values), CSS (css), EditorConfig (editorconfig), Fortran (fortran), Fortran 9x (fortran-9x), Go (go), HTML (html), INI File (ini-file), Java (java), JavaScript (javascript), JSON (json), JSP (jsp), Lasso (lasso), Lisp (lisp), Log File (log-file), Lua (lua), Make (make), Markdown (markdown), Object Pascal (object-pascal), Objective-C (objective-c), Objective-C++ (objective-c++), Perl (perl), PHP (php), PHP in HTML (php-in-html), Python (python), R (r), Racket (racket), Rez (rez), Ruby (ruby), Ruby in HTML (ruby-in-html), Rust (rust), Sandbox Profile (sandbox-profile), Scheme (scheme), SCSS (scss), Setext (setext), Software Package Notes (software-package-notes), Solidity (solidity), SQL (Generic) (sql-(generic)), SQL (MS Transact) (sql-(ms-transact)), SQL (MySQL) (sql-(mysql)), SQL (PL/SQL) (sql-(pl/sql)), SQL (PostgreSQL) (sql-(postgresql)), Strings File (strings-file), Svelte (svelte), Swift (swift), Tab-separated Values (tab-separated-values), Tcl (tcl), TeX (tex), Text File (text-file), Textile (textile), TOML (toml), TypeScript (typescript), Unix man page (unix-man-page), Unix Shell Script (unix-shell-script), USDA (usda), VBScript (vbscript), VectorScript (vectorscript), Verilog HDL (verilog-hdl), VHDL (vhdl), Vue.js (vue.js), Xcode Project (xcode-project), XML (xml), YAML (yaml) |
BBSuffixMapOverridesarrayCustom filesname extension mappings | array | You may add (or remove) additional extension mapping via the Custom Extension Mappings list. The values for the keys Language: Code and Language: Name need to match. | Default: — | Range: — |
| dict | — | Default: — | Range: — | |
fileExtensionstringExtension | string | — | Default: — | Range: — |
languageNamedictLanguage | dict | — | Default: — | Range: — |
languageCodestringLanguage: Code | string | — | Default: — | Range: ActionScript (AScr), ANSI C (C ), Arduino (Adno), C++ (C++ ), Clojure (Cloj), Comma-separated Values (CSV ), CSS (CSS ), EditorConfig (ECFG), Fortran (Fort), Fortran 9x (F90 ), Git commit note (GitC), Go (Go ), Grep Replace Pattern (GrpR), Grep Search Pattern (GrpS), HTML (HTML), INI File (.ini), Java (Java), JavaScript (JScr), JSON (JSON), JSP (JSP ), Lasso (Laso), Lisp (Lisp), Log File (LOG ), Lua (Lua ), Make (Make), Markdown (MRKD), Object Pascal (Pasc), Objective-C (ObjC), Objective-C++ (ObC+), Perforce Specification (P4 ), Perl (Perl), PHP (PHP ), PHP in HTML (PHTM), Python (Pyth), R (R___), Racket (Rakt), Rez (Rez ), Ruby (Ruby), Ruby in HTML (RHTM), Rust (Rust), Sandbox Profile (SBox), Scheme (Schm), SCSS (SCSS), Setext (Setx), Shell Worksheet (ShWk), Software Package Notes (PkgD), Solidity (Sold), SQL (Generic) (SQL ), SQL (MS Transact) (MsSQ), SQL (MySQL) (MySQ), SQL (PL/SQL) (PlSQ), SQL (PostgreSQL) (PgSQ), Strings File (STRS), Svelte (Svel), Swift (Swft), Tab-separated Values (TSV ), Tcl (Tcl ), TeX (TeX ), Text File (DATA), Text Search/Replace String (TxSR), Textile (Txtl), TOML (TOML), TypeScript (TScr), Unix man page (ManP), Unix Shell Script (Shel), USDA (USDA), VBScript (VBSc), VectorScript (VScr), Verilog HDL (Veri), VHDL (VHDL), Vue.js (VuJS), Xcode Project (PBXP), XML (XML ), YAML (YAML) |
languageNamestringLanguage: Name | string | — | Default: — | Range: ActionScript, ANSI C, Arduino, C++, Clojure, Comma-separated Values, CSS, EditorConfig, Fortran, Fortran 9x, Git commit note, Go, Grep Replace Pattern, Grep Search Pattern, HTML, INI File, Java, JavaScript, JSON, JSP, Lasso, Lisp, Log File, Lua, Make, Markdown, Object Pascal, Objective-C, Objective-C++, Perforce Specification, Perl, PHP, PHP in HTML, Python, R, Racket, Rez, Ruby, Ruby in HTML, Rust, Sandbox Profile, Scheme, SCSS, Setext, Shell Worksheet, Software Package Notes, Solidity, SQL (Generic), SQL (MS Transact), SQL (MySQL), SQL (PL/SQL), SQL (PostgreSQL), Strings File, Svelte, Swift, Tab-separated Values, Tcl, TeX, Text File, Text Search/Replace String, Textile, TOML, TypeScript, Unix man page, Unix Shell Script, USDA, VBScript, VectorScript, Verilog HDL, VHDL, Vue.js, Xcode Project, XML, YAML |
BBEdit Registered Owner v11 | string | Organization registered to BBEdit 11 license. | Default: — | Range: — |
BBEditSerialNumber:11.0stringBBEdit License v11 | string | BBEdit 11 license. | Default: — | Range: — |
BBEdit Registered Owner v12 | string | Organization registered to BBEdit 12 license. | Default: — | Range: — |
BBEditSerialNumber:12.0stringBBEdit License v12 | string | BBEdit 12 license. | Default: — | Range: — |
BBEdit Registered Owner v13 | string | Organization registered to BBEdit 13 license. | Default: — | Range: — |
BBEditSerialNumber:13.0stringBBEdit License v13 | string | BBEdit 13 license. | Default: — | Range: — |
BBEdit Registered Owner v14 | string | Organization registered to BBEdit 14 license. | Default: — | Range: — |
BBEditSerialNumber:14.0stringBBEdit License v14 | string | BBEdit 14 license. | Default: — | Range: — |
BBEdit Registered Owner v15 | string | Organization registered to BBEdit 15 license. | Default: — | Range: — |
BBEditSerialNumber:15.0stringBBEdit License v15 | string | BBEdit 15 license. | Default: — | Range: — |
PreviewBrowserListarrayWeb browsers available for previewing | array | Displays all the available (installed) web browsers known to BBEdit. | Default: — | Range: — |
| dict | — | Default: — | Range: — | |
bundleIDstringBundle ID | string | — | Default: — | Range: — |
namestringName | string | — | Default: — | Range: — |
pathstringPath | string | — | Default: — | Range: — |
versionstringVersion | string | — | Default: — | Range: — |
DefaultRenderer_MarkdownintegerMarkdown processor | integer | Allows you to select which built-in, or installed and recognized, Markdown processor BBEdit should employ to convert Markdown content to HTML for previewing and export. BBEdit has built-in support for ‘cmark’ as well as ‘classic’ Markdown. | Default: 0 | Range: Default (cmark) (0), MultiMarkdown (1), Discount (2), Pandoc (3), cmark-gfm (5), Classic (4), Custom (999) |
Custom command line: Command | string | The command name must be available in your $PATH. | Default: — | Range: — |
Custom command line: Arguments | string | The command arguments must be separated by spaces. | Default: — | Range: — |
PrintUsingDocumentFontintegerPrinting font | integer | specifies the default font BBEdit uses for printing when the “Print using document’s font” option is turned off. | Default: 1 | Range: Use document's font (1), Use custom font (0) |
BBPrintingFontdataCustom printing font | data | Uses the specified font and tab settings when printing. This is in "data" format. To get the correct entry you will need to set the font in BBEdit first, then open the preference plist file in Xcode and copy the data string from the BBPrintingFont key. Omit the <> from start and end of the string. | Default: — | Range: — |
FramePrintingAreabooleanFrame printing area | boolean | Draws a box along the edges of the printed text. | Default: false | Range: — |
PrintPageHeadersbooleanPrint page headers | boolean | Prints the page number, the name of the file, the time and date printed in a header at the top of each page. | Default: true | Range: — |
PrintFullPathnamebooleanPrint full path | boolean | Prints the full path of the file being printed in the header. | Default: true | Range: — |
PrintLineNumbersbooleanPrint line numbers | boolean | Prints line numbers along the left edge of the paper. | Default: true | Range: — |
PrintOneInchGutterboolean1-inch gutter | boolean | Leaves a one-inch margin along the left edge of the paper. | Default: false | Range: — |
PrintColorSyntaxbooleanPrint color syntax | boolean | Prints all colorized text within the document in color. | Default: true | Range: — |
PrintTimestampModeintegerTime stamp | integer | Choose whether the date that appears in the printed page header is the date that the file was last modified or the date that the file was printed. | Default: 1 | Range: Date last saved (1), Date printed (2) |
AlwaysWrapToPrintedPageintegerWrap Text to Printed Page | integer | Choose whether a document’s contents should always be soft-wrapped upon printing, or only if soft wrapping is enabled for that document. | Default: 1 | Range: Always (1), Only if the printed document is wrapped for display (0) |
AlwaysShowFileListbooleanAutomatically show sidebar: AlwaysShowFileList | boolean | Controls whether BBEdit should display the sidebar only as needed. The preference setting in BBEdit actually controlls two keys; AlwaysShowFileList and AutoShowFileList. The proper settings for these key key match as follows: As needed: AlwaysShowFileList-False / AutoShowFileList-True Always: AlwaysShowFileList-True / AutoShowFileList-False Never: AlwaysShowFileList-False / AutoShowFileList-False | Default: false | Range: — |
AutoShowFileListbooleanAutomatically show sidebar: AutoShowFileList | boolean | Controls whether BBEdit should display the sidebar only as needed. The preference setting in BBEdit actually controlls two keys; AlwaysShowFileList and AutoShowFileList. The proper settings for these key key match as follows: As needed: AlwaysShowFileList-False / AutoShowFileList-True Always: AlwaysShowFileList-True / AutoShowFileList-False Never: AlwaysShowFileList-False / AutoShowFileList-False | Default: true | Range: — |
Reshape window when showing or hiding sidebar | boolean | Will reshape the entire window when the sidebar appears (or is hidden) to maintain the editing pane at a consistent size. | Default: true | Range: — |
Add documents to sidebar in alphabetical order | boolean | Will add newly created and/or opened documents to the sidebar list in alphabetical order. | Default: true | Range: — |
ShowIconsInSidebarListsbooleanSidebar list appearance and behavior: Show icons | boolean | Displays icons for files and folders in the sidebar’s file list. | Default: true | Range: — |
ShowFinderTagsInSidebarListsbooleanSidebar list appearance and behavior: Show Finder tags | boolean | Displays the Finder tags for files and folders in the sidebar’s file list. | Default: true | Range: — |
Sidebar list appearance and behavior: Allow keyboard focus | boolean | The sidebar lists in projects, multi-document editing windows, and differences windows can acquire keyboard focus (by clicking or tabbing into them), and you can then use conventional keyboard navigation gestures to change the selection. | Default: true | Range: — |
BackgroundColorstringBackground | string | Controls the background color used within editing windows. This needs to be entered as a comma seperated list of hue, saturation, lightness, and alpha (transparency). Example: hsla(0.668, 0.001, 0.970, 1.000) | Default: — | Range: — |
SpellingColorstringMisspelled words | string | Controls the color BBEdit uses to highlight misspelled words. This needs to be entered as a comma seperated list of hue, saturation, lightness, and alpha (transparency). Example: hsla(1.001, 0.503, 1.000, 1.000) | Default: — | Range: — |
InvisibleSpacesColorstringSpaces | string | Controls the color BBEdit uses to display spaces when the Show Invisibles and Show Spaces display options are active. This needs to be entered as a comma seperated list of hue, saturation, lightness, and alpha (transparency). Example: hsla(0.668, 0.003, 0.660, 1.000) | Default: — | Range: — |
InvisibleOthersColorstringOther invisibles | string | Controls the color BBEdit uses to display invisible characters other than spaces when the Show Invisibles display options is active. This needs to be entered as a comma seperated list of hue, saturation, lightness, and alpha (transparency). Example: hsla(0.003, 0.974, 0.868, 1.000) | Default: — | Range: — |
DifferenceHighlightColorstringDifferences | string | Controls the color BBEdit uses to highlight differing regions within a Differences window. This needs to be entered as a comma seperated list of hue, saturation, lightness, and alpha (transparency). Example: hsla(0.759, 0.311, 1.000, 1.000) | Default: — | Range: — |
Sub-line differences | string | Provides explicit control over the color BBEdit uses to display character ranges within a single top-level (or line-level) difference, rather than using a derived color. This needs to be entered as a comma seperated list of hue, saturation, lightness, and alpha (transparency). Example: hsla(0.771, 0.389, 0.881, 1.000) | Default: — | Range: — |
Insertion point line | string | Controls the color BBEdit uses to highlight the current line the insertion point is located at. This needs to be entered as a comma seperated list of hue, saturation, lightness, and alpha (transparency). Example: hsla(0.172, 0.116, 0.976, 1.000) | Default: — | Range: — |
UseCustomHighlightColorbooleanUse custom highlight colors | boolean | Turn this option on to have BBEdit use custom highlight colors. | Default: false | Range: — |
PrimaryHighlightColorstringUse custom highlight colors: primary | string | Choose the primary highlight color. This needs to be entered as a comma seperated list of hue, saturation, lightness, and alpha (transparency). Example: hsla(0.591, 0.298, 1.000, 1.000) | Default: — | Range: — |
SecondaryHighlightColorstringUse custom highlight colors: primary | string | Choose the secondary highlight color. This needs to be entered as a comma seperated list of hue, saturation, lightness, and alpha (transparency). Example: hsla(0.668, 0.001, 0.864, 1.000) | Default: — | Range: — |
EnabledTextEncodingsarrayText Encodings | array | Allows you to choose which of these encodings BBEdit includes in its menus. If you make changes, the following entries are the defaults or are required: Chinese (GB 18030) Chinese (GBK) Cyrillic (Windows) Japanese (ISO 2022-JP) Japanese (Mac OS) Japanese (Shift JIS) Korean (Mac OS) Simplified Chinese (GB 2312) Simplified Chinese (Mac OS) Traditional Chinese (Big 5) Traditional Chinese (Mac OS) [↓ These are required ↓] Unicode (UTF-16 Little-Endian, no BOM) Unicode (UFT-16 Little-Endian) Unicode (UTF-16, no BOM) Unicode (UTF-16) Unicode (UTF-8, with BOM) Unicode (UTF-8) [↑ These are required ↑] Western (ISO Latin 1) Western (ISO Latin 9) Western (Mac OS Roman) Western (Windows Latin 1) | Default: — | Range: — |
| integer | — | Default: — | Range: Baltic (DOS) (1030), Baltic (IOS Latin 7 (525), Baltic (Windows) (1287), Canadian French (DOS) (1048), Celtic (Mac OS) (39), Central European (DOS Latin 2) (1042), Central European (ISO Latin 2) (514), Central European (ISO Latin 4) (516), Central European (Mac OS) (29), Central European (Windows Latin 2) (1281), Chinese (GB 18030) (1586), Chinese (GBK) (1585), Croatian (Mac OS) (36), Cyrillic (DOS) (1043), Cyrillic (ISO 8859-5) (517), Cyrillic (KOI8-R) (2562), Cyrillic (Mac OS Ukrainian) (152), Cyrillic (Mac OS) (7), Cyrillic (Windows) (1282), Devanagari (Mac OS) (9), Dingbats (Mac OS) (34), Gaelic (Mac OS) (40), Greek (DOS Greek 1) (1041), Greek (DOS Greek 2) (1052), Greek (DOS) (1029), Greek (ISO 8859-7) (519), Greek (Mac OS) (6), Greek (Windows) (1283), Gujarati (Mac OS) (11), Gurmukhi (Mac OS) (10), Icelandic (DOS) (1046), Icelandic (Mac OS) (37), Inuit (Mac OS) (236), Japanese (EUC) (2336), Japanese (ISO 2022-JP) (2080), Japanese (Mac OS) (1), Japanese (Shift JIS X0213) (1576), Japanese (Shift JIS) (2561), Japanese (Windows, DOS) (1056), Keyboard Symbols (Mac OS) (41), Korean (EUC) (2368), Korean (Mac OS) (3), Korean (Windows, DOS) (1058), Latin-US (DOS) (1024), Nordic (DOS) (1050), Nordic (ISO Latin 6) (522), Portugese (DOS) (1045), Romanian (ISO Latin 10) (528), Romanian (Mac OS) (38), Russian (DOS) (1051), Simplified Chinese (GB 2312) (2352), Simplified Chinese (Mac OS) (25), Simplified Chinese (Windows, DOS) (1057), Symbol (Mac OS) (33), Thai (Mac OS) (21), Thai (Windows, DOS) (1053), Tibetan (Mac OS) (26), Traditional Chinese (Big 5 HKSCS) (2566), Traditional Chinese (Big 5-E) (2569), Traditional Chinese (Big 5) (2563), Traditional Chinese (EUC) (2353), Traditional Chinese (Mac OS) (2), Traditional Chinese (Windows, DOS) (1059), Turkish (DOS) (1044), Turkish (ISO Latin 5) (521), Turkish (Mac OS) (35), Turkish (Windows Latin 5) (1284), Ukrainian (KOI8-U) (2568), Unicode (UTF-16 Little-Endian, no BOM) (909209186), Unicode (UFT-16 Little-Endian) (909210741), Unicode (UTF-16, no BOM) (825650786), Unicode (UTF-16) (1970549046), Unicode (UTF-8, with BOM) (1970562616), Unicode (UTF-8) (809004642), Vietnamese (Windows) (1288), Western (ASCII) (1536), Western (DOS Latin 1) (1040), Western (EBCDIC Latin 1) (3074), Western (EBCDIC Latin Core) (3073), Western (ISO Latin 1) (513), Western (ISO Latin 3) (515), Western (ISO Latin 9) (527), Western (Mac Mail) (2564), Western (Mac OS Roman) (0), Western (NextStep) (2817), Western (Windows Latin 1) (1280) | |
WriteTextEncodingValueintegerDefault text encoding for new documents | integer | Uses the encoding specified by this option for new documents which do not contain an intrinsic encoding specification. | Default: 809004642 | Range: Baltic (DOS) (1030), Baltic (IOS Latin 7 (525), Baltic (Windows) (1287), Canadian French (DOS) (1048), Celtic (Mac OS) (39), Central European (DOS Latin 2) (1042), Central European (ISO Latin 2) (514), Central European (ISO Latin 4) (516), Central European (Mac OS) (29), Central European (Windows Latin 2) (1281), Chinese (GB 18030) (1586), Chinese (GBK) (1585), Croatian (Mac OS) (36), Cyrillic (DOS) (1043), Cyrillic (ISO 8859-5) (517), Cyrillic (KOI8-R) (2562), Cyrillic (Mac OS Ukrainian) (152), Cyrillic (Mac OS) (7), Cyrillic (Windows) (1282), Devanagari (Mac OS) (9), Dingbats (Mac OS) (34), Gaelic (Mac OS) (40), Greek (DOS Greek 1) (1041), Greek (DOS Greek 2) (1052), Greek (DOS) (1029), Greek (ISO 8859-7) (519), Greek (Mac OS) (6), Greek (Windows) (1283), Gujarati (Mac OS) (11), Gurmukhi (Mac OS) (10), Icelandic (DOS) (1046), Icelandic (Mac OS) (37), Inuit (Mac OS) (236), Japanese (EUC) (2336), Japanese (ISO 2022-JP) (2080), Japanese (Mac OS) (1), Japanese (Shift JIS X0213) (1576), Japanese (Shift JIS) (2561), Japanese (Windows, DOS) (1056), Keyboard Symbols (Mac OS) (41), Korean (EUC) (2368), Korean (Mac OS) (3), Korean (Windows, DOS) (1058), Latin-US (DOS) (1024), Nordic (DOS) (1050), Nordic (ISO Latin 6) (522), Portugese (DOS) (1045), Romanian (ISO Latin 10) (528), Romanian (Mac OS) (38), Russian (DOS) (1051), Simplified Chinese (GB 2312) (2352), Simplified Chinese (Mac OS) (25), Simplified Chinese (Windows, DOS) (1057), Symbol (Mac OS) (33), Thai (Mac OS) (21), Thai (Windows, DOS) (1053), Tibetan (Mac OS) (26), Traditional Chinese (Big 5 HKSCS) (2566), Traditional Chinese (Big 5-E) (2569), Traditional Chinese (Big 5) (2563), Traditional Chinese (EUC) (2353), Traditional Chinese (Mac OS) (2), Traditional Chinese (Windows, DOS) (1059), Turkish (DOS) (1044), Turkish (ISO Latin 5) (521), Turkish (Mac OS) (35), Turkish (Windows Latin 5) (1284), Ukrainian (KOI8-U) (2568), Unicode (UTF-16 Little-Endian, no BOM) (909209186), Unicode (UFT-16 Little-Endian) (909210741), Unicode (UTF-16, no BOM) (825650786), Unicode (UTF-16) (1970549046), Unicode (UTF-8, with BOM) (1970562616), Unicode (UTF-8) (809004642), Vietnamese (Windows) (1288), Western (ASCII) (1536), Western (DOS Latin 1) (1040), Western (EBCDIC Latin 1) (3074), Western (EBCDIC Latin Core) (3073), Western (ISO Latin 1) (513), Western (ISO Latin 3) (515), Western (ISO Latin 9) (527), Western (Mac Mail) (2564), Western (Mac OS Roman) (0), Western (NextStep) (2817), Western (Windows Latin 1) (1280) |
If a file's encoding can't be guessed, try | array | If BBEdit cannot determine a file’s proper encoding by examination, it will try opening the file using the encodings contained in this list, in the order they appear. The default required value is "Western (Mac OS Roman)". | Default: — | Range: — |
| integer | — | Default: — | Range: Baltic (DOS) (1030), Baltic (IOS Latin 7 (525), Baltic (Windows) (1287), Canadian French (DOS) (1048), Celtic (Mac OS) (39), Central European (DOS Latin 2) (1042), Central European (ISO Latin 2) (514), Central European (ISO Latin 4) (516), Central European (Mac OS) (29), Central European (Windows Latin 2) (1281), Chinese (GB 18030) (1586), Chinese (GBK) (1585), Croatian (Mac OS) (36), Cyrillic (DOS) (1043), Cyrillic (ISO 8859-5) (517), Cyrillic (KOI8-R) (2562), Cyrillic (Mac OS Ukrainian) (152), Cyrillic (Mac OS) (7), Cyrillic (Windows) (1282), Devanagari (Mac OS) (9), Dingbats (Mac OS) (34), Gaelic (Mac OS) (40), Greek (DOS Greek 1) (1041), Greek (DOS Greek 2) (1052), Greek (DOS) (1029), Greek (ISO 8859-7) (519), Greek (Mac OS) (6), Greek (Windows) (1283), Gujarati (Mac OS) (11), Gurmukhi (Mac OS) (10), Icelandic (DOS) (1046), Icelandic (Mac OS) (37), Inuit (Mac OS) (236), Japanese (EUC) (2336), Japanese (ISO 2022-JP) (2080), Japanese (Mac OS) (1), Japanese (Shift JIS X0213) (1576), Japanese (Shift JIS) (2561), Japanese (Windows, DOS) (1056), Keyboard Symbols (Mac OS) (41), Korean (EUC) (2368), Korean (Mac OS) (3), Korean (Windows, DOS) (1058), Latin-US (DOS) (1024), Nordic (DOS) (1050), Nordic (ISO Latin 6) (522), Portugese (DOS) (1045), Romanian (ISO Latin 10) (528), Romanian (Mac OS) (38), Russian (DOS) (1051), Simplified Chinese (GB 2312) (2352), Simplified Chinese (Mac OS) (25), Simplified Chinese (Windows, DOS) (1057), Symbol (Mac OS) (33), Thai (Mac OS) (21), Thai (Windows, DOS) (1053), Tibetan (Mac OS) (26), Traditional Chinese (Big 5 HKSCS) (2566), Traditional Chinese (Big 5-E) (2569), Traditional Chinese (Big 5) (2563), Traditional Chinese (EUC) (2353), Traditional Chinese (Mac OS) (2), Traditional Chinese (Windows, DOS) (1059), Turkish (DOS) (1044), Turkish (ISO Latin 5) (521), Turkish (Mac OS) (35), Turkish (Windows Latin 5) (1284), Ukrainian (KOI8-U) (2568), Unicode (UTF-16 Little-Endian, no BOM) (909209186), Unicode (UFT-16 Little-Endian) (909210741), Unicode (UTF-16, no BOM) (825650786), Unicode (UTF-16) (1970549046), Unicode (UTF-8, with BOM) (1970562616), Unicode (UTF-8) (809004642), Vietnamese (Windows) (1288), Western (ASCII) (1536), Western (DOS Latin 1) (1040), Western (EBCDIC Latin 1) (3074), Western (EBCDIC Latin Core) (3073), Western (ISO Latin 1) (513), Western (ISO Latin 3) (515), Western (ISO Latin 9) (527), Western (Mac Mail) (2564), Western (Mac OS Roman) (0), Western (NextStep) (2817), Western (Windows Latin 1) (1280) | |
DefaultLineBreakCharacterintegerLine breaks | integer | If BBEdit cannot determine a file’s proper encoding by examination, it will try opening the file using the encodings contained in this list, in the order they appear. The default required value is "Western (Mac OS Roman)". | Default: 1 | Range: Unix (LF) (1), Legacy Mac (CR) (2), Windows (CRLF) (3) |
EnsureTrailingLineBreakbooleanEnsure file ends with line break | boolean | Will add a line break at the end of the file if there is not already one present. | Default: false | Range: — |
StripTrailingWhitespacebooleanStrip trailing whitespaces | boolean | Will trim all trailing non-vertical whitespace from the document file before writing it out. | Default: false | Range: — |
MakeBackupbooleanMake backup before saving | boolean | Automatically make a backup copy of each file that you save. | Default: false | Range: — |
KeepHistoricalBackupsbooleanKeep historical backups | boolean | Will preserve backups in the “BBEdit Backups” folder. | Default: true | Range: — |
Preserve file name extension | boolean | Have BBEdit place the tilde after the “base” name of the file (“foo~.html”) instead of the name of the original with a tilde appended (“foo.html~”). | Default: false | Range: — |
Rescue untitled document contents when discarding changes | boolean | When this option is on and you close an untitled document (one that has never been saved to disk), and click “Don't Save”, BBEdit will preserve a snapshot of that document's contents. | Default: true | Range: — |
EnableRescueDocumentCleanupbooleanRemove rescued items | boolean | Will automatically perform some housekeeping for you by cleaning up rescued data. | Default: true | Range: — |
Remove rescued items after ## days | real | You can adjust the interval from 1 to 365 days. | Default: 7 | Range: 1 – 365 |
Text file name extensions | array | Add filename extensions for files that BBEdit does not intrinsically know about, but which should be treated as (plain) text files. | Default: — | Range: — |
| string | — | Default: — | Range: — | |
Allow Editor Config Read Encoding | boolean | — | Default: true | Range: — |
Allow Folder Selection in Open Dialog | boolean | — | Default: true | Range: — |
AllowMultiLinePlaceholdersbooleanAllow Multi Line Placeholders | boolean | — | Default: false | Range: — |
Allow Prototype Object Extend (JavaScript) | boolean | — | Default: true | Range: — |
AllowShebangLineOverridebooleanAllow Shebang Line Override | boolean | — | Default: true | Range: — |
Allow Shift Right to Indent Whitespace Only Lines | boolean | By default, the "Shift Right" command on the Text menu will not add indentation to lines that are empty or consist entirely of white space. If you would prefer to indent every line, regardless of its whitespace-only nature, set this preference to 'true'. | Default: true | Range: — |
Allow Volume Mount During State Restore | boolean | BBEdit provides control over whether documents on remote servers - FTP/SFTP - or unmounted volumes are opened when automatically reopening documents at application startup. You can modify its behavior by setting this to 'true'. | Default: false | Range: — |
Prompt To Reopen Remote Documents | boolean | If set to 'false', BBEdit will not attempt to open any documents that were opened from FTP/SFTP servers. Defaults to 'true'. If set to 'false', BBEdit will open remote documents without asking, if ReopenRemoteDocuments is set to 'true'. | Default: true | Range: — |
Always Bring Unix Script Output To Front | boolean | — | Default: false | Range: — |
AlwaysDisplaySoftHyphensbooleanAlways Display Soft Hyphens | boolean | — | Default: true | Range: — |
Always Show Annunciator For Not Found | boolean | To skip the sound check and always have BBEdit show the overlay alert instead of beeping. | Default: false | Range: — |
Always Use Base Python With Virtual Environment | boolean | — | Default: true | Range: — |
Always Use Base Python With Virtual Environment (Python) | boolean | — | Default: true | Range: — |
AppleShowAllExtensionsbooleanApple Show All Extensions | boolean | — | Default: true | Range: — |
Ask For Unguessable File Encoding | boolean | Ordinarily, BBEdit will only ask you to choose a file's encoding when it can't otherwise figure out what the encoding is, and your "if the file's encoding can't be guessed" preference is a UTF-8 or UTF-16 variant. This should be fine for general use, but if for some reason you always want BBEdit to ask you when it can't guess a file's encoding, even if your preference would do the job, you can set this to 'true'. | Default: false | Range: — |
AskXcodeForOpenFileByNamebooleanAsk XCode to Open File by Name | boolean | If Xcode is running, Open Selection and Open File by Name will ask it for a path to the file name; if something useful comes back, BBEdit will open it. If for some reason you are using Xcode but don't want BBEdit to do this, you can turn it off by setting this to 'false'. | Default: true | Range: — |
AutoIndentLSPCompletionTextbooleanAuto Indent LSP Completion Text | boolean | — | Default: true | Range: — |
Auto Reveal Selected Document In Project List | boolean | BBEdit will not automatically reveal documents in the project list when you select them; View => Reveal in Project List works for this purpose. If you want automatic revealing, set to this to 'true' | Default: false | Range: — |
AutoSaveAppStatebooleanAuto Save App State | boolean | — | Default: true | Range: — |
AutoSaveIntervalInMinutes_v2integerAuto Save Interval In Minutes: v2 | integer | If document auto-save for crash recovery is on, this preference will define the default save time interval. | Default: 1 | Range: — |
AutoSwapCloseShortcutsbooleanAuto Swap Close Shortcuts | boolean | — | Default: true | Range: — |
Auto Wrap Documents With Long Lines | boolean | — | Default: true | Range: — |
Auto Wrap Documents With Long Lines (HTML) | boolean | — | Default: false | Range: — |
AutoWrapLineLengthThresholdintegerAuto Wrap Line Length Threshold | integer | — | Default: 8192 | Range: — |
BalanceIncludesDelimitersbooleanBalance Includes Delimiters | boolean | By default, the "Balance" command (or double-clicking on a delimiter to balance) does not include the delimiters in the resulting selection. If you would like for it to do so, set this preference to 'true'. | Default: false | Range: — |
BRIEF State Timeout | real | The progressive (BRIEF compatible) behavior of the Home and End keys operates within a specific time period; if you wait longer than that, the behavior state resets. The factory default timeout period is ten seconds. | Default: 10 | Range: 0.1 – — |
Camel Case Navigation Includes Underscores | boolean | When using "camel case" navigation (see above), BBEdit does not include underscores ( _ ) when moving or extending the selection range. If you would prefer that it do so, you can turn this on. | Default: false | Range: — |
CascadeNewWindowsbooleanCascade New Windows | boolean | — | Default: true | Range: — |
ChatGPTAPIRequestTimeoutintegerChatGPT API Request Timeout | integer | — | Default: 0 | Range: — |
Check Modification Date For Remote Saves | boolean | — | Default: true | Range: — |
ClipboardTextDisplayLimitintegerClipboard Text Display Limit | integer | — | Default: 65536 | Range: — |
Clipboard: Convert Non Breaking Spaces When Pasting | boolean | — | Default: true | Range: — |
ClippingsWorkInFindWindowsbooleanClippings Work In Find Windows | boolean | — | Default: true | Range: — |
Close OFBN Window After Opening Selection | boolean | By default, the "Open File by Name" window stays open when you click the "Open" button. However, if you would prefer for it to act more like a modal dialog, set this to 'true'. | Default: false | Range: — |
CodelessPCRETimeoutintegerCodeless PCRE Timeout | integer | — | Default: 250 | Range: — |
Color Patterns In Grep Cheat Sheet | boolean | BBEdit will color patterns (the left-hand column) in the Grep Cheat Sheet menu according to the active color scheme. If you would prefer monochromatic patterns for any reason turn this off. | Default: true | Range: — |
Comment Whole Line With Insertion Point | boolean | When using the Un/Comment command, if nothing is selected, BBEdit will use the line comment delimiter to comment (or uncomment) the entire line. If you would prefer that BBEdit insert the line-comment delimiter at the insertion point instead, set this preference to 'false'. | Default: true | Range: — |
CondaInterfaceCommandTimeoutintegerConda Interface Command Timeout | integer | — | Default: 3500 | Range: — |
ContextMenuClipboardbooleanContext Menu Clipboard | boolean | — | Default: true | Range: — |
ContextMenuMarkersbooleanContext Menu Markers | boolean | — | Default: true | Range: — |
ContextMenuResolveURLbooleanContext Menu Resolve URL | boolean | — | Default: true | Range: — |
ContextMenuSaveNewSelectionbooleanContext Menu Save New Selection | boolean | — | Default: true | Range: — |
ContextMenuSpellCheckingbooleanContext Menu Save New Selection | boolean | — | Default: true | Range: — |
ContextMenuTextFoldingbooleanContext Menu Text Folding | boolean | — | Default: true | Range: — |
ContextMenuTextSearchingbooleanContext Menu Text Searching | boolean | — | Default: true | Range: — |
Counterpart Sibling Search Names | string | When the active document is either a source or a header file, the "Open Counterpart" command will now search the siblings of this file's parent for eligible counterparts. By default, BBEdit will only search in such folders if their names match one of the following patterns (including wildcards): `inc*`, `source`, `src`, or `*priv*`. If you wish to add additional qualifying names, you may do so by setting "CounterpartSiblingSearchNames" to contain a comma-delimited list of folder name patterns. Any whitespace surrounding the provided names will be stripped. | Default: — | Range: — |
Cross Check For Image Files With Text Encoding Xattr | boolean | — | Default: false | Range: — |
CSSMarkup_NewLineBeforeBracebooleanCSS Markup: New Line Before Brace | boolean | — | Default: true | Range: — |
CSS Markup: Prefer Short Hex Colors | boolean | — | Default: true | Range: — |
CSS Markup: Simple Rules On One Line | boolean | — | Default: true | Range: — |
CtagsCompletionThresholdintegerCtags Completion Threshold | integer | — | Default: 2 | Range: — |
DefaultNoteLanguageModestringCtags Completion Threshold | string | — | Default: "markdown" | Range: — |
Diff_IgnoreRCSKeywordsbooleanDiff: Ignore RCS Keywords | boolean | When comparing text files, BBEdit will canonicalize RCS keywords to their unexpanded state, so that the values of RCS keywords are not significant to the differences calculations. If you wish, you can disable this, so that any chance in the RCS keywords on a line will cause the line to appear in the differences. | Default: true | Range: — |
DisableAllFontLigaturesbooleanDisable All Font Ligatures | boolean | — | Default: false | Range: — |
DisableAttachmentScriptsbooleanDisable Attachment Scripts | boolean | — | Default: false | Range: — |
Disable Ctags Scan On Remote Volumes | boolean | When editing files that are on remote file servers - AFP, NFS, SMB, etc. -, BBEdit will not look for directory-relative ctags data files. This is a particular performance win when the file is located on a volume mounted via MacFUSE/SSH or similar, or if the file server is over a slow or high-latency link. To enable scanning for tags files on remote volumes, set this to 'false'. | Default: true | Range: — |
DisableCursorBlinkbooleanDisable Cursor Blink | boolean | You can disable the cursor blink in BBEdit's editing windows. | Default: false | Range: — |
DisableFindAndReplaceHistorybooleanDisable Find And Replace History | boolean | Completely disable the search history in the Find and Multi-File Search windows. | Default: false | Range: — |
DisablePassiveFTPbooleanDisable Passive FTP | boolean | Settings are available for disabling passive FTP, in order to deal with hosts that misbehave when sent the PASV command. Passive FTP can be disabled per host, per domain, or globally. | Default: false | Range: — |
DisplayPrivateAreaGlyphsbooleanDisplay Private Area Glyphs | boolean | — | Default: true | Range: — |
Display_FullPathInWindowMenubooleanDisplay: Full Path In Window Menu | boolean | — | Default: false | Range: — |
DoubleClickToBalancebooleanDouble Click To Balance | boolean | — | Default: true | Range: — |
EditorTailMode_Log FilebooleanEditor Tail Mode (Log File) | boolean | — | Default: true | Range: — |
Editor_AlwaysOpenQuickFindbooleanEditor: Always Open Quick Find | boolean | The Live Search bar is not visible by default, but appears when you choose "Live Search" from the Search menu. If you would like the Live Search bar to be visible in each new document that you create or open, set this to 'true'. | Default: false | Range: — |
Editor: Auto Indent Is Brace Aware | boolean | — | Default: true | Range: — |
Editor: Auto Word Count Size Threshold | integer | Automatic word counting is disabled for documents over a set size threshold, in order to avoid needless delays when working on very large documents. The factory default is 16M characters - 16777216 -, but you may change this limit. Setting to 0 disables the limit check entirely. | Default: 16777216 | Range: 0 – — |
Editor_ControlArrowCamelCasebooleanEditor: Control Arrow Camel Case | boolean | BBEdit supports "camel case" navigation: press Control-left-arrow or Control-right-arrow to jump to the next (or previous) transition from lower-case to upper-case characters (or a word boundary, whichever comes first). Note that this use of Control-left-arrow and Control-right-arrow replaces the pre-8.5 behavior of using these key combinations to scroll horizontally. If you prefer the old behavior, set these this preference to 'false'. | Default: true | Range: — |
Editor_ControlArrowHScrollbooleanEditor: Control Arrow H Scroll | boolean | BBEdit supports "camel case" navigation: press Control-left-arrow or Control-right-arrow to jump to the next (or previous) transition from lower-case to upper-case characters (or a word boundary, whichever comes first). Note that this use of Control-left-arrow and Control-right-arrow replaces the pre-8.5 behavior of using these key combinations to scroll horizontally. If you prefer the old behavior, set these this preference to 'true'. | Default: false | Range: — |
Editor: Delete Indentation Whitespace To Tab Stop | boolean | When you backspace from the insertion point, BBEdit will delete a tab stop's worth of spaces if there are only spaces (and tabs) between the insertion point and the start of the line on which you're editing. This may be disabled by setting this preference to 'false'. | Default: true | Range: — |
Editor: Soft Wrap Length Threshold | integer | For text documents whose size exceeds a certain threshold (expressed in bytes), BBEdit will ignore the Soft Wrap Text preference and leave wrapping off in order to improve the performance of opening very large files. | Default: 50331648 | Range: — |
Editor_SpellCheckLengthLimitintegerEditor: Spell Check Length Limit | integer | Since "Find All Misspelled Words" is pretty much pointless on files over a certain size, the maximum amount of text checked by this command is limited to 1M - 1024 squared - characters. This may be adjusted. Setting to 0 supresses the limit altogether. | Default: 1048576 | Range: 0 – — |
EnableAutoSave_v2booleanEnable Auto Save: v2 | boolean | Document auto-save for crash recovery is on by default, to change this set this to 'false'. | Default: true | Range: — |
Enable Character Wrapping To Window Width | boolean | — | Default: true | Range: — |
Enable Default Filename Extensions | boolean | — | Default: true | Range: — |
EnableFontLigaturesbooleanEnable Font Ligatures | boolean | — | Default: false | Range: — |
Enable Font Ligatures: Cascadia Mono* | boolean | — | Default: true | Range: — |
Enable Font Ligatures: Fira Code* | boolean | — | Default: true | Range: — |
EnableFontLigatures_Hasklig*booleanEnable Font Ligatures: Hasklig* | boolean | — | Default: true | Range: — |
Enable Font Ligatures: Jet Brains Mono* | boolean | — | Default: true | Range: — |
Enable Font Ligatures: Mono Lisa* | boolean | — | Default: true | Range: — |
EnableFontLigatures_Monoid*booleanEnable Font Ligatures: Monoid* | boolean | — | Default: true | Range: — |
Enable Font Ligatures: Monoisome* | boolean | — | Default: true | Range: — |
EnableRareLigaturesbooleanEnable Rare Ligatures | boolean | — | Default: false | Range: — |
EnableSSHCompressionbooleanEnable SSH Compression | boolean | Some servers don't work correctly when SSH compression is enabled. To work around this, SSH compression can be disabled per host, per domain, or globally. | Default: true | Range: — |
EnableSSHLegacyRSAHostKeysbooleanEnable SSH Legacy RSA Host Keys | boolean | — | Default: true | Range: — |
EnableSyntaxColoringbooleanEnable Syntax Coloring | boolean | — | Default: true | Range: — |
Exchange Command And Option Horizontal | boolean | — | Default: false | Range: — |
Exchange Command And Option Vertical | boolean | — | Default: false | Range: — |
FindAndReplaceHistorySizeintegerFind And Replace History Size | integer | By default, BBEdit will remember the 16 most recent search and replace strings/patterns for the popup menu in the Find and Multi-File Search windows. Setting the history to zero makes it infinite. | Default: 16 | Range: 0 – — |
FindDialog_UsesFindScrapbooleanFind Dialog: Uses Find Scrap | boolean | Like many Mac OS X applications, BBEdit supports the "Find Scrap", a feature of the OS that enables sharing of the "search for" string between applications. Some applications put inappropriate content - such as Web search strings - on the Find Scrap, which can cause the "search for" string in BBEdit's Find dialog to be replaced when you didn't expect it. To tell BBEdit not to import the Find Scrap into its Find window, nor to export the "search for" string to the Find Scrap, set this to 'false'. | Default: true | Range: — |
Fixed Width Font Smoothing Threshold | integer | Whether or not BBEdit uses text smoothing - antialiasing - may be adjusted separately for fixed-width and for proportional fonts. The factory default smoothing thresholds are 8pt for fixed width fonts, and 4pt for proportional fonts, respectively. | Default: 8 | Range: — |
Flash Balance Points When Navigating | boolean | When you use the right-arrow key to navigate over a closing delimiter (right paren/brace/bracket/curly quote), the opening delimiter will be briefly highlighted. If you wish to turn this off, set this preference to 'false'. | Default: true | Range: — |
FontSmoothingThresholdintegerFont Smoothing Threshold | integer | Whether or not BBEdit uses text smoothing - antialiasing - may be adjusted separately for fixed-width and for proportional fonts. Font sizes above the specified FixedWidthFontSmoothingThreshold are smoothed; font sizes below the threshold are not. | Default: 4 | Range: — |
Force Singleton Windows For Unix Script Output | boolean | — | Default: false | Range: — |
FTPAbortTimeoutintegerFTP Abort Timeout | integer | — | Default: 3 | Range: — |
FTPAutoDisconnectPeriodintegerFTP Auto Disconnect Period | integer | — | Default: 90 | Range: — |
FTPConnectionTimeoutintegerFTP Auto Disconnect Period | integer | — | Default: 20 | Range: — |
FTPControlTimeoutintegerFTP Control Timeout | integer | — | Default: 30 | Range: — |
FTPDisableMLSDbooleanFTP Disable MLSD | boolean | Ordinarily, BBEdit will use the MLSD command to obtain directory listings if the server supports it; and will fall back to more primitive methods if not. On some servers, however, MLSD works, but does not return the same results as the older methods. Therefore, there is a method to disable use of MLSD. | Default: false | Range: — |
FTPRememberRecentFilesbooleanFTP Remember Recent Files | boolean | — | Default: true | Range: — |
FTPSafeSavesbooleanFTP Safe Saves | boolean | — | Default: false | Range: — |
FTPShowParentDirbooleanFTP Show Parent Dir | boolean | On FTP servers, when using 'Show items starting with ".",' the FTP server may return the `.` and `..` items as part of the listing. This is normal, but if you don't want to see these items, you can hide them. | Default: true | Range: — |
FTPTransferTimeoutintegerFTP Transfer Timeout | integer | — | Default: 30 | Range: — |
FullScreenWindowsHogScreenbooleanFull Screen Windows Hog Screen | boolean | By default, the application will allow windows to take up the entire screen when entering full screen mode. If desired, you may prevent this and instruct the application to figure out whether a window should be made the full width of the screen by setting this to 'false'. | Default: true | Range: — |
Full Screen Width Threshold | real | When entering full screen mode, the application figures out whether the window width should be increased to take up the full screen width, or not, based on the width of the window relative to the width of the screen that it's on. The threshold at which the window is made to take up the entire screen width can be set. This setting requires that FullScreenWindowsHogScreen be turned on NEED FLOAT NUMBER MIN & MAX | Default: — | Range: 0 – 1 |
Function Menu Show Comment Callouts | boolean | — | Default: true | Range: — |
Function Menu Show Function Prototypes | boolean | — | Default: false | Range: — |
FunctionPopup_PrototypesbooleanFunction Popup: Prototypes | boolean | — | Default: true | Range: — |
FunctionPopup_SortByNamebooleanFunction Popup: Sort By Name | boolean | — | Default: false | Range: — |
Generate Completions From Nearby Tags Files | boolean | — | Default: true | Range: — |
Generate Temporary Tags For Completion | boolean | — | Default: true | Range: — |
Gray Level For Modified Rings In List Widgets | real | — | Default: 0.65 | Range: — |
GroupWindowsMenuByKindbooleanGroup Windows Menu By Kind | boolean | — | Default: true | Range: — |
HonorEmacsStateOnOpenbooleanHonor Emacs State On Open | boolean | — | Default: true | Range: — |
HTML Image Markup Creates Size Attributes | boolean | When you drop an image file into an HTML document to generate an image tag, BBEdit will generate "width" and "height" tags based on information in the file itself. If you would prefer to omit these, set these to 'false'. | Default: true | Range: — |
HTML Image Markup Use Inline Style For Image Size | boolean | If HTMLImageMarkupCreatesSizeAttributes is turned on, you can instruct BBEdit to generate inline styles for image sizes, instead of height and width by setting this to 'true'. | Default: false | Range: — |
HTML Image Markup Uses File Name For Alt | boolean | When generating image markup as a result of dropping an image file into an HTML document, BBEdit will generate an "alt" attribute for the image tag, whose value is the file's name. If you would prefer for the "alt" attribute to be omitted (which will result in an error when checking syntax), you can disable this by setting this to 'false'. | Default: true | Range: — |
Inspect Text File Contents For List Filtering | boolean | The "Text Files Only" filtering in project lists and disk browsers looks inside of files if necessary, for improved filtering accuracy. | Default: true | Range: — |
Inspect Zip Archive Contents For File Filtering | boolean | When inspecting files to determine whether they're Zip archives for file filtering and searching, BBEdit will ordinarily only inspect the contents of the file if its metadata does not indicate that it’s a Zip archive. If for some reason you have files whose metadata indicates that they're Zip archives, but aren't really, you can use this setting to tell BBEdit to always inspect Zip archive contents. | Default: false | Range: — |
LeaveRoomForPalettesbooleanLeave Room For Palettes | boolean | — | Default: true | Range: — |
LegacyUndoSelectionBehaviorbooleanLegacy Undo Selection Behavior | boolean | When performing an Undo or Redo and the selection range changes, the Undo/Redo operation will select the affected text, rather than updating the Undo/Redo state to include the actual current selection range. If however you prefer the classic behavior (as implemented from the beginning of time up through BBEdit 11.6), you may obtain set this preference to 'true'. | Default: false | Range: — |
LinkEncodingToCharsetbooleanLink Encoding To Charset | boolean | — | Default: true | Range: — |
LiveMatchSizeLimitintegerLive Match Size Limit | integer | — | Default: 256 | Range: — |
LongestLineCalculationLimitintegerLongest Line Calculation Limit | integer | — | Default: 16777216 | Range: — |
LSP Completions Replace Instead Of Insert | boolean | — | Default: false | Range: — |
LSP Enable Markdown Documentation | boolean | — | Default: true | Range: — |
MakeShebangScriptsExecutablebooleanMake Shebang Scripts Executable | boolean | — | Default: true | Range: — |
MakeTempProjectForFolderOpenbooleanMake Temp Project For Folder Open | boolean | — | Default: true | Range: — |
Markup Panel Auto Prefill Recommended Attribute Names | boolean | When you invoke the Markup Panel to create a new tag, it will automatically fill in attribute names for "promoted" attributes. If there are any attributes that you don't want to be present in the generated markup, just leave their values blank, and the panel will omit them (unless the attributes are required). If you wish, you can suppress the auto fill by setting this to 'false'. Turning off the auto fill will cause the "gear" to appear in the markup panel, and clicking it will manually fill in the promoted attributes for you. | Default: true | Range: — |
Markup Tools Misc: Skip XML Files When Scanning Folders | boolean | When doing Check Syntax, Check Links, Update, or Update Images on a folder (including a web site), BBEdit will skip XML files (that is, files determined to be XML either by mapping their file name extensions, or by inspection of their contents). If you prefer to include such files, set this to 'false'. | Default: true | Range: — |
Max Document Length For Completion Tokenizer | integer | Since "Find All Misspelled Words" is pretty much pointless on files over a certain size, the maximum amount of text checked by this command is limited to 1M - 1024 squared - characters. This may be adjusted. Setting to 0 supresses the limit altogether. | Default: 1048576 | Range: 0 – — |
MaxFindDifferencesGroupSizeintegerMax Find Differences Group Size | integer | — | Default: 5 | Range: — |
MaximumHeaderFontSizeintegerMaximum Header Font Size | integer | — | Default: 14 | Range: — |
MaximumLineBarPointSizeintegerMaximum Line Bar Point Size | integer | BBEdit will calculate an appropriate size for font used in the line number bar, based on the point size of the font used for editing. | Default: 24 | Range: — |
Maximum Text Length For Language Guessing | integer | — | Default: 32768 | Range: — |
MinimumLinesForBlockFoldintegerMinimum Lines For Block Fold | integer | — | Default: 1 | Range: — |
MostRecentItemsGroupLimitintegerMost Recent Items Group Limit | integer | The "Remember the … most recently used items" setting in the Application preferences applies to all item types. So, if it's set to 15, BBEdit will remember 15 text documents, 15 folders, 15 projects, 15 images, and so on. If you want finer control, you can construct an expert pref using the name of the document type as it appears in the menu, and if that name contains spaces, you'll need to quote it. You can also control the number of items shown in the "Most Recently Used" group. | Default: — | Range: — |
Move Modeless Window To Active Space | boolean | When using Spaces, you can control whether BBEdit's modeless dialog boxes - Find, Multi-File Search, and Open File by Name - get moved to the active space when switching spaces. By default, this is allowed for the Find, Multi-File Search, and Open File by Name windows. To control whether windows of these types are moved to the active space, set this to 'true'. This preference sets the default behavior for any of the defined window types for which a default is not explicitly specified. | Default: false | Range: — |
NumberOfOpenByNameItemsintegerNumber Of Open By Name Items | integer | — | Default: 100 | Range: — |
OFBN Enumerates Xcode Subprojects | boolean | — | Default: true | Range: — |
OFBNIncludesRecentItemsbooleanOFBN Includes Recent Items | boolean | — | Default: false | Range: — |
Only Show Invisible Unicode Spaces When Show Spaces Is Turned On | boolean | — | Default: true | Range: — |
OpaqueBlockComments_PHPbooleanOpaque Block Comments (PHP) | boolean | — | Default: true | Range: — |
OpaqueHereDoc_PHPbooleanOpaque Here Doc (PHP) | boolean | — | Default: true | Range: — |
OpaqueLineComments_PHPbooleanOpaque Line Comments (PHP) | boolean | — | Default: true | Range: — |
OpaqueStrings_PHPbooleanOpaque Strings (PHP) | boolean | — | Default: true | Range: — |
OpenByNameMaxWildcardMatchesintegerOpen By Name Max Wildcard Matches | integer | When searching for matches, Open File by Name limits the number of matches to a reasonable maximum. The factory default is 200. | Default: 200 | Range: — |
OpenDiskBrowserForTarballsbooleanOpen Disk Browser For Tarballs | boolean | — | Default: true | Range: — |
OpenDiskBrowserForZipFilesbooleanOpen Disk Browser For Zip Files | boolean | — | Default: true | Range: — |
OpenItemsOnSingleClickbooleanOpen Items On Single Click | boolean | — | Default: true | Range: — |
Open Panel Shows Front Document Directory | boolean | By default, the Open panel implements the standard system behavior of displaying the same folder that was viewed the last time you used the Open command. If you wish, you may instead have the Open panel display the directory containing the active document by setting this to 'true'. If the active document is untitled or was opened from an FTP/SFTP server, or if there are no documents open, the Open panel will show you the last-used directory. | Default: true | Range: — |
OpenPDFsAsTextbooleanOpen PDFs As Text | boolean | By default, PDFs are considered text files and so may be opened and searched along with all other text files. To have PDFs treated as a special file type - (they will be ignored for any operation that requires a text file - set this to 'false'. | Default: false | Range: — |
PerformLineFeedTranslationbooleanPerform Line Feed Translation | boolean | — | Default: true | Range: — |
PrecomposeUnicodeWhenPastingbooleanPrecompose Unicode When Pasting | boolean | If you find that you frequently need to bring in text which contains combining Unicode characters (as are frequently found in PDFs generated on other platforms, for example), it can be desirable to preprocess the combining characters into one composed character where possible. This is not a general need, but if you run into it often enough, you can tell BBEdit to combine the characters for you by setting this preference to 'true'. Despite the name, the precomposition is done when BBEdit imports the Clipboard from other applications, not when the paste is actually done. Note that this requires an additional copy of the Clipboard when the application imports the text, and for very large pastes, there may be a noticeable delay while the text gets precomposed. Thus, you should only turn on this setting when you are frequently working with text that contains combining Unicode characters | Default: false | Range: — |
PreferEditorConfigTabWidthbooleanPrefer Editor Config Tab Width | boolean | — | Default: true | Range: — |
PrettyPrintPastedHTMLbooleanPretty Print Pasted HTML | boolean | — | Default: true | Range: — |
Projects Allow Volume Mount When Reopening | boolean | — | Default: true | Range: — |
Projects Open Items On Single Click | boolean | Project windows will ordinarily open an item in the file list for editing when you click on it and the editing view is visible. To require a double-click, set this to 'false'. | Default: true | Range: — |
Projects Remember Open Documents | boolean | — | Default: true | Range: — |
ProvideSTDINToUnixScriptsbooleanProvide STDIN To Unix Scripts | boolean | BBEdit provides the selection range in the active document (or the active document's contents, if there is no selection) as stdin when running a Unix script or executable from the Scripts menu. If the script isn't expecting this and never reads from stdin, this can cause a problem if there is more than 64K of data provided. The result will usually be a 100032 error. If this is a regular occurrence for you, you can turn the feature off. | Default: true | Range: — |
Recent Items: Remember ## Folders | integer | The "Remember the … most recently used items" setting in the Application preferences applies to all item types. So, if it's set to 15, BBEdit will remember 15 text documents, 15 folders, 15 projects, 15 images, and so on. If you want finer control, you can construct an expert pref using the name of the document type as it appears in the menu, and if that name contains spaces, you'll need to quote it. If you don't want to remember any recent documents of a particular type - they won't appear in the menu, either -, you can set its limit to 0 | Default: 15 | Range: — |
Recent Items: Remember ## Images | integer | The "Remember the … most recently used items" setting in the Application preferences applies to all item types. So, if it's set to 15, BBEdit will remember 15 text documents, 15 folders, 15 projects, 15 images, and so on. If you want finer control, you can construct an expert pref using the name of the document type as it appears in the menu, and if that name contains spaces, you'll need to quote it. If you don't want to remember any recent documents of a particular type - they won't appear in the menu, either -, you can set its limit to 0 | Default: 15 | Range: — |
Recent Items: Remember ## Projects | integer | The "Remember the … most recently used items" setting in the Application preferences applies to all item types. So, if it's set to 15, BBEdit will remember 15 text documents, 15 folders, 15 projects, 15 images, and so on. If you want finer control, you can construct an expert pref using the name of the document type as it appears in the menu, and if that name contains spaces, you'll need to quote it. If you don't want to remember any recent documents of a particular type - they won't appear in the menu, either -, you can set its limit to 0 | Default: 15 | Range: — |
Recent Items: Remember ## Shell Worksheets | integer | The "Remember the … most recently used items" setting in the Application preferences applies to all item types. So, if it's set to 15, BBEdit will remember 15 text documents, 15 folders, 15 projects, 15 images, and so on. If you want finer control, you can construct an expert pref using the name of the document type as it appears in the menu, and if that name contains spaces, you'll need to quote it. If you don't want to remember any recent documents of a particular type - they won't appear in the menu, either -, you can set its limit to 0 | Default: 15 | Range: — |
Recent Items: Remember Temp Files | boolean | By default, BBEdit does not remember recent items opened from any of the canonical locations for temporary files. This also includes the "svn-commit.tmp" files used for Subversion commits. If desired, you can change this by setting this to 'true'. | Default: false | Range: — |
RememberFTPPasswordsbooleanRemember FTP Passwords | boolean | — | Default: true | Range: — |
Replace All Results Include Timing | boolean | If you want to amaze and impress your friends and family with just how fast BBEdit's "Replace All" is, set this to 'true'. When set to 'true', the sheet, or growl notification, will display the amount of time required for the "Replace All" operation. | Default: false | Range: — |
Report Nonzero Exit Code From Unix Filters | boolean | — | Default: true | Range: — |
ReportReplaceAllResultsbooleanReport Replace All Results | boolean | When performing a single-file "Replace All" operation, BBEdit can show a confirmation sheet showing the number of replacements performed. If you would like to see this confirmation, set this to 'true'. | Default: false | Range: — |
Reuse Search Results Windows When Possible | boolean | — | Default: true | Range: — |
ReverseSwipeNavigationSensebooleanReverse Swipe Navigation Sense | boolean | — | Default: false | Range: — |
RunUnixCommand_HistoryLimitintegerRun Unix Command: History Limit | integer | — | Default: 16 | Range: — |
RunUsingPython3booleanRun Using Python3 | boolean | When running a Python script, if python3 is anywhere in your $PATH, BBEdit will use it instead of python. While this is generally useful in a teaching environment, if you are using a custom Python installation (such as Anaconda), it may prove inconvenient. | Default: true | Range: — |
SafeSavesDisabledbooleanSafe Saves Disabled | boolean | — | Default: true | Range: — |
SaveDocumentStatebooleanSave Document State | boolean | — | Default: true | Range: — |
| boolean | By default, BBEdit will not store document state for documents located in any of the canonical locations for temporary files. This also includes the "svn-commit.tmp" files used for Subversion commits. If you wish, you can change this by setting this to 'true'. | Default: false | Range: — | |
Save Open With Data In Typeless Files | boolean | Prevent BBEdit from adding a filename extension. | Default: true | Range: — |
Save Titled Documents Before Sleeping | boolean | The "Sleep" command does not save any documents in place, since it creates an auto-save file for any open documents with unsaved changes. However, if you want BBEdit to save any titled - i.e. opened from an existing file - documents to disk before sleeping, you can set this preference to 'true'. | Default: false | Range: — |
ScanHTMLStringsForFunctionsbooleanScan HTML Strings For Functions | boolean | — | Default: false | Range: — |
Scan HTML Strings For Functions (Python) | boolean | — | Default: true | Range: — |
ScriptEditorBundleIDstringScript Editor Bundle ID | string | By default, BBEdit will open AppleScript files using whatever application the OS claims is capable of doing so. If you wish to override this, change the "ScriptEditorBundleID" preference to the bundle ID of your preferred script editor. | Default: "com.apple.ScriptEditor2" | Range: — |
Select First Placeholder In Completions | boolean | — | Default: true | Range: — |
SFTPConnectionTimeoutintegerSFTP Connection Timeout | integer | Most of the time, the default timeout for connecting to an SFTP server will suffice; however, if the server is heavily loaded it may take longer to respond. | Default: 20 | Range: — |
Show Anonymous Functions (ActionScript) | boolean | — | Default: true | Range: — |
Show Anonymous Functions (JavaScript) | boolean | — | Default: true | Range: — |
ShowFTPDotFilesbooleanShow FTP Dot Files | boolean | — | Default: false | Range: — |
ShowFullPathsInSearchResultsbooleanShow Full Paths In Search Results | boolean | If you like BBEdit to show the full paths of files listed in search results windows, set this to 'true'. | Default: false | Range: — |
Show Git Ignored Command Is Visible | boolean | — | Default: true | Range: — |
Show Language Setting In Shell Worksheets | boolean | — | Default: false | Range: — |
ShowSCMDataCommandIsVisiblebooleanShow SCM Data Command Is Visible | boolean | — | Default: false | Range: — |
ShowSVNSwitchedItemsbooleanShow SVN Switched Items | boolean | "Show Working Copy Status" for svn does not include switched items. If this affects you and you would prefer to see switched items, you may make them visibile by setting this to 'true'. | Default: false | Range: — |
Show Variables In Function List (PHP) | boolean | — | Default: false | Range: — |
Skip Node Modules When Scanning Folders | boolean | When scanning folders for various purposes (multi-file search, Find Differences, text factories, Open File by Name, and others), BBEdit will not explore node_modules directories that it encounters. If you want BBEdit to search node_modules directories turn this off. | Default: false | Range: — |
Skip SCM Admin Dirs When Scanning Folders | boolean | When scanning folders for various purposes - multi-file search, Find differences, and others -, SCM administrative directories are specifically ignored, even if "Search Invisible Folders" is turned on: CVS, .svn, .git, .hg, .bzr. This avoids potential disasters that can result from indiscriminate search and replace in such directories. If, however, you choose to live dangerously, you can allow BBEdit to see inside of these directories by setting this to 'false'. | Default: true | Range: — |
SortCompletionResultsByNamebooleanSort Completion Results By Name | boolean | — | Default: true | Range: — |
Sort Windows And Documents By Name | boolean | The Window menu and Windows palette will list windows (and documents within them) sorted by name. If you would like them to be sorted by windowing order turn this off. | Default: true | Range: — |
Spell Checker Context Menu Timeout | integer | — | Default: 750 | Range: — |
Spelling Word Completion Threshold | integer | — | Default: 3 | Range: — |
SSHServerKeepaliveIntervalintegerSSH Server Keepalive Interval | integer | If you have problems with your SSH server closing the connection after a period of non-use (which will subsequently cause errors in BBEdit), you can tell BBEdit to send a periodic "keepalive" message to while connected to the server. This is configurable per host, per domain, or globally. Determining the appropriate value may require some experimentation, but 90 seconds is probably a good starting point. | Default: 0 | Range: — |
Strict Counterpart Matching For C Languages | boolean | — | Default: true | Range: — |
Surf Next Previous In Display Order | boolean | When using the "Previous Document" and "Next Document" commands on the View menu, or the navigation arrows in the navigation bar, the order in which BBEdit navigates documents is determined by the order in which they were opened. If you prefer, these commands can be made to navigate the documents in the order shown in the file list by setting this to 'true'. | Default: false | Range: — |
Swipe To Navigate Between Documents | boolean | — | Default: true | Range: — |
TerminalBundleIDstringTerminal Bundle ID | string | The "Run in Terminal" and "Go Here in Terminal" commands will use Apple's "Terminal" application by default. If you would like to use a different one, set this here. | Default: "com.apple.Terminal" | Range: — |
Throttle Vertical Scrolling Speed | boolean | While drag-scrolling (that is, making a selection with the mouse and dragging it beyond the view boundaries, or using drag-and-drop for the same purpose), BBEdit will not normally limit the vertical scrolling speed. If this is too fast for you turn this off. | Default: true | Range: — |
Translate Line Breaks In Keyboard Input | boolean | — | Default: true | Range: — |
UsePATHForSSHbooleanUse $PATH For SSH | boolean | — | Default: true | Range: — |
UseClippingsForCompletionbooleanUse Clippings For Completion | boolean | If there is a partial word to the immediate left of the insertion point, the "Insert Clipping..." command will attempt to autocomplete that word based clipping names in the current and universal set (using a "begins with" style match.) If you wish to disable the autocompletion, set this preference to 'false'. | Default: true | Range: — |
Use Color Scheme Background For Dark Mode Ul | boolean | — | Default: true | Range: — |
UseDashForReferenceLookupsbooleanUse Dash For Reference Lookups | boolean | If Dash is installed, BBEdit will use it for "Find in Reference", in preference to any predefined or custom reference lookup URLs. You could, if you wanted, turn off Dash support by default and then enable it for specific languages. | Default: true | Range: — |
Use Distinct Colors For HTML Attributes And Values | boolean | — | Default: true | Range: — |
Use Flake For Python Syntax Checking | boolean | The Python language module will use flake8 for syntax checking, if you have it installed and it is available in your $PATH. If you want to disable this and use Python’s built-in syntax checking turn this off. | Default: true | Range: — |
Use Flake For Python Syntax Checking (Python) | boolean | — | Default: true | Range: — |
UseInlineStylesForCopiedHTMLbooleanUse Inline Styles For Copied HTML | boolean | The "Copy as Styled HTML" and "Save as Styled HTML" commands normally generate style information inline. If you want to use an embedded style sheet instead, set this to 'false'. | Default: true | Range: — |
Use Numeric Keypad For Cursor Movement | boolean | — | Default: false | Range: — |
Use Resource Fork For Document State | boolean | Beginning with version 8.0, BBEdit stores document state (window position and various settings) in a central repository in your BBEdit preferences folder. If you wish, you can ask BBEdit to store document state in the resource fork of the document's file by setting this to 'true'. | Default: false | Range: — |
Use Separators In Unix Script Output | boolean | Ordinarily, the output from Unix scripts run within BBEdit is delimited with line separators - except when the script output is sent to a new untitled document. If you wish to suppress the separators, you can set this to 'false'. | Default: true | Range: — |
UseSystemFontForLineBarbooleanUse System Font For Line Bar | boolean | BBEdit uses the document's display font to draw line numbers in the line number bar. This may be less than ideal if the display font isn't monospaced. If desired, you can instruct BBEdit to use the system font with monospaced numbers for the line number bar. | Default: false | Range: — |
UseTabKeyAsCompletionTriggerbooleanUse Tab Key As Completion Trigger | boolean | To use the Tab key to trigger text completion, set this preference to 'true'. | Default: false | Range: — |
Use Tokens From Document For Completion | boolean | — | Default: true | Range: — |
UseXMLMarkupRulesForHTML5booleanUse XML Markup Rules For HTML5 | boolean | Ordinarily, BBEdit will generate XHTML-style markup in HTML5 documents (those with a "<!DOCTYPE HTML>" declaration). If you wish, you can suppress this by setting this to 'false'. | Default: true | Range: — |
Visible Search Sources: Configured Web Sites | boolean | — | Default: true | Range: — |
Visible Search Sources: Disk Browsers | boolean | — | Default: true | Range: — |
Visible Search Sources: Frontmost Project | boolean | — | Default: true | Range: — |
Visible Search Sources: Open Documents | boolean | — | Default: true | Range: — |
Visible Search Sources: Projects | boolean | — | Default: true | Range: — |
Visible Search Sources: Recent Folders | boolean | — | Default: true | Range: — |
Visible Search Sources: Recent Xcode Projects | boolean | — | Default: true | Range: — |
Visible Search Sources: Results Browsers | boolean | — | Default: true | Range: — |
Visible Search Sources: Saved Search Sets | boolean | — | Default: true | Range: — |
Visible Search Sources: Saved Spotlight Searches | boolean | — | Default: true | Range: — |
WarnMalformedUTF8booleanWarn Malformed UTF8 | boolean | To control whether BBEdit warns you when opening a malformed UTF-8 file, set this to 'true'. | Default: true | Range: — |
Visible Search Sources: Saved Spotlight Searches | boolean | — | Default: true | Range: — |
Worksheet Notification Minimum Run Time | integer | — | Default: 10 | Range: — |
WriteEmacsStateOnSavebooleanVisible Search Sources: Saved Spotlight Searches | boolean | — | Default: false | Range: — |
WriteExtendedAttributesstringWrite Extended Attributes | string | By default, BBEdit will avoid writing extended attributes - HFS Type/Creator - to volumes which don't natively support them - i.e. to avoid creating the ._FILE - when it is safe to do so. We'll be able to re-open the document correctly later. If desired, you can fine-tune this behavior. | Default: "Smart" | Range: Always: Always write the HFS file type and creator (the pre-8.6 behavior) (Always), Never: Never set the HFS file type and creator (even if the document’s volume supports it) (Never), Smart: Write HFS file type and creator only if the document’s volume supports it (Smart) |
ZoomWindowsInPlacebooleanZoom Windows In Place | boolean | BBEdit attempts to move windows as little as possible when you zoom them. To override this and let BBEdit place the window in the upper left-hand corner of the screen, set this to 'false'. | Default: true | Range: — |
Move All Window types to active space | boolean | When using Spaces, you can control whether BBEdit's modeless dialog boxes - Find, Multi-File Search, and Open File by Name - get moved to the active space when switching spaces. By default, this is allowed for the Find, Multi-File Search, and Open File by Name windows. To control whether windows of these types are moved to the active space, set this to 'true'. This preference sets the default behavior for any of the defined window types for which a default is not explicitly specified. This key has been removed from BBEdit as of version 15. This has been replaced with MoveModelessWindowToActiveSpace. | Default: false | Range: — |
Move Find Window to Active Space | boolean | When using Spaces, you can control whether BBEdit's modeless dialog boxes - Find, Multi-File Search, and Open File by Name - get moved to the active space when switching spaces. By default, this is allowed for the Find, Multi-File Search, and Open File by Name windows. To control whether windows of these types are moved to the active space, set this to 'true'. This key has been removed from BBEdit as of version 15. This has been replaced with MoveModelessWindowToActiveSpace. | Default: false | Range: — |
Move Multi-File Find Window to Active Space | boolean | When using Spaces, you can control whether BBEdit's modeless dialog boxes - Find, Multi-File Search, and Open File by Name - get moved to the active space when switching spaces. By default, this is allowed for the Find, Multi-File Search, and Open File by Name windows. To control whether windows of these types are moved to the active space, set this to 'true'. This key has been removed from BBEdit as of version 15. This has been replaced with MoveModelessWindowToActiveSpace. | Default: false | Range: — |
Move Open File by Name Window to active space | boolean | When using Spaces, you can control whether BBEdit's modeless dialog boxes - Find, Multi-File Search, and Open File by Name - get moved to the active space when switching spaces. By default, this is allowed for the Find, Multi-File Search, and Open File by Name windows. To control whether windows of these types are moved to the active space, set this to 'true'. This key has been removed from BBEdit as of version 15. This has been replaced with MoveModelessWindowToActiveSpace. | Default: false | Range: — |
QuickTimeImagesboolean | boolean | BBEdit ordinarily recognizes image files as images, and will open them into image windows (or ignore them when filtering for text files). To have images possibly treated as text files, which can be potentially dangerous, set this to 'false'. This key has been removed from BBEdit as of version 15. | Default: true | Range: — |
ReopenRemoteDocumentsbooleanReopen Remote Documents | boolean | If set to 'true', BBEdit will attempt to mount a volume containing a document it wants to reopen. Defaults to 'false'. This key has been removed from BBEdit as of version 15. This has been replaced with ReopenDocumentsOnRemoteVolumes. | Default: false | Range: — |
SUAllowsAutomaticUpdatesbooleanAutomatic Update Install Prompt | boolean | Controls the automatic update install prompt. When enabled, presents users with the option to allow automatic download and install of available updates. If disabled, disallows automatic updates and requires manual installation every time. | Default: true | Range: — |
SUAutomaticallyUpdatebooleanEnable Automatic Silent Updates | boolean | Controls automatic silent updates. If enabled, users will not be informed about updates and updates will be silently installed when the app quits. | Default: false | Range: — |
SUEnableAutomaticChecksbooleanEnable Automatic Update Checks | boolean | Controls automatic update checks. | Default: true | Range: — |
SUFeedURLstringSparkle Feed URL | string | Setting this to a non-existent URL will disable the ability for users to manually check for updates. Useful when you intend to use your own software distribution mechanism to deploy updates. | Default: — | Range: — |
SUScheduledCheckIntervalintegerAutomatic Update Check Interval | integer | Controls the automatic update check interval. The default is 1 day (86400 seconds). Setting to 0 disables updates. | Default: 86400 | Range: — |