Skip to content

Repository files navigation

Secure Tools Desktop Pet

Secure Tools Desktop Pet is a small ornamental Windows companion for the Secure Tools product family. It is a lightweight, always-on-top 2D character without accounts, cloud services, AI, or background network activity.

Current features

  • Transparent, undecorated, fixed-size Tauri 2 window
  • Always-on-top display that is omitted from the taskbar
  • Initial placement near the lower-right corner of the primary monitor
  • Dragging the character moves the native window
  • Frame-based idle, randomized blink, and click reaction motion
  • Autonomous rest flow: idle -> sit after 30 seconds -> sleep after 90 seconds
  • Autonomous 8-20 second roaming cycle with physical-pixel work-area bounds
  • Sleep click/drag wake behavior and centralized activity reset
  • prefers-reduced-motion support
  • Right-click menu with Reset Position and Quit
  • Experimental internal Pet Asset Protocol v0.2 with mixed frame/sprite-sheet sources

The default guardian now includes dedicated sit, sleep, and wake frame sets. Pet Asset Protocol v0.2 remains experimental and may change before public Pet Pack support.

Development

Prerequisites:

  • Windows 11 (primary development target)
  • Node.js and npm
  • The Rust toolchain
  • The Tauri 2 Windows prerequisites, including Microsoft C++ Build Tools and WebView2

Install and run the web UI:

npm install
npm run dev

Run the desktop application:

npm run tauri dev

Create a production build only when the active sprint requests it:

npm run tauri build

Architecture

  • src/main.tsx and src/App.tsx: application entry and composition
  • src/behavior: behavior transitions plus inactivity and roaming schedulers
  • src/components: pet rendering and the minimal context menu
  • src/motion: animation playback, preload, and reduced-motion support
  • src/movement: pure destination, bounds, direction, and interpolation math
  • src/state: transient UI state
  • src/pets: internal pet definition and the current asset binding
  • src/platform: narrow Tauri window integration
  • src-tauri: native window configuration, placement, reset, and quit commands

Privacy and local-only operation

This application operates locally. Inactivity means time since interaction with the pet itself; no global keyboard or mouse hooks are used.

It does not require an account or server connection. No telemetry or analytics are included. Runtime code contains no fetch, XMLHttpRequest, WebSocket, remote font, remote image, updater, telemetry, or analytics integration. All required character assets are bundled with the application. Development package installation and build tooling are outside this runtime guarantee.

Project status

Sprint 4 provides bounded autonomous roaming with a dedicated eight-frame walk animation. It intentionally does not include climbing, physics, cursor following, monitor traversal, other-window detection, saved position, settings, custom pet import, auto-start, or update support.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages