notify

notify 9.0.0-rc.4 (2026-05-02)

• CHANGE: preserve watched path representation in Event.paths and Watcher::watched_paths; relative watch paths now produce relative event paths consistently across backends [#453] [#740]
• FIX: [kqueue] stop reporting arbitrary existing child paths for non-recursive directory write events [#644]
• FIX: replace an existing watch when watch is called again for the same path, avoiding duplicate FSEvent paths and leaked Windows watch handles [#708]
• DOCS: define Watcher::watch replacement behavior for an existing backend-resolved path [#708]

• CHANGE: preserve watched path representation in Event.paths and Watcher::watched_paths; relative watch paths now produce relative event paths consistently across backends [#453] [#740]
• FIX: [kqueue] stop reporting arbitrary existing child paths for non-recursive directory write events [#644]
• FIX: replace an existing watch when watch is called again for the same path, avoiding duplicate FSEvent paths and leaked Windows watch handles [#708]
• DOCS: define Watcher::watch replacement behavior for an existing backend-resolved path [#708]

notify 9.0.0-rc.3 (2026-04-16)

• CHANGE: raise MSRV to 1.88
• FEATURE: add Watcher::watched_paths to list active watches as (PathBuf, RecursiveMode) pairs across supported backends
• FIX: [windows] normalize emitted event paths to follow the watched path separator style and trim leading separators; add Config::with_windows_path_separator_style for explicit control #375
• FIX: [windows] make unwatch() wait until the watch is fully removed so later filesystem changes do not leak events #730
• FIX: [macOS] annotate FSEvents clone-related events with info = "is: clone" #465
• FIX: avoid panicking in unwatch when internal mutexes are poisoned
• CHANGE: add #[must_use] annotations to builder, constructor, and getter-style APIs such as Config, PathOp, and Error

• CHANGE: raise MSRV to 1.88
• FEATURE: add Watcher::watched_paths to list active watches as (PathBuf, RecursiveMode) pairs across supported backends
• FIX: [windows] normalize emitted event paths to follow the watched path separator style and trim leading separators; add Config::with_windows_path_separator_style for explicit control #375
• FIX: [windows] make unwatch() wait until the watch is fully removed so later filesystem changes do not leak events #730
• FIX: [macOS] annotate FSEvents clone-related events with info = "is: clone" #465
• FIX: avoid panicking in unwatch when internal mutexes are poisoned
• CHANGE: add #[must_use] annotations to builder, constructor, and getter-style APIs such as Config, PathOp, and Error

notify 9.0.0-rc.2 (2026-02-14)

• FEATURE: remove Watcher::paths_mut and introduce update_paths #705
• FEATURE: impl EventHandler for futures::channel::mpsc::UnboundedSender and tokio::sync::mpsc::UnboundedSender behind the futures and tokio feature flags #767
• FIX: [macOS] prevent handler panicking in the FSEvents callback panics #790
• FIX: [macOS] prevent panicking when path contains non UTF-8 chars #790
• FIX: [linux] fix a TOCTOU issue when adding a watcher #792
• FIX: [linux] surface inotify UNMOUNT events to users and clean up affected watches #627
• FIX: [macOS] remove FSEventsPurgeEventsForDeviceUpToEventId call #795

• FEATURE: remove Watcher::paths_mut and introduce update_paths #705
• FEATURE: impl EventHandler for futures::channel::mpsc::UnboundedSender and tokio::sync::mpsc::UnboundedSender behind the futures and tokio feature flags #767
• FIX: [macOS] prevent handler panicking in the FSEvents callback panics #790
• FIX: [macOS] prevent panicking when path contains non UTF-8 chars #790
• FIX: [linux] fix a TOCTOU issue when adding a watcher #792
• FIX: [linux] surface inotify UNMOUNT events to users and clean up affected watches #627
• FIX: [macOS] remove FSEventsPurgeEventsForDeviceUpToEventId call #795

notify 9.0.0-rc.1 (2026-01-25)

• CHANGE: raise MSRV to 1.85 breaking
• CHANGE: [macOS] replace fsevent-sys with objc2-core-foundation and objc2-core-services #726
• FEATURE: add EventKindMask for filtering filesystem events #736
• FIX: Fix the bug that FsEventWatcher crashes when dealing with empty path #718
• FIX: Fix the bug that INotifyWatcher keeps watching deleted paths #720
• FIX: Fixed ordering where FsEventWatcher emitted Remove events non-terminally #747
• FIX: [macOS] throw FsEventWatcher stream start error properly #733

[!IMPORTANT] The MSRV policy has been changed since this release. Check out README for details.

• CHANGE: raise MSRV to 1.85 breaking
• CHANGE: [macOS] replace fsevent-sys with objc2-core-foundation and objc2-core-services #726
• FEATURE: add EventKindMask for filtering filesystem events #736
• FIX: Fix the bug that FsEventWatcher crashes when dealing with empty path #718
• FIX: Fix the bug that INotifyWatcher keeps watching deleted paths #720
• FIX: Fixed ordering where FsEventWatcher emitted Remove events non-terminally #747
• FIX: [macOS] throw FsEventWatcher stream start error properly #733

notify 8.2.0 (2025-08-03)

• FEATURE: notify user if inotify's max_user_watches has been reached #698
• FIX: INotifyWatcher ignore events with unknown watch descriptors (instead of EventMask::Q_OVERFLOW) #700

debouncer-full 0.6.0 (2025-08-03)

• FEATURE: allow FileIdCache trait implementations to choose ownership of the returned file-ids #664
• FEATURE: added support for the flume crate #680
• FIX: skip all Modify events right after a Create event, unless it's a rename event #701

debouncer-mini 0.7.0 (2025-08-03)

• FEATURE: added support for the flume crate #680

file-id 0.2.3 (2025-08-03)

• CHANGE: implement AsRef<FileId> for FileId #664

Full Changelog: notify-8.1.0...notify-8.2.0

• FEATURE: notify user if inotify's max_user_watches has been reached #698
• FIX: INotifyWatcher ignore events with unknown watch descriptors (instead of EventMask::Q_OVERFLOW) #700

• FEATURE: added support for the flume crate
• FIX: kqueue-backend: do not double unwatch top-level directory when recursively unwatching [#683]
• FIX: Return the crate error PathNotFound instead bubbling up the std::io error [#685]
• FIX: fix server hangs when trashing folders on Windows [#674]

• CHANGE: update notify-types to version 2.0.0
• CHANGE: raise MSRV to 1.77 breaking
• FEATURE: add config option to disable following symbolic links #635
• FIX: unaligned access to FILE_NOTIFY_INFORMATION #647 breaking

• CHANGE: raise MSRV to 1.72 #569 #610 breaking
• CHANGE: move event type to notify-types crate #559
• CHANGE: flatten serialization of events and use camelCase #558
• CHANGE: remove internal use of crossbeam channels #569 #610
• CHANGE: rename feature crossbeam to crossbeam-channel and disable it by default #610 breaking
• CHANGE: upgrade mio to 1.0 #623
• CHANGE: add log statements #499
• FIX: prevent UB with illegal instruction for the windows backend #604 #607
• FIX: on Linux report deleted directories correctly #545
• FIX: on Linux report access open events #612
• FEATURE: enable kqueue on iOS #533
• MISC: various minor doc updates and fixes #535 #536 #543 #565 #592 #595
• MISC: update inotify to 0.10 #547

• CHANGE: remove serde binary experiment opt-out after it got removed #530

• CHANGE: opt-out of the serde binary experiment by restricting it to < 1.0.172 #528
• CHANGE: license changed to only CC0-1.0 #520
• CHANGE: use logging #499
• CHANGE: upgrade windows-sys to 0.48 #479
• CHANGE: bump filetime to 0.2.22 #521
• FEATURE: support manual polling of PollWatcher and disabling automatic polling #524
• FEATURE: support listening to the initial pollwatcher file scan #507
• FIX: fix moved folders not being watched on linux #498
• FIX: fixup potential future double free on windows #517
• FIX: require bitflags only on macos and upgrade the crate #505
• DOCS: add more known issues, typos and cleanup examples #523 #502 #522

• DOCS: fix swapped debouncer-full / -mini links in the readme/crates.io 4be6bde

• CHANGE: files and directories moved into a watch folder on Linux will now be reported as rename to events instead of create events #480
• CHANGE: on Linux rename from events will be emitted immediately without starting a new thread #480
• CHANGE: raise MSRV to 1.60 #480

• CHANGE: implement Copy for EventKind and ModifyKind #481

• CHANGE: switch from winapi to windows-sys #457
• FIX: kqueue-backend: batch file-watching together to improve performance #454
• DOCS: include license file in crate again #461
• DOCS: typo and examples fixups

For a list of changes when upgrading from v4 see UPGRADING_V4_TO_V5.md.

Differences to 5.0.0-pre.16:

• FIX: update minimum walkdir version to 2.2.2 #432
• CHANGE: add need_rescan function to Event, allowing easier detection when a rescan is required #435
• FIX: debouncer-mini: change crossbeam feature to crossbeam, to allow passthrough with notify re-exports #429
• DOCS: improve v5-to-v5 upgrade docs #431
• DOCS: file back v4 changelog into main #437
• DOCS: cleanups and link fixes

• CHANGE: require config for watcher creation and unify config #426
• CHANGE: fsevent: use RenameMode::Any for renaming events #371
• FEATURE: re-add debouncer as new crate and fixup CI #286
• FEATURE: allow disabling crossbeam-channel dependency #425
• FIX: PollWatcher panic after delete-and-recreate #406
• MISC: rework pollwatcher internally #409
• DOCS: cleanup all docs towards v5 #395

• CHANGE: raise MSRV to 1.56! #396 and #402
• FEATURE: add support for pseudo filesystems like sysfs/procfs #396
• FIX: Fix builds on (Free)BSD due to changes in kqueue fix release #399

• CHANGE: upgrade mio to 0.8 #386
• CHANGE: PollWatcher: unify signature of new and with_delay #360
• CHANGE: emit EventKind::Modify on kqueue write event #370
• CHANGE: use RenameMode::Any for renaming events #371
• CHANGE: name all threads spawned by notify #383
• FEATURE: Add Watcher::kind() #364
• FEATURE: Add more Debug/Copy trait impls #377 #378
• FIX: Fix selection of RecommendedWatcher for macos_kqueue feature #362
• FIX: Turn possible panic into an error in FSEvents backend when file is deleted rapidly #369
• FIX: lqueue: emit Create Events and watch all files in a directory #372
• FIX: inotify: don't panic on shutdown #373

• Fix: Add path information to inotify and kqueue watch/unwatch errors #354
• Fix: Delete dbg call from kqueue.rs #357

• CHANGE: Move creation of watcher into trait #345
• CHANGE: Add EventHandler trait to replace EventFn #346
• FIX: Fix build failure on x86_64-unknown-netbsd #347

• FEATURE: Add Kqueue backend for use on BSD #335
• CHANGE: Change EventFn to take FnMut #333
• CHANGE: Make Watcher object safe #336
• FIX: Join thread in fseven on shutdown #337
• FIX: Only check for ENOSPC on inotify_add_watch in inotify #330
• FIX: Free context when stream is deallocated in fsevent #329
• DOCS: Fix missing comma in docs #340

• FIX: Make StreamContextInfo Send to fix soundness issue #325

• DEPS: Upgrade fsevent-sys dependency to 4.0 #322
• CHANGE: Remove dependency on fsevent. #313
• FIX: Correct the return type for CFRunLoopIsWaiting to be Boolean #319
• CHANGE: Hide fsevent::{CFRunLoopIsWaiting,callback}, fix clippy lint warnings #312
• FIX: Fix some clippy lints #320

• HOTFIX: Fix breaking change in fsevent-sys in minor version destroying builds #316
• FIX: Don't crash on macos when creating & deleting folders in rapid succession #302
• FIX: Remove anymap, and replace event attributes with an opaque type. #306

• FIX: Display proper error message when reaching inotify limits on linux #285
• FIX: Fix leaks on Windows #298

• FIX: Handle interrupted system call errors from mio #281

• RUSTC: Push the minimum version to 1.47.0 #280
• DEPS: Update inotify to 0.9 #280
• DEPS: Update mio to 0.7 and remove mio-extras #278
• FIX: Report events promptly on Linux, even when many occur in rapid succession. [#268]

• CHANGE: Avoid stating the watched path for non-recursive watches with inotify #256
• DOCS: Fix broken link in crate documentation #260

• DEPS: Removed unused chashmap dependency #242

• (Temporary): Remove event debouncing.
• (Temporary): Remove tests.
• CHANGE: Rewrite immediate events to use new system.
• CHANGE: Remove Senders from watcher API in favour of EventFn #214
• DEPS: Update inotify to 0.8. #234
• DEPS: Update crossbeam-channel to 0.4.
• DEPS: [macOS] Update fsevent to 2.0.1 and fsevent-sys to 3.0.0.

(no changes, just a new release because the old one failed to publish properly)

• yanked 2019-06-30
• RUSTC: Push the minimum version to 1.36.0 #201
• RUSTC: Switch the crate to Rust 2018.
• FIX: Implement Sync for PollWatcher to support FreeBSD. #197
• FEATURE: Add new runtime configuration system.
• FEATURE: Add Ongoing events (optional, configured at runtime). #146, #183
• FEATURE: Bring in new event system from next branch. #187
• FEATURE: Allow multiple watchers to send to the same channel. 2a035c86
• CHANGE: Switch to crossbeam channel. #160
• CHANGE: Rename Chmod to Metadata. #179, #180, previously #112, #161
• CHANGE: Remove DebouncedEvent event classification. #187
• DEPS: [Linux] Upgrade inotify to 0.7. #184
• DEPS: [macOS] Upgrade fsevent to 0.4. #195
• DEPS: Upgrade filetime to 0.2.6.
• META: Rename v4-legacy branch to main, to further clarify status and prepare for a breaking release.
• DOCS: Change v5 to Next Generation Notify to allow for a breaking release.
• DOCS: Add rust-analyzer to Readme showcase.
• DOCS: Add github issue / PR templates and funding.

• FIX: Don't crash on macos when creating & deleting folders in rapid succession #303

• FIX: Report events promptly on Linux, even when many occur in rapid succession. #268
• FIX: Fix leaks on Windows and debounce module. #288
• FIX: Display proper error message when reaching inotify limits on linux. #290

• DEPS: Update inotify to 0.7.
• DEPS(DEV): Replace tempdir with tempfile since tempdir is deprecated.
• DEPS: Update winapi to 0.3 and remove kernel32-sys. #232

• FIX: Fix deadlock in debouncer. #210

• FIX: Undo filetime pin. #202, 22e40f5e
• META: Project is abandoned.

• FIX: Implement Sync for PollWatcher to support FreeBSD. #198
• DEPS: Peg filetime to 1.2.5 to maintain rustc 1.26.1 compatibility. #199

• DEPS: [macOS] Upgrade fsevent to 0.4. #196

• FIX: Panic caused by a clock race. #182
• DOCS: Add xi to Readme showcase. e6f09441

• FIX: High CPU usage in some conditions when using debouncing. #177, #178, coming from rust-analyzer/#556

• DOCS: Mention hotwatch as alternative API. #175, 34775f26
• DEPS: [Linux] Disable stream feature for inotify. #176, e729e279
• DOCS: Add dates to releases in changelog. cc621398
• DOCS: Backfill changelog: 4.0.2 to 4.0.7. 6457f697
• DOCS: Backfill changelog: 0.0.1 to 2.6.0. d34e6ee7

• DOCS: Document unexpected behaviour around watching a tree root. #165, #166
• DOCS: Remove v2 documentation. 8310b2cc
• TESTS: Change how tests are skipped. 0b4c8400
• DOCS: Add timetrack to Readme showcase. #167
• META: Change commit message style: commits are now prefixed by a [topic].
• FIX: Make sure debounced watcher terminates. #170
• FIX: [Linux] Remove thread wake-up on timeout (introduced in 4.0.5 by error). #174
• FIX: Restore compatibility with Rust before 1.30.0. eab75118
• META: Enforce compatibility with Rust 1.26.1 via CI. 50924cd6
• META: Add maintenance status badge. ecd686ba
• DOCS: Freeze v4 branch (2018-10-05) 8310b2cc — and subsequently unfreeze it. (2019-01-19) 20c40f99, c00da47c

• FIX: Add some consts to restore semver compatibility. 6d4f1ab9

• DEPS: Update winapi (0.3), mio (0.6), inotify (0.6), filetime (0.2), bitflags (1.0). #162
• SEMVER BREAK: The bitflags upgrade introduced a breaking change to the API.

• Derive various traits for RecursiveMode. #148
• DOCS: Add docket to Readme showcase. #154
• DOCS: Rename OS X to macOS. #156
• FIX: [FreeBSD / Poll] Release the lock while the thread sleeps (was causing random hangs). #159

• FIX: [macOS] Concurrency-related FSEvent crash. #132
• FIX: [macOS] Deadlock due to race in FsEventWatcher. #118, #134
• DEPS: Update walkdir to 2.0. fbffef24

• FIX: Suppress events for files which have been moved and deleted if a new file in the original location is created quickly when using the debounced interface (eg. while safe-saving files) #129

• FIX: [Linux] Detect moves if two connected move events are split between two mio polls

• CHANGE: [Linux] Update dependency to inotify 0.3.0.
• FIX: [macOS] .watch() panics on macOS when the target doesn't exist. #105

• FIX: [macOS] Fix multiple panics in debounce module related to move events. #99, #100, #101

• FIX: [Windows] Fix watching files on Windows using relative paths. #90
• FEATURE: Add debounced event notification interface. #63
• FEATURE: [Polling] Implement CREATE and DELETE events for PollWatcher. #88
• FEATURE: [Polling] Add ::with_delay_ms() constructor. #88
• FIX: [macOS] Report ITEM_CHANGE_OWNER as CHMOD events. #93
• FIX: [Linux] Emit CLOSE_WRITE events. #93
• FEATURE: Allow recursion mode to be changed. #60, #61 breaking
• FEATURE: Track move events using a cookie.
• FEATURE: [macOS] Return an error when trying to unwatch non-existing file or directory.
• CHANGE: [Linux] Remove IGNORED event. breaking
• CHANGE: [Linux] Provide absolute paths even if the watch was created with a relative path.

• FIX: [macOS] Bump fsevents version. #91

• FEATURE: [macOS] Implement Send and Sync for FsWatcher. #82
• FEATURE: [Windows] Implement Send and Sync for ReadDirectoryChangesWatcher. #82
• DOCS: Add example to monitor a given file or directory. #77

• FIX: [Linux] Only register directories for watching. #74
• DOCS: Update Readme example code. ccfb54be

• Fix clippy lints. #57
• Run formatter. #59
• Fix warnings. #58
• FEATURE: Add Result alias. #72
• DEPS: Update inotify (0.2). #49, #70
• DOCS: Write API docs. #65
• FEATURE: [Linux] Add op::IGNORED. #73
• Simplify Cargo.toml. #75
• FEATURE: Implement std::Error for our Error type. #71

• DOCS: Explain an FSEvent limitation. #51
• DOCS: Clean up example code. #52
• RELENG: [macOS] Support i686. #54
• FEATURE: Implement Display on Error. #56

• META: Remove all * specifiers to comply with Crates.io policy. 9f44843f

• RELENG: [Linux] Support i686. #46