Module monitor 

Provides live filesystem monitoring, file-settling checks, and checksum generation.

Uses notify watchers (inotify on Linux, polling under Flatpak) to detect new or modified files in watch-path directories. Files are settled via a debounce window before being queued, and checksums are computed using BLAKE3 with chunked streaming to avoid large allocations.

Structs

Monitor

File monitor that coordinates watching directories and reporting events.

MonitorHandle

Enums

MonitorCommand 🔒

Monitor commands passed down the main event loop.

MonitorEvent

MonitorFsEvent 🔒

Constants

CHECK_INTERVAL_MS 🔒

FLATPAK_POLL_INTERVAL_MS 🔒

IDLE_TIMEOUT_SECS 🔒

REQUIRED_STABLE_COUNTS 🔒

Number of consecutive stable size checks required before a file is considered complete.

Functions

compute_sha1_chunked 🔒

Compute SHA-1 in chunks so large media files never need to be read fully into memory.

create_watcher 🔒

Create recommended watcher fallback or poll watcher depending on flatpak containerisation.

handle_notify_event 🔒

hash_and_emit 🔒

is_flatpak_sandbox 🔒

Check if running inside Flatpak sandbox environment.

is_supported_media_path 🔒

Return whether a path points to a supported media file rather than a directory.

is_temporary_file 🔒

monitor_event_kind 🔒

process_delete_path 🔒

process_upsert_path 🔒

replace_watches 🔒

Replace live directories being monitored by the given watcher.

should_skip_path 🔒

spawn_hash_workers 🔒

wait_for_file_completion 🔒

Wait for a file’s size to stop changing before treating it as upload-ready.