Skip to content

Hewlbern/Biomap

Repository files navigation

BioMap

A modern Tauri application that continuously monitors your computer activity, taking screenshots, tracking mouse movements, and logging system information with semantic graph integration support.

Features

  • Screenshot Capture: Automatically takes screenshots of your screen at configurable intervals
  • Mouse Movement Tracking: Captures mouse movements, clicks, and scroll events
  • Keyboard Input Monitoring: Tracks key presses and typing patterns
  • System Monitoring: Tracks CPU usage, memory usage, running processes, and more
  • Geolocation Tracking: Captures location data for each activity log
  • RDF/JSON-LD Export: Generates semantic data for graph database integration
  • Data Storage: Saves all data locally in organized directories
  • Real-time Display: Shows live activity data in the application interface
  • Configurable Intervals: Set custom monitoring intervals (5-300 seconds)
  • Graph Integration: Optimized for knowledge graphs and semantic databases
  • AI/ML Ready: Data structure optimized for machine learning and AI analysis

Data Storage

The application stores data in the following locations:

  • Screenshots: ~/Library/Application Support/webway/screenshots/
  • Activity Logs (JSON): ~/Library/Application Support/webway/logs/
  • RDF/JSON-LD: ~/Library/Application Support/webway/rdf/

Data Formats

JSON Format

Standard JSON logs with system information, timestamps, and geolocation data.

RDF/JSON-LD Format

Semantic data optimized for graph databases with:

  • Unique identifiers (UUIDs) for each activity log
  • Semantic relationships between system components
  • Geolocation data with WGS84 coordinates
  • Timestamped activity sequences
  • Process hierarchies and dependencies
  • Schema.org and custom ontology integration

Usage

  1. Start Monitoring: Click the "Start Monitoring" button
  2. Set Interval: Adjust the monitoring interval (default: 30 seconds)
  3. View Activity: Monitor real-time system activity in the interface
  4. Stop Monitoring: Click "Stop Monitoring" when done

Screenshot Frequency

Screenshots are captured every 10 monitoring cycles to save storage space. For example, with a 30-second interval, screenshots are taken every 5 minutes.

System Requirements

  • macOS (tested on macOS 14+)
  • Screen recording permissions (required for screenshot capture)
  • Sufficient disk space for screenshots and logs

Privacy & Security

  • All data is stored locally on your machine
  • No data is transmitted to external servers
  • You have full control over your data
  • Screenshots are only captured when monitoring is active

Development

To run in development mode:

npm run tauri dev

To build the application:

npm run tauri build

Permissions

On first run, you may need to grant the following permissions:

  • Screen recording permission (for screenshot capture)
  • File system access (for data storage)

Data Structure

Activity Log Structure

Each activity log contains:

  • Unique ID: UUID for graph node identification
  • Timestamp: ISO 8601 formatted timestamp
  • System Information: CPU usage, memory usage, process count
  • Active Processes: Top processes by CPU usage with memory consumption
  • Screenshot Path: PNG file path (if captured)
  • Geolocation: Latitude, longitude, accuracy, and source

RDF/JSON-LD Structure

Semantic data includes:

  • @context: Schema.org, W3C Geo, and custom ontologies
  • @id: Unique URI for each activity log
  • @type: Semantic type definitions
  • Relationships: Links between system components
  • Geolocation: WGS84 coordinate system integration
  • Temporal Data: Timestamped activity sequences

Example RDF/JSON-LD Output

See example-rdf.jsonld for a complete example of the semantic data structure.

Troubleshooting

If screenshots are not being captured:

  1. Check that screen recording permissions are granted
  2. Ensure the application is not minimized
  3. Try restarting the application

For any issues, check the console output for error messages.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published