BBEdit 12.5.1 Release Notes

BBEdit 12.5.1 contains refinements to existing features and fixes for reported issues.

For details on all the new features and enhancements available in BBEdit 12, please see the release notes for BBEdit 12.5, BBEdit 12.1 and BBEdit 12.0, or browse the release notes archive.

For detailed information on using any of BBEdit's features, please refer to the user manual (choose "User Manual" from BBEdit's Help menu).


BBEdit 12.5.1 requires Mac OS X 10.12.6 or later, and is compatible with macOS 10.14 "Mojave".

If you are using macOS 10.13 "High Sierra", please make sure that you have updated to the latest available OS version (10.13.6 or later).

If you are using macOS 10.14 "Mojave", please make sure that you have updated to the latest available OS version (10.14.1 or later).


  • BBEdit 12.5.1 contains no new features. To see what new features were added in BBEdit 12.5, please consult its change notes.


  • Made a change so that Shift is now allowed to flip the sense of "Auto-Expand Tabs" when pressing the Tab key to insert text into a text document. Thus, if "Auto-Expand Tabs" is turned off, Shift-Tab in an editing view will insert spaces, otherwise it will insert a Tab.

    Note that this only occurs if there are no applicable options that would have been invoked by the Tab key (placeholder navigation, text completion, or Shift Left/Right).

    As before, Option-Tab always overrides such actions, so Option-Shift-Tab can be used to both override any actions and flip the sense of Auto-Expand Tabs on the fly.

  • If you are using Dropbox, BBEdit will now look in the "Apps" folder for its application support folder ($DROPBOX/Apps/BBEdit/), before it looks in the "Application Support" folder ($DROPBOX/Application Support/BBEdit/). The older location is still supported for compatibility with existing installations, but if you want to use Dropbox to share your BBEdit support folder, you should place it in Apps.

  • Changed the default for vertical scroll speed throttling to NO (its pre-12.5 behavior) and adjusted the Expert Preferences help accordingly.


  • Changed the minimum size for FTP/SFTP browser windows so that they can be made narrower than was previously possible in 12.x generations.

  • Fixed bug in which trying to cancel installation of our authenticated-operations helper would fail to cancel whatever operation needed its help.

  • Fixed a bug in which file names which exactly matched claims by a language module (e.g. CMakeLists.txt and the CMake module) weren't mapped correctly when the filename extension matched something else (like .txt).

  • When dragging text to the sidebar, if the text contained non-file, ftp, or sftp URLs, a -1708 error would result. Those URLs are now ignored.

  • Fixed crash which would occur at startup in cases where the "Language Modules" support folder didn't exist, and the permissions of the BBEdit support folder didn't allow BBEdit to create it.

  • Fixed a bug in which using "Save [a Copy] to FTP/SFTP Server" would sometimes crash when applied to a file on an FTP (not SFTP) server.

  • Fixed a bug in which the "(none)" item in the Current Language status bar menu was always checked in addition to the document's actual language setting (when it was something else).

  • Removed mention of Perforce from the expert preferences, since it is no longer applicable.

  • Fixed a bug in which the Java scanner would hang in some situations, mostly involving being asked to process files which were manifestly not Java source.

  • Fixed bug in which BBEdit didn't ask the OS to create a version snapshot when saving a document.

  • Made a change to the image viewer so that the image is scaled into the view area, rather than allowing scrollbars.

  • The bbdiff(1) tool now accepts -w as a synonym for --wait, and -V as a synonym for --short-version. The man page and usage info have been updated to include this.

  • Because aliasing or symlinking the BBEdit application support folder is not supported, the application will now alert you at startup if it finds that you have done so.

  • Items in folder-backed menus (Scripts, clippings, and others) whose names contain slashes will now display correctly in the menu.

  • Fixed bug in which choosing the "Manage Filters" item from either of the filter popups in the Multi-File Search window would leave that popup stuck on "Manage Filters". (It didn't affect filtering, only the display of the popup button.)

  • Fixed bug in which changing the check box settings ("Use custom highlight colors", "Highlight insertion point") in a Color Scheme document did not mark the document as needing to be saved.

  • Fixed bug in which attempting to use the "Pretty Print" markup format option would fail and report an error when a customized profile was present in the BBEdit application support folder.

  • Fixed bug in which the text entry boxes in the Text Factory "Replace All" sheet were not readable when in Dark Mode.

  • Corrected appearance of the "Find Definition" listing panel when in Dark Mode.

  • Fixed a bug in which the Software Update progress window would remain on screen in cases where extracting or verifying the download package failed.

  • Fixed bug which would cause a -50 error to be reported when trying to save changes to a document opened by browsing a Zip (or Zip-like) archive.

  • Increased the timeout when requesting the current runtime environment, to handle cases in which the user's login shell takes a long time to return data from a printenv command. This may address cases in which PATH and other environment variables are incorrect when running a #! script.

  • Fixed a bug in which the Swift language module would generate invalid run data in certain situations, which would in turn crash the balancer (including Balance while Typing). The Swift module has been corrected, and the balancer has been hardened so that this doesn't happen again.

  • Fixed a crash which could (very occasionally) occur when opening or saving a document via SFTP. This lurking horror from beyond space-time was vanquished by a sparkly princess riding a unicorn. (Rude not to, really.)

  • Made a change to fix a reported crash when trying to use the Commands window (although there's still no clear explanation of what triggers this particular condition).

  • Restored the font- and size-specific smoothing expert preferences, so that bitmapped font rendering is again allowed. However, unlike previous versions, this is only possible when the window being displayed is on a non-Retina ("@1x") display.

  • Fixed crash which was triggered by doing an "Open Selection" or "Open File by Name" operation in a shell worksheet.

  • Fixed a cosmetic issue in which the system monospaced-digit font was used in places where doing so did not improve readability. (That's polite-speak for "it looked really janky.").