→    Contents  ToothFairy Manual  Translate  Technical Support

7   Version History

2.8.4—March 6, 2024
  • The battery info updates more quickly after connecting a device.
  • The Run shell script after connecting/disconnecting help page now explains how to trigger a shortcut.
  • ToothFairy is better at remembering the current sound input device so that the Improve sound quality by disabling audio input from device feature will restore the proper one after connecting a new device.
  • You can now pull down a device’s menu while the connection progress indicator is spinning.
  • ToothFairy no longer shows arrow icons while it’s in the process of fixing the sound output, as this was confusing. Instead, it will continue showing the device as half-connected until it’s done. You can still see what’s happening with the fixing via the tooltip and the menu item text.
  • If the feature to fix the sound output is disabled, clicking the half-connected device icon now disconnects the device instead of doing nothing.
  • Each help page now has a link to a Google translation so you can view it in a different language.
  • Updated the French localization.
  • Fixed a bug where the progress indicator wouldn’t stop if you clicked the menu bar icon when using the Don’t disconnect when clicking icon or pressing hotkey option.
  • Made various fixes and updates to prevent Cocoa from logging warnings.
  • Made various threading improvements.
  • The build number is now displayed in a tooltip in the About tab.
  • Mac App Store receipt validation works better on Macs with damaged Ethernet ports.
  • The Setapp version of ToothFairy now requires macOS 12 or later, due to updating to version 4.1.0 of their framework.
2.8.3—January 11, 2023
  • Made various improvements to the workaround for the macOS issue that could prevent the sound output from being set when connecting a device. The workaround is successful more often, avoids unnecessary disconnections when the sound output spontaneously fixes itself, and it better handles devices that have been put away or manually disconnected.
  • The menu bar icon now shows when ToothFairy is fixing the sound output. An arrow in a solid circle indicates that the device is currently connected but in the process of disconnecting. An arrow with no circle indicates that the device is waiting to reconnect.
  • ToothFairy no longer reports that the sound output is not set when the device isn’t connected, anyway.
  • Fixed a problem where the progress spinner could stay visible forever, even after the device disconnected.
  • Fixed a problem where ToothFairy could show a Bluetooth connection failure error message for connections that the user did not initiate.
2.8.2—October 12, 2022
  • Added new device icons for AirPods 3, AirPods Pro 2, Beats Fit Pro, Beats Studio Buds, Galaxy Buds Live, AfterShokz Aeropex, Sony WF-1000XM4, and Sony WH-1000XM4.
  • Organized the device icons in the pop-up menu into groups and added tooltips.
  • Worked around some macOS issues that could prevent a Bluetooth device from being set as the current sound output device in various circumstances, such as if it was already connected to an iPhone.
  • Updated the menu titles from Preferences… to Settings….
  • Made various code modernizations, including the way keyboard shortcuts are saved to the preferences file.
  • ToothFairy now requires macOS 10.13 or later.
  • There is now a RunConnectionScriptWhenSettingAudioOutput esoteric preference for the Run shell script after connecting/disconnecting option.
2.8.1—June 27, 2022
2.8—May 11, 2022
  • If a Bluetooth audio device is connected but is not selected as the sound output device—as can happen if you are using Automatic Device Switching—ToothFairy now shows its menu bar icon as solid but faded out.
  • Telling ToothFairy to connect to a Bluetooth device that’s connected but not the current sound output device will now set it as the sound output device instead of disconnecting.
  • ToothFairy is better at detecting when a Bluetooth device has connected or disconnected in cases where macOS did not notify it.
  • ToothFairy now converts carriage returns to line breaks when saving a script, as improper line breaks can prevent scripts from running.
  • Updated the How can I turn off Automatic Device Switching? section of the manual.
  • Worked around a macOS issue where sometimes a Bluetooth audio device would connect without being set as the sound output target.
  • Worked around a macOS issue where an incorrect Bluetooth device name could be shown after disconnecting and reconnecting.
  • Worked around some macOS issues that could cause crashes when reading battery information or adding a new Bluetooth device.
  • Fixed a bug where the spinning progress indicator would be drawn for Light Mode when the Mac was running in Light Mode but the transparent menu bar was showing a dark desktop picture underneath. ToothFairy now treats this as de facto Dark Mode to make the progress indicator easier to see and match the rest of the menu bar content.
  • Fixed a bug where the progress indicator for a device icon could be drawn on top of it.
  • Fixed a bug where a connection or disconnection script could be run multiple times for the same event.
  • Fixed a bug where device names were prematurely truncated in the preferences table view.
2.7.8—January 4, 2022
  • Worked around an issue with macOS 12 where it was sometimes impossible to add a Bluetooth device to ToothFairy because the Select button was disabled. In such cases, you can now enter the device’s address to add it.
  • Improved the accuracy of the battery status indicator on macOS 12.
  • Made some enhancements to make Bluetooth troubleshooting easier.
  • Improved the Why isn’t my device connecting? section of the manual.
  • Improved the diagnostic report.
2.7.7—November 18, 2021
  • Worked around an issue that could cause ToothFairy to crash on macOS 12 Monterey.
2.7.6—November 16, 2021
  • Worked around an issue that could cause ToothFairy to hang on macOS 12 Monterey.
2.7.5—November 12, 2021
  • Improved the battery status indicator on macOS 12 Monterey.
  • Improved the How can I turn off Automatic Device Switching? section of the manual.
  • Added French localization.
  • ToothFairy now declares notch compatibility for the new MacBook Pros.
2.7.4—July 28, 2021
2.7.3—April 12, 2021
2.7.2—January 15, 2021
  • Fixed a bug that could cause ToothFairy to crash at launch on some Macs.
2.7.1—January 14, 2021
  • ToothFairy now runs natively on Apple Silicon Macs.
  • Added icon for AirPods Max.
  • The Run shell script after connecting/disconnecting section of the manual now has a sample script to connect the device to another Mac when disconnecting from the current one.
  • The Run shell script after connecting/disconnecting section of the manual now has a sample script that shows how to change the volume.
  • Worked around an issue that could prevent ToothFairy from launching on Macs with certain network configurations.
  • Fixed an issue adding new Bluetooth devices on macOS 11.
2.7—November 3, 2020
  • Redesigned the application icon for macOS 11 Big Sur.
  • Added new icons for AirPods Pro, Beats Studio 3, controller, headphones, Playstation, Powerbeats 2020, Siri Remote, and Xbox.
  • Added AppleScript support for listing devices, getting their properties, and toggling connections.
  • If the Don’t disconnect when clicking icon or pressing hotkey option is enabled for a device, you can now access that device’s menu with a regular click, rather than having to right-click or Control-click.
  • The Improve sound quality by disabling audio input from device option now works better when a Bluetooth device auto-connects rather than being connected via ToothFairy. It’s also more reliable in cases where macOS reports that it has set the audio input device but actually hasn’t.
  • Improved resizing the Advanced… preferences sheet.
  • The Advanced… preferences sheet now has a help button that explains the options and shows sample shell scripts and AppleScripts.
  • Updated the sample scripts in the Run shell script after connecting/disconnecting section of the manual.
  • Worked around an issue with macOS 11 where text in the device list would be vertically clipped.
  • Worked around some security changes in macOS 11 that made it impossible to save script changes.
  • Fixed a bug where ToothFairy could stuck in an error reporting loop if there was an error saving the scripts.
2.6.2—June 2, 2020
  • The How can I switch back to an iPhone or other Mac? section of the manual now describes how you can make your iPhone automatically switch back to AirPods (or another chosen Bluetooth device) when you open certain apps.
  • Added the How can I rename a Bluetooth device? section of the manual.
  • If macOS forgot that ToothFairy was set as a login item, it will now repair this at launch without your having to click the preferences checkbox.
  • Improved the Improve sound quality by disabling audio input from device and Why isn’t my device connecting? sections of the manual.
  • Adjusted the icons so that if you have a keyboard next to a trackpad, they line up.
  • The offset disconnected AirPods icon no longer looks uncentered.
  • Added Czech and Dutch localizations.
  • Fixed a bug where the Preferences window could be inappropriately shown at launch due to an interaction between macOS state restoration and the login item.
  • Tried to fix a crash due to a macOS bug after adding a new Bluetooth device.
2.6.1—December 30, 2019
  • Improved the details in the AirPods Pro icon.
  • Added another variant of the AirPods icon that’s slightly smaller, because some people prefer that size and also to help differentiate for those who have multiple pairs of AirPods.
  • The game controller icon no longer shows a wire.
  • You can now hold down the Option key when opening the icon pop-up menu to see the filled versions of the icons.
  • ToothFairy is faster at detecting when a device’s connection has been dropped without macOS noticing.
  • The How can I switch back to an iPhone or other Mac? section of the manual now tells how you can make a Siri shortcut to quickly switch an iOS device to a given audio device.
  • Updated the Adding a Device and Why isn’t my device connecting? sections of the manual.
  • When the Preferences window is already open, choosing the Preferences… menu command for a device will now select that device.
  • Closing the Advanced sheet now preserves the selected device.
2.6—October 29, 2019
  • Added icons for AirPods Pro, Beats X, Microsoft Surface Earbuds, and an alternate icon for a pair of regular AirPods that are positioned symmetrically rather than offset.
  • Adjusted the way battery levels map to gradations in the menu bar gauge.
  • Added a button to the About tab to open the ToothFairy manual.
  • Worked around a macOS bug that could prevent launching the app after using AirPlay.
  • Fixed a regression where the battery level wasn’t shown if it was exactly 100%.
  • Modernized the localizations.
  • Reduced the size of the app.
2.5.1—October 1, 2019
  • The battery gauge uses twice as many gradations as before to show the battery level more precisely.
  • The Control-click menu now shows the battery percentage on a separate line, to avoid having such a wide menu item.
  • If you rename a Bluetooth device, the name now updates in ToothFairy without having to relaunch the app.
  • The Bluetooth devices are now sorted by name in the Preferences window.
  • Adjusted the battery level tooltip text so that it doesn’t look funny if only one of the AirPods is connected.
  • Worked around a crash on macOS 10.15 that could occur if the system asked you for permission to allow ToothFairy to control your Bluetooth device and you declined.
  • Worked around a potential crash that could occur if a Bluetooth device’s name couldn’t be loaded.
  • All the settings are now documented in the manual.
2.5—April 17, 2019
  • Added menu bar icons for more devices: pair of AirPods, Powerbeats3, Powerbeats Pro, Beats Solo, headset, speakers (boombox, conference, cylinder, desktop, vertical), graphics tablet, game controller, Magic Mouse, 2-button mouse, Magic Trackpad 2 (top and side views), Magic Trackpad 1 (side view), iPhone, and tablet.
  • Clicking on a device in the menu bar now shows a menu with its name, connection status, and battery level, so you can see the information immediately instead of waiting for the tooltip to appear.
  • The Preferences window now explains that you can right-click (or Control-click) the menu bar icon to access the preferences when the Dock icon is hidden.
  • The Preferences window now explains that showing the battery status requires a device whose battery level appears in the Bluetooth pane in System Preferences.
  • Tweaked various Preferences window text to clarify the icon and audio input settings and how the new Apple H1 chip fits in.
  • Improved the Why don’t I see the battery level? and Why isn’t my device connecting? sections of the manual.
  • When reporting a Bluetooth error, ToothFairy now includes the hex code and error name to help look up the exact cause of the problem.
  • Fixed a regression where changing the icon didn’t work on macOS 10.11.
  • Updated code for Xcode 10.2 and Swift 5.
2.4.9—January 29, 2019
  • ToothFairy no longer shows an error window when you try to connect to a device that’s already connected.
  • ToothFairy now automatically retries connecting via Bluetooth to make it more likely that it will succeed without user intervention.
  • Improved the Why isn’t my device connecting? section of the manual.
  • Added the Why don’t I see the battery level? section of the manual.
  • Added accessibility labels for the device icon menu and menu bar status icon.
  • ToothFairy is more judicious about changing the audio input device, to avoid excessive Micro Snitch notifications.
  • Fixed a bug where some script text could be displayed with the wrong color in Dark Mode.
2.4.8—November 7, 2018
  • If there’s an error connecting to your Bluetooth device, ToothFairy now recommends to you how you can fix it.
  • Improved the wording in various user interface text.
  • Fixed a bug where the menu bar background color when clicking on the menu didn’t match the accent color on macOS 10.14 or the Graphite appearance on earlier versions.
  • Added the Why isn’t my device connecting? and Why do I see the Dock icon even after hiding it? sections of the manual.
  • The Credits sheet now links to the privacy policy.
  • Added accessibility descriptions in the Preferences window.
  • Improved the diagnostic report.
  • Error logging now includes more information about the error and the device it’s related to.
2.4.7—August 14, 2018
  • Added support for Dark Mode on macOS 10.14.
  • Revised various preferences text to improve clarity. For example:
    • Global hotkey to switch connection is now Global hotkey to connect/disconnect.
    • Hide dock icon (effect after next launch) is now Hide Dock icon (takes effect at next launch).
    • Audio output only is now Improve sound quality by disabling audio input.
    • Connection only mode is now Don’t disconnect when clicking icon or pressing hotkey.
  • Fixed a bug where the Audio output only option didn’t work, causing AirPods to be inappropriately set as the system audio input device.
  • Added the Save Diagnostic Report button.
  • Reduced the size of the application by having ToothFairy and its login item helper share the same copy of the Swift libraries.
  • Fixed the minimum widths of the OK buttons.
  • Reformatted the text in the credits sheet with fonts, styles, and clickable links.
2.4.6—July 11, 2018
  • The shell script text views now use a monospaced font for better readability of punctuation characters.
  • The shell script text views now disable automatic quote and dash substitution so that you don’t accidentally get smart punctuation in your scripts.
  • Fixed a bug where opening the Preferences window didn’t always bring it to the front.
  • Fixed a bug where the disconnection script was not run.
  • Fixed a bug where there was extra space at the end of the tooltip when hovering over the menu bar icon.
  • Fixed a bug where some of the menu bar icons were not centered when the battery indicator was visible.
  • Updated the German localization.
2.4.5—June 14, 2018
  • C-Command Software has acquired ToothFairy from the original developer, Yibin (Robin) Lu, who was no longer able to work on the app. We thank Robin for his work and look forward to continuing development of the app.
  • Restored compatibility with macOS 10.11.
  • The right-click menu now appears on mouse down instead of mouse up, for consistency with other menus.
  • Updated the copyright and credits.
  • Renamed the app from Tooth Fairy to ToothFairy.
  • Fixed a bug where the credits sheet didn’t have a minimum width.
  • Removed an .sdef file that’s not actually used.
 →    Contents  ToothFairy Manual  Translate  Technical Support