FluxEye — File System Monitor

Desktop GUI application for file system monitoring / Десктопное GUI-приложение для мониторинга файловой системы

Version / Версия: 1.0.0 | Framework / Фреймворк: Tauri 2 | English | Русский

---

English

FluxEye watches your folders and reports any file changes in real-time — creates, modifications, and deletions.

Use cases / Сценарии использования:

• Monitor project directories during development
• Track configuration file changes
• Watch download folders for new files
• Debug file operations in scripts
• Monitor shared network drives

Simply add folders to watch, configure filters, and start monitoring. All events appear in the real-time log with timestamps and file paths.

Features

• Visual path selection - Add folders via native file dialog
• Real-time event log - See file changes as they happen with color-coded event types
• Configurable settings - Adjust debounce, ignore extensions, and prefixes from the UI
• Start/Stop control - Toggle monitoring without restarting the application
• Event statistics - Live event counter and status indicator

Prerequisites

• Node.js 18+ (for development)
• Rust (latest stable for Tauri 2)
• Tauri CLI 2.x (npm install -D @tauri-apps/cli)

Installation

cd fs-monitor-gui
npm install
npm run dev

Build

npm run build

The installer will be in src-tauri/target/release/bundle/.

Usage

1. Add paths - Click "+ Add Folder" to select directories to monitor
2. Configure settings - Adjust debounce time, ignored extensions, and prefixes
3. Start monitoring - Click "Start Monitoring" to begin watching
4. View events - See real-time file events in the log panel
5. Stop - Click "Stop" to halt monitoring

Architecture

fs-monitor-gui/
├── src/                    # Frontend (HTML/CSS/JS)
│   ├── index.html          # Main application layout
│   ├── app.js              # Application logic, Tauri API calls
│   └── styles.css          # Dark theme styling
└── src-tauri/              # Backend (Rust/Tauri)
    ├── src/main.rs         # Tauri commands, watcher logic
    ├── Cargo.toml          # Rust dependencies
    ├── tauri.conf.json     # Tauri configuration
    └── capabilities/       # Tauri v2 permissions
        └── default.json    # Dialog and shell permissions

Security

• Content Security Policy - CSP header prevents XSS attacks
• Input Sanitization - All user input is validated and sanitized
• Error Handling - Graceful error handling without panics
• Debounce Validation - Input bounds checking prevents abuse

---

Russian / Русский

FluxEye отслеживает папки и сообщает о любых изменениях файлов в реальном времени — создание, модификация и удаление.

Сценарии использования:

• Мониторинг папок проекта во время разработки
• Отслеживание изменений конфигурационных файлов
• Наблюдение за папкой загрузок для новых файлов
• Отладка файловых операций в скриптах
• Мониторинг общих сетевых дисков

Просто добавьте папки для наблюдения, настройте фильтры и начните мониторинг. Все события появляются в журнале в реальном времени с временными метками и путями к файлам.

Возможности

• Визуальный выбор путей — Добавление папок через нативный диалог выбора файлов
• Журнал событий в реальном времени — Просмотр изменений файлов по мере их возникновения с цветовой кодировкой типов событий
• Настраиваемые параметры — Настройка дебаунса, игнорируемых расширений и префиксов через UI
• Управление Start/Stop — Переключение мониторинга без перезапуска приложения
• Статистика событий — Счётчик событий и индикатор статуса в реальном времени

Предварительные требования

• Node.js 18+ (для разработки)
• Rust (последняя стабильная версия для Tauri 2)
• Tauri CLI 2.x (npm install -D @tauri-apps/cli)

Установка

cd fs-monitor-gui
npm install
npm run dev

Сборка

npm run build

Инсталлятор будет в src-tauri/target/release/bundle/.

Использование

1. Добавьте пути — Нажмите "+ Add Folder" для выбора директорий для мониторинга
2. Настройте параметры — Отрегулируйте время дебаунса, игнорируемые расширения и префиксы
3. Запустите мониторинг — Нажмите "Start Monitoring" для начала наблюдения
4. Просматривайте события — Просматривайте события файлов в реальном времени в панели журнала
5. Остановите — Нажмите "Stop" для остановки мониторинга

Архитектура

fs-monitor-gui/
├── src/                    # Фронтенд (HTML/CSS/JS)
│   ├── index.html          # Основной макет приложения
│   ├── app.js              # Логика приложения, вызовы Tauri API
│   └── styles.css          # Оформление тёмной темы
└── src-tauri/              # Бэкенд (Rust/Tauri)
    ├── src/main.rs         # Команды Tauri, логика наблюдения
    ├── Cargo.toml          # Зависимости Rust
    ├── tauri.conf.json     # Конфигурация Tauri
    └── capabilities/       # Система разрешений Tauri v2
        └── default.json    # Разрешения для диалогов и оболочки

Безопасность

• Content Security Policy — CSP-заголовок предотвращает XSS-атаки
• Проверка входных данных — Все пользовательские данные валидируются
• Обработка ошибок — Корректная обработка без паники
• Проверка дебаунса — Проверка границ ввода предотвращает злоупотребления

---

Related Projects / Связанные проекты

• fs-monitor/ — CLI version / CLI версия

License / Лицензия

MIT