Filesystem watcher library
  • Rust 99.8%
  • Shell 0.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
renovate[bot] 79007aefb4
Some checks failed
CI / zizmor (push) Has been cancelled
CI / Quality Checks (push) Has been cancelled
CI / Test macos-latest - 1.88 (--no-default-features --features macos_fsevent) (push) Has been cancelled
CI / Test macos-latest - nightly (--no-default-features --features macos_fsevent) (push) Has been cancelled
CI / Test macos-latest - stable (--no-default-features --features macos_fsevent) (push) Has been cancelled
CI / Test macos-latest - 1.88 (--no-default-features --features macos_kqueue) (push) Has been cancelled
CI / Test macos-latest - nightly (--no-default-features --features macos_kqueue) (push) Has been cancelled
CI / Test macos-latest - stable (--no-default-features --features macos_kqueue) (push) Has been cancelled
CI / Test ubuntu-latest - 1.88 (push) Has been cancelled
CI / Test ubuntu-latest - nightly (push) Has been cancelled
CI / Test ubuntu-latest - stable (push) Has been cancelled
CI / Test windows-latest - 1.88 (push) Has been cancelled
CI / Test windows-latest - nightly (push) Has been cancelled
CI / Test windows-latest - stable (push) Has been cancelled
CI / FreeBSD - 1.88 (push) Has been cancelled
CI / FreeBSD - nightly (push) Has been cancelled
CI / FreeBSD - stable (push) Has been cancelled
CI / Android (push) Has been cancelled
chore(deps): update taiki-e/install-action action to v2.75.28 (#916)
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
Co-authored-by: Yuki Okushi <huyuumi.dev@gmail.com>
2026-05-04 17:01:30 +09:00
.github chore(deps): update taiki-e/install-action action to v2.75.28 (#916) 2026-05-04 17:01:30 +09:00
docs fix: replace watcher when rewatching (#906) 2026-04-29 17:18:49 +09:00
examples chore: bump MSRV to 1.88 (#884) 2026-04-05 10:56:30 +09:00
file-id chore(*): add must_use where possible (#890) 2026-04-14 17:36:31 +09:00
notify prepare notify v9.0.0-rc.4 release (#914) 2026-05-02 12:45:36 +09:00
notify-debouncer-full prepare notify-debouncer-full v0.8.0-rc.2 release (#915) 2026-05-02 16:30:29 +09:00
notify-debouncer-mini chore(*): add must_use where possible (#890) 2026-04-14 17:36:31 +09:00
notify-types feat(notify): preserve watched path representations across backends (#901) 2026-04-19 16:18:41 +09:00
tests run nix test not on windows 2022-04-29 01:30:10 +02:00
.editorconfig [docs] Bring module docs in line with new readme 2019-03-30 23:15:33 +13:00
.gitignore chore: Git-include Cargo.lock (#724) 2025-10-26 11:25:30 +09:00
.typos.toml Fix a typo and add a typo CI check. (#646) 2024-10-24 00:27:44 +09:00
Cargo.lock prepare notify-debouncer-full v0.8.0-rc.2 release (#915) 2026-05-02 16:30:29 +09:00
Cargo.toml prepare notify-debouncer-full v0.8.0-rc.2 release (#915) 2026-05-02 16:30:29 +09:00
CHANGELOG.md debouncer-full: prepare v0.7.0 release (#762) 2026-01-23 20:30:24 +09:00
clippy.toml Refer to macOS by that name rather than OS X. 2018-04-08 10:17:37 +12:00
CODE_OF_CONDUCT.md [impl] Rewrite immediate to use new events 2019-06-30 03:12:17 +12:00
deny.toml perf: replace pool hasher with xxh3 (#810) 2026-02-14 20:00:07 +09:00
README.md chore: bump MSRV to 1.88 (#884) 2026-04-05 10:56:30 +09:00
release_checklist.md Prepare release 2025-01-10 15:18:38 +01:00
renovate.json chore: open renovate PRs weekly (#882) 2026-03-31 06:53:54 +09:00
rust-toolchain.toml chore: bump MSRV to 1.88 (#884) 2026-04-05 10:56:30 +09:00

Notify

» Crate » Docs » CI » Downloads » Conduct » Public Domain

Cross-platform filesystem notification library for Rust.

As used by: alacritty, cargo watch, cobalt, deno, docket, mdBook, rust-analyzer, watchexec, watchfiles, xi-editor, zed and others.

(Looking for desktop notifications instead? Have a look at notify-rust or alert-after!)

Minimum Supported Rust Version (MSRV) Policy

We follow these MSRV rules:

  • The current MSRV is 1.88.
  • MSRV bumps do NOT require a major release and may happen in minor releases.
  • The MSRV may be updated when needed, but support for the current stable Rust release and the previous two stable releases (N, N-1, N-2) is always guaranteed.
    • For example, if the current stable version is 1.85, we guarantee support for 1.85, 1.84, and 1.83, so the minimum supported Rust version will be at most 1.83.
  • MSRV is bumped only when needed, e.g.:
    • required by dependencies
    • any serious bug is found (including security-related)
    • adopting new stable Rust features
  • Every MSRV bump is documented in the release notes when it happens.

Platforms

  • Linux / Android: inotify
  • macOS: FSEvents or kqueue, see features
  • Windows: ReadDirectoryChangesW
  • iOS / FreeBSD / NetBSD / OpenBSD / DragonflyBSD: kqueue
  • All platforms: polling

License

notify is licensed under the CC Zero 1.0.
notify-types is licensed under the MIT or Apache-2.0 license.
notify-debouncer-mini is licensed under the MIT or Apache-2.0 license.
notify-debouncer-full is licensed under the MIT or Apache-2.0 license.
file-id is licensed under the MIT or Apache-2.0 license.

Origins

Inspired by Go's fsnotify and Node.js's Chokidar, born out of need for cargo watch, and general frustration at the non-existence of C/Rust cross-platform notify libraries.

Originally created by Félix Saparelli and awesome contributors.