Jason Snell shows his rules and scripts to have Hazel auto-archive his old projects.
If you purchased Hazel 4 on or after Jan 1, 2020, you are eligible for a free upgrade. Claim your license here.
If you are running a previous version of Hazel, download the latest version and install it over your current version. Do not uninstall anything.
Once installed, you can either purchase in-app or via the site. Note that if you want to use PayPal, you must use the web store.
To purchase in-app:
- Under the “Hazel” menu, select “License”
- Click “Purchase”
- If your copy was registered for any previous version, it should show you the upgrade option. If it is showing the full version, use the web store or contact support.
- Fill out the fields as prompted.
- When your purchase is complete, your old license will be uploaded for you (to check eligibility) and your new one downloaded.
To purchase via the site:
- Go to web store.
- Enter “1” in the field for the Hazel 5 upgrade. Note that if you have a family pack, you still only need to purchase one upgrade.
- You will be prompted to upload your license file. If you cannot find it:
- Go to the Lost License page to have it re-sent.
- Complete your order as indicated.
- When your purchase is complete, you will be presented with links to download the software (if you hadn’t already) and your license file. Once the software is installed, double-click the license file to register the software.
If you need to restore your Hazel settings and rules from a backup, use this procedure:
- Quit System Preferences.
- Launch Activity Monitor. While in Activity Monitor, do the following:
- Find HazelHelper. Quit HazelHelper.
- Find cfprefsd. Quit any occurrences that you can (some may be for other accounts and you can’t kill them).
- Restore the following:
- In your Library/Application Support folder, the Hazel folder
- In your Library/Preferences folder, the files starting with com.noodlesoft.
If this doesn’t work, contact support.
What is Hazel 5?
Hazel 5 is the next version of Hazel. It makes a major change to how you use Hazel in that it will no longer be a preference pane. Instead it will be a standalone app. This had to be done to avoid many bugs and issues Apple introduced in Catalina in regards to preference panes.
What’s new in Hazel 5?
In the conversion to an app, Hazel has UI has been modified a bit. The folder list, rule list and rule editor are all in one window now, allowing for quicker navigation and viewing of rules. The rule editor is detachable, allowing you to compare rules side by side. Folders can now be grouped together. There are other improvements throughout the UI.
Hazel 5 also adds support for lists and tables. With the new custom list item attributes, you can match against a list, either entered directly into Hazel or read in from a file. With custom table attributes, you can match against a table, again enterable directly into Hazel or loaded via file. Once a custom table attribute matches, it keeps track of the row it matched. This allows you to use values in the same row from the other columns in other parts of your rule.
What are the system requirements?
Version 5 requires a Mac running macOS 10.13 (High Sierra) or later.
Is there Big Sur support?
Yes. Note that all efforts for Big Sur support are directed at Hazel 5. Because of the major changes from version 4 to 5, Hazel 4 will not be seeing these changes.
Is there Apple Silicon support?
Yes, though note that being a new platform, it will not be as well tested.
When will Hazel 5 be released?
Hazel 5 is available now.
How much will Hazel 5 cost?
Hazel 5 is $42 (USD) for a single user license while the family pack is $65.
Will there be upgrade pricing for existing users?
Yes, you can upgrade from any previous version for $20. The price is the same regardless of whether you have a single user license or family pack. Also, the upgrade will maintain the same type of license (single user to single user, family pack to family pack).
Wait, I bought Hazel recently. Do I have to pay again?
There are free upgrades for purchases made during 2020, because let’s face it, it’s been a horrible year. Click here to claim your free upgrade license.
How do I purchase a license for Hazel 5?
Check out this guide.
Will Hazel 5 keep all my rules and settings?
Yes, they should all carry over. That said, it’s always a good idea to keep good backups just in case you need to downgrade.
How do I install Hazel 5?
Download it from here. That will download a disk image. Open it and double-click the app inside. From there Hazel will instruct you on how to proceed.
Will Hazel replace my previous version?
Yes, it will remove any previous version you have from System Preferences. Do not click the “Uninstall” button in Hazel 4 and earlier as that will delete all your rules and settings. Hazel 5 shares rules and settings with previous versions, though it may update them on first launch.
I updated but the preference pane is still there.
Ok, so Hazel failed to remove the old one. You’ll want to remove it. See this article.
Since Hazel is now an app, do I need to keep it running?
No, Hazel still uses a helper app that runs in the background to run your rules and perform other duties. The app is only for viewing and editing your configuration/rules.
You can purchase a license from directly within Hazel itself (in-app) or via the web store.
The recommended way is to purchase in-app as it is the easiest method. It will automatically download and register your copy for you. Also, if purchasing an upgrade, Hazel’s in-app store will automatically detect if you are eligible and upload your old license for you.
In-app purchase does not support purchasing via PayPal so if that is your preferred payment method then you must use the webstore.
Note that regardless of which store you use, your information is encrypted and safe.
To purchase using the in-app store:
- Go to Hazel’s “Info” section.
- Click on the “Purchase” button.
- Specify which type of license you wish to purchase and then click “Next”
- Fill in your payment info then click “Purchase”
- Hazel will download your license and register your copy. You will also receive an email with your receipt/license file.
To purchase using the web store:
- Navigate to the web store here
- Enter the quantity for the type of license you wish to purchase.
- Select the payment method and then click “Continue”
- Enter your payment info and then click “Place Order”
- You will be presented with links to download the software and your license file. For instructions on how to install Hazel, click here. To register Hazel, click here. Make sure the software is installed before registering.
- You will also receive an email with your receipt/license file.
- Hazel is now an app, instead of a preference pane. Note that on first run, Hazel will remove the old preference pane. No settings should be affected and your rules will carry over.
- Hazel features a new user interface. The folder list, rule list and rule editor are all in one window now.
- Added custom list item attributes. These attributes allow you to match against an item in a list that you define. The list can either be entered directly in Hazel or loaded in from a file.
- Added custom table attributes. These attributes allow you to match against an item in a table. Once matched, any subsequent uses of that custom attribute will match against the same row, but it doesn’t have to be the same column. You can use this to match one thing and then use a corresponding thing elsewhere, either in a condition or action.
- The folder list supports folder groups.
- Rule editors can be detached so you can view multiple rules at time.
- The rule status interface is now a standalone window. While it does update as you change folders, you will still need to manually refresh it to catch any changes to rules or files.
- Preview mode will stick while navigating between different rules in the same ruleset.
- New UI guide for giving Hazel full disk access.
- Big Sur support.
- Support for Macs with Apple silicon. Note that this has not been tested as thoroughly.
- Bunches of other improvements.
User interface changes:
- Because of the major UI changes, many things have been moved around, including:
- Trash options are now in preferences.
- Folder options have their own window. You can access them via the menu or toolbar item (it is not in the toolbar by default but you can add it).
- Buttons to add folders/rules have been moved to the toolbar. To delete items, you can hit the delete key or use the “Delete” menu item under “Edit”
- Rule preview is accessible via the “Rule” menu instead of a dedicated button in the interface.
- Fixed crash when using keyboard navigation in some popovers.
- Fixed rule preview now showing any values for attributes when the condition is a “negative” one (like “is not blank”).
- Various other tweaks and fixes.
- Fixed bug that would sometimes occur when matching month names that have a dot in them. Some regions will use a dot in the abbreviated form of the month.
- Fixed issue with scheduling using “Current time” when trying to catch it within a 5 minute interval.
- When checking whether a thrown-away app is the last copy on the system, AppSweep should ignore secondary drives with macOS installs on them .
- Numerous updates and fixes.
- New “Treat as Path” option for text-based attributes. In “Sort into subfolder” patterns, you can now tell Hazel to treat the attribute as a path, specifying which character to use as the path separator. This is particularly useful when used in conjunction with the table feature, where you can specify a column which contains various subfolders to file things into.
User interface changes:
- Fixed various layout issues with the folder list.
- Fixed layout with the search toolbar item. Now takes into account its width when its expanded, which should address issues when using layout 3 for the main window.
- Rule actions should now take up more of the available horizontal space.
- Folder and rule lists now use the “inset” style on Big Sur.
- Fixed certain rule changes not registering.
- Fixed the active flag getting cleared when rule is saved.
- Fixed sync options not being available if the sync file is on a drive that is not available at the time.
- The feature where Hazel would ask to select a new folder if the original folder no longer exists has been added back in. Was lost in the version 4->5 transition.
- Fixed rule save/revert buttons scrolling out of view in certain cases.
- Fixed undo for enabling/disabling rules.
- With a search active, newly created/added rules will remain visible even if they don’t match the current search. Will disappear if the search text is changed and they do not match the new search criteria.
- You should no longer be able to create a new rule while the current one is unsaved.
- Alert when leaving an unsaved rule now has an option to save.
- Fixed rules not refreshing after changes to the sync settings.
- Rule status will now be brought forward whenever toolbar/menu item is invoked.
- Fixed some threading issues with Rule Status which would cause various glitches.
- Rule status should show updated file list when it is refreshed.
- Fixed file list in Rule Status not being sorted in some cases.
- Fixed crash when setting a table to use the first row for column names and the table file is empty.
- Keyboard navigation should now work in the “Replace Text” window.
- Fixed display issues when doing “Expand All”.
- Numerous other UI fixes and tweaks.
- Fixed start/stop state of background process not being observed/saved between machine reboots.
- Several changes made that should address AppSweep not triggering in certain cases.
- Fixed “is among the” type conditions when used in conjunction with certain types of conditions.
- Fixed using “starts with/ends with” with a custom attribute on the left-hand side of a condition.
- Import into TV action should no longer incorrectly report an error when successfully importing into the Library.
- Various internal fixes.
If you are coming from a previous version of Hazel, you may notice some things are no longer in the same place in Hazel 5. With the new UI, while most of the changes are pretty easy to figure out, some features may be harder to find. Some tips to make things easier:
- Hazel is an app but it still has background helpers to run your rules. That means that you don’t need to keep the app running. You only need it if you want to view or configure your rules and settings.
- Trash options are now found in Hazel’s preferences under the “Trash” tab.
- Folder options have their own window. You can access them either via the “Hazel→Folder Options” menu item or the toolbar. Note that the toolbar item for this is not in the default set and has to be added to the toolbar.
- Buttons to add folders and rules have been moved to the toolbar. To delete items, select them and press the “Delete” key or use the “Edit→Delete” menu item.
- Rule preview is accessible via the “Rule→Rule Preview” menu item. The dedicated button for it in the rule editor has been removed.
Hopefully this will make your transition to the new version much smoother.
How to use Hazel to import files into DEVONthink using the Global Inbox folder. No AppleScript needed.
Apple’s Mojave update introduced extra privacy protections, including controlling access to various parts of the filesystem. If you find yourself unable to select certain folders or have rules failing when trying to access certain locations, then you will need to authorize Hazel.
To give Hazel full disk access:
- Launch “System Preferences”
- Load Hazel and go to Hazel’s “Info” section.
- Hold down the option key. You will se a “Debug…” button appear. Click that button.
- Click on “Show HazelHelper in Finder”.
- Click “Done”.
- While still in System Preferences, navigate to the “Security & Privacy” pane. You can click here to jump directly to it.
- Select “Full Disk Access” in the list
- You may need to click the lock in the lower left corner to make changes. This will prompt you for your admin password.
- Take HazelHelper from the Finder window you opened earlier and drag it into the “Full Disk Access” list.
- Also, if you would like to preview rules or use the rule status UI (or just to get rid of the red badge on your folders), add System Preferences to the “Full Disk Access” list as well.
HazelHelper should appear in the list with its checkboxed checked. After that, Hazel should be able to access files it did pre-Mojave.