NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
crates.io
crates.io, #622 most downloaded on crates.io
Cross-platform filesystem notification library
Latest stable
9.0.0
Last release today
21 Nov 2026
Release timing varies
gaps range from 9 days to 6 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
2 versions withdrawn
withdrawn after publishing
12 years old
91 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
No significant change since v9-rc, see https://github.com/notify-rs/notify/blob/main/docs/UPGRADING_V8_TO_V9.md for details.
No significant change since v9-rc, see https://github.com/notify-rs/notify/blob/main/docs/UPGRADING_V8_TO_V9.md for details.
notify 9 requires Rust 1.91 and works with version 0.8 of both debouncers. For examples and backend-specific changes, see the v8 to v9 migration guide.
Watcher::update_paths replaces Watcher::paths_mut for batched changes. Watcher::watched_paths lists registrations as WatchedPath values.Config no longer implements Copy. Use constructors for Error and include a wildcard arm when matching ErrorKind.Config::with_event_kinds filters events by kind. WatchPathConfig::with_user_data attaches a caller-supplied ID to events and errors from a watch.futures or tokio feature enabled, watchers can use the corresponding unbounded channel sender as an event handler.PollWatcher reports file writes as data changes and classifies created and removed entries by type.freebsd_inotify feature selects it when cross-compiling for those versions.Your coding agent can read these notes before it upgrades. Set up the MCP server →
Sorry but this is one more release candidate as we've made a lot of changes since v9.0.0-rc.8. Unless any serious bug/regression is found, the v9 stab
Sorry but this is one more release candidate as we've made a lot of changes since v9.0.0-rc.8. Unless any serious bug/regression is found, the v9 stable release is scheduled for November 21.
Watcher::watched_paths returns Vec<WatchedPath> instead of Vec<(PathBuf, RecursiveMode)>. See the migration guide #1106 breakingPathOp is now #[non_exhaustive]. See the migration guide #1106 breakingConfig no longer implements Copy. See the migration guide #1106 breakingwindows::MetaEvent and ReadDirectoryChangesWatcher::create. See the migration guide #1106 breakingACCESS_CLOSE_NOWRITE from Config::default(), restoring v8's default event kinds. See the migration guide #1096Modify(Data(Any)) instead of Modify(Metadata(WriteTime)). See the migration guide #1101File, Folder, or Other instead of Any. See the migration guide #1107ErrorKind::WatchStartFailed instead of ErrorKind::Generic when an FSEvents stream cannot be created or started. See the migration guide #1108notify-types to 2.3.1ErrorKind::Io instead of constructing an unusable watcher #1108ErrorKind::Io instead of ErrorKind::Generic #1108MODIFY_NAME alone; stop watching directories moved outside recursive roots even when rename events are filtered #1096watch() calls; inotify follows replaced paths, and kqueue processes pending rename/delete events before rewatching #1093unwatch remove only explicit watches and preserve ancestor recursive coverage. See the migration guide #1097follow_symlinks for new symlinks and detect new entries under recursively watched symlink roots #1097ErrorKind::PathNotFound instead of ErrorKind::Generic when watching a path that does not exist; other failures to stat the path are now reported as ErrorKind::Io. See the migration guide #1102This is the final release candidate for v9. We recommend trying out, any feedback is appreciated!
This is the final release candidate for v9. We recommend trying out, any feedback is appreciated!
Error gains a private field; ErrorKind and UpdatePathsError are now #[non_exhaustive]. Use error constructors (including UpdatePathsError::new), .. in struct patterns, and wildcard enum matches #1060 #1071 breakingnotify-types to 2.3.0 for per-watch user data supportWatchPathConfig::with_user_data(u64) to identify watches through Event::user_data() and Error::user_data() on all backends, including failed batch operations via UpdatePathsError.source #1012 #388Config::with_windows_extended_information for file/folder classification in create/remove events; unsupported APIs and filesystems return errors #261 #1061InvalidData error and a rescan event #1077ErrorKind::MaxFilesWatch, and ignore missing directories during event-triggered scans #703 #455 #596Unsupported errors #1058CFError objects when resolving watch paths #1082watched_paths #1062FIX: [inotify] report newly created subdirectories found while extending a recursive watch, including nested directories created before their watches
watched_paths no longer lists it #1038Watcher::update_paths operations and skip redundant metadata reads when adding non-recursive watches #1041Stop, and close the directory handle and completion semaphore only after the pending read has completed (leaked if CancelIo fails) #1051notify-types to 2.2.0 #1032FIX: [macOS] prevent intermittent hangs during rapid watch/unwatch sequences with FsEventWatcher #1013
FsEventWatcher #1013watch when the path does not exist instead of failing silently, matching the other backends #998Watcher::update_paths for bulk registration #988Error::watch_not_found from unwatch when the path is not watched instead of succeeding silently, matching the other backends #1014FEATURE: [FreeBSD] select native inotify automatically when building on FreeBSD 14.5+ and kqueue otherwise. The freebsd_inotify feature enables inotif
freebsd_inotify feature enables inotify when cross-compiling for FreeBSD 14.5+.inotify to 0.11.4 for native FreeBSD supportConfig::with_fsevent_latency to configure FSEvents stream latency #930EINVAL or WatchNotFound logsReadDirectoryChangesW read-start failures #935ReadDirectoryChangesW discards change details [#964]Watcher::watch_with to pass per-path settings, and WatchPathConfig::with_dereference_symlinks to watch a symbolic link itself instead of its destination, which also makes a dangling link watchable #255CHANGE: preserve watched path representation in Event.paths and Watcher::watched_paths ; relative watch paths now produce relative event paths consist
Event.paths and Watcher::watched_paths; relative watch paths now produce relative event paths consistently across backends [#453] [#740]watch is called again for the same path, avoiding duplicate FSEvent paths and leaked Windows watch handles [#708]Watcher::watch replacement behavior for an existing backend-resolved path [#708]FEATURE: add Watcher::watched_paths to list active watches as (PathBuf, RecursiveMode) pairs across supported backends
Watcher::watched_paths to list active watches as (PathBuf, RecursiveMode) pairs across supported backendsConfig::with_windows_path_separator_style for explicit control #375unwatch() wait until the watch is fully removed so later filesystem changes do not leak events #730info = "is: clone" #465unwatch when internal mutexes are poisoned#[must_use] annotations to builder, constructor, and getter-style APIs such as Config, PathOp, and ErrorFEATURE: remove Watcher::paths_mut and introduce update_paths #705
Watcher::paths_mut and introduce update_paths #705EventHandler for futures::channel::mpsc::UnboundedSender and tokio::sync::mpsc::UnboundedSender behind the futures and tokio feature flags #767UNMOUNT events to users and clean up affected watches #627FSEventsPurgeEventsForDeviceUpToEventId call #795Watcher::paths_mut and introduce update_paths #705EventHandler for futures::channel::mpsc::UnboundedSender and tokio::sync::mpsc::UnboundedSender behind the futures and tokio feature flags #767UNMOUNT events to users and clean up affected watches #627FSEventsPurgeEventsForDeviceUpToEventId call #795info = "root changed" #769 #785Important The MSRV policy has been changed since this release. Check out README for details.
Important
The MSRV policy has been changed since this release.
Check out README for details.
fsevent-sys with objc2-core-foundation and objc2-core-services #726EventKindMask for filtering filesystem events #736FsEventWatcher crashes when dealing with empty path #718INotifyWatcher keeps watching deleted paths #720FsEventWatcher emitted Remove events non-terminally #747FsEventWatcher stream start error properly #733CHANGE: raise MSRV from 1.85 to 1.88 breaking
CHANGE: raise MSRV from 1.77 to 1.85 #719 #723 breaking
fsevent-sys with objc2-core-foundation and objc2-core-services on macOS, preserving the fsevent-sys feature for compatibility #726windows-sys to 0.61 #1045FsEventWatcher from crashing when unwatching an empty path #718INotifyWatcher even when the kernel has already removed their watch descriptors #720watch, unwatch, and PathsMut::commit #733FEATURE: notify user if inotify's max_user_watches has been reached [#698]
max_user_watches has been reached #698INotifyWatcher ignore events with unknown watch descriptors (instead of EventMask::Q_OVERFLOW) #700FileIdCache trait implementations to choose ownership of the returned file-ids #664flume crate #680Modify events right after a Create event, unless it's a rename event #701AsRef<FileId> for FileId #664Full Changelog: https://github.com/notify-rs/notify/compare/notify-8.1.0...notify-8.2.0
Fix typo by @mo8it in https://github.com/notify-rs/notify/pull/667
filetime dependency by @a1phyr in https://github.com/notify-rs/notify/pull/690windows-sys to v0.60 by @a1phyr in https://github.com/notify-rs/notify/pull/691Watcher::paths_mut for adding/removing paths in batch by @branchseer in https://github.com/notify-rs/notify/pull/692PathsMut::commit consuming by @branchseer in https://github.com/notify-rs/notify/pull/695Full Changelog: https://github.com/notify-rs/notify/compare/notify-8.0.0...notify-8.1.0
flume cratePathNotFound instead bubbling up the std::io error [#685]CHANGE: update notify-types to version 2.0.0
web-time feature breakingweb-time feature to notify-types7.0.0 in lib.rs documentation by @Wrench56 in https://github.com/notify-rs/notify/pull/655Event::kind serialization with serialization-compat-6 by @Legend-Master in https://github.com/notify-rs/notify/pull/660Full Changelog: https://github.com/notify-rs/notify/compare/notify-7.0.0...notify-8.0.0
v7.0 Replace deprecated poll_interval signature by @zeroishero in https://github.com/notify-rs/notify/pull/546
crossbeam to crossbeam-channel and disable it by default #610 breakingNew crate containing public type definitions for the notify and debouncer crates. #559
serialization-compat-6 #558 #568 breakingInstant type that works in Wasm environments) #570CHANGE: update notify to version 7.0.0
CHANGE: manage root folder paths for the file ID cache automatically #557 breaking
debouncer.watcher().watch(path, RecursiveMode::Recursive)?;
debouncer.cache().add_root(path, RecursiveMode::Recursive);
becomes:
debouncer.watch(path, RecursiveMode::Recursive)?;
CHANGE: add RecommendedCache, which automatically enables the file ID cache on Windows and MacOS
and disables it on Linux, where it is not needed #557
crossbeam-channel with default-features="false" by @LeoniePhiline in https://github.com/notify-rs/notify/pull/550serialization-compat-6 feature by @dfaust in https://github.com/notify-rs/notify/pull/568legacy_numeric_constants lints. by @waywardmonkeys in https://github.com/notify-rs/notify/pull/595actions/checkout v4 from v3 by @waywardmonkeys in https://github.com/notify-rs/notify/pull/594ErrorKind::PathNotFound consistent on inotify by @y5c4l3 in https://github.com/notify-rs/notify/pull/611WatchMask::OPEN on inotify by @y5c4l3 in https://github.com/notify-rs/notify/pull/612rstest by @waywardmonkeys in https://github.com/notify-rs/notify/pull/608README.md for file-id by @waywardmonkeys in https://github.com/notify-rs/notify/pull/617PollWatcher by @samuelcolvin in https://github.com/notify-rs/notify/pull/634mio to 1.0 by @waywardmonkeys in https://github.com/notify-rs/notify/pull/623clippy::doc_markdown lints by @waywardmonkeys in https://github.com/notify-rs/notify/pull/621Full Changelog: https://github.com/notify-rs/notify/compare/notify-6.1.1...notify-7.0.0
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]
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: implement Copy for EventKind and ModifyKind [#481]
Copy for EventKind and ModifyKind #481CHANGE: switch from winapi to windows-sys [#457]
For a list of changes when upgrading from v4 see UPGRADING_V4_TO_V5.md.
For a list of changes when upgrading from v4 see UPGRADING_V4_TO_V5.md.
Differences to 5.0.0-pre.16:
need_rescan function to Event, allowing easier detection when a rescan is required #435crossbeam, to allow passthrough with notify re-exports #429This is the final release before 5.0.0 !
This is the final release before 5.0.0 !
CHANGE: raise MSRV to 1.56! [#396] and [#402]
CHANGE: upgrade mio to 0.8 [#386]
Fix: Add path information to inotify and kqueue watch/unwatch errors [#354]
CHANGE: Move creation of watcher into trait [#345]
FEATURE: Add Kqueue backend for use on BSD [#335]
Kqueue backend for use on BSD #335Watcher object safe #336fseven on shutdown #337inotify #330fsevent #329FIX: Make StreamContextInfo Send to fix soundness issue [#325]
Send to fix soundness issue #325DEPS: Upgrade fsevent-sys dependency to 4.0 [#322]
HOTFIX: Fix breaking change in fsevent-sys in minor version destroying builds [#316]
FIX: Display proper error message when reaching inotify limits on linux [#285]
FIX: Handle interrupted system call errors from mio #281
RUSTC: Push the minimum version to 1.47.0 [#280]
CHANGE: Avoid stating the watched path for non-recursive watches with inotify [#256]
DEPS: Removed unused chashmap dependency [#242]
(Temporary): Remove event debouncing.
Senders from watcher API in favour of EventFn #214_(no changes, just a new release because the old one failed to publish properly)_
(no changes, just a new release because the old one failed to publish properly)
RUSTC: Push the minimum version to 1.36.0 [#201]
Sync for PollWatcher to support FreeBSD. #197Ongoing events (optional, configured at runtime). #146, #183next branch. #1872a035c86Chmod to Metadata. #179, #180, previously #112, #161DebouncedEvent event classification. #187v4-legacy branch to main, to further clarify status and prepare for a breaking release.v5 to Next Generation Notify to allow for a breaking release.FIX: Add missing winapi features [#603]
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]
DEPS(DEV): Replace tempdir with tempfile since tempdir is deprecated.
FIX: Fix deadlock in debouncer. [#210]
FIX: Undo filetime pin. [#202], [22e40f5e]
FIX: Implement Sync for PollWatcher to support FreeBSD. [#198]
DEPS: \[macOS\] Upgrade fsevent to 0.4. [#196]
FIX: Panic caused by a clock race. [#182]
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]
DOCS: Document unexpected behavior around watching a tree root. [#165], [#166]
8310b2cc0b4c8400[topic].eab7511850924cd6ecd686ba8310b2cc — and subsequently unfreeze it. (2019-01-19) 20c40f99, c00da47cFIX: Add some consts to restore semver compatibility. [6d4f1ab9]
6d4f1ab9SEMVER BREAK: The bitflags upgrade introduced a breaking change to the API.
Derive various traits for RecursiveMode. [#148]
RecursiveMode. #148FIX: \[macOS\] Concurrency-related FSEvent crash. [#132]
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 in
FIX: \[Linux\] Detect moves if two connected move events are split between two mio polls
CHANGE: \[Linux\] Update dependency to inotify 0.3.0.
.watch() panics on macOS when the target doesn't exist. #105FIX: \[macOS\] Fix multiple panics in debounce module related to move events. [#99], [#100], [#101]
One column per quarter.