This repository provides a digital framework for precise coordinate mapping of a classic Ouija board. The primary goal is to standardize the board layout for use with computer vision systems and other digital analysis tools. This project details a Cartesian coordinate system with an origin at the top-left corner, assigning a center point (Position X/Y) and a radius (Radius) to each alphanumeric and command element. This open-source mapping can serve as a foundation for a wide range of applications, including data collection and objective analysis of planchette movements, making the study of the Ouija board more structured and replicable.

This script ouija_session.py/js serves as a comprehensive engine for interpreting and recording an entire Ouija board session. Its purpose is to continuously translate real-time Cartesian coordinates (X, Y) into a chronological log of symbolic board elements (such as letters, numbers, or keywords). This moves beyond simple detection to capture the complete story of an interaction.

The code functions as a session-based detection and logging engine:

1. Imports Coordinate Mapping: It uses the ouijaBoardMapping data structure to access the precise position and radius of each board element.
2. Session Management: The script initiates a session with a defined start and end time. It runs a continuous loop to monitor the pointer's location throughout the session duration.
3. Continuous Detection & Debouncing: In each cycle of the loop, the script detects the current element. It then applies a crucial state-based logic (debouncing) to ensure that a new element is only logged when it is different from the previous one. This prevents redundant entries and creates a clean, meaningful sequence of selections.
4. Event Logging: Instead of just returning a single value, the script records a timestamped event to a session_log. Each entry in this log contains the selected element, the time of detection, and the raw coordinates.
5. Returns the Full Log: Upon the session's completion, the script outputs the entire structured log, providing a complete history of the interaction for further analysis.

This script is a powerful foundation for any application that needs to study behavioral patterns and interactions. It's ideal for a computer vision system tracking a physical pointer, or a virtual simulator logging user movements.

Visual representation of the board's coordinate mapping. The circles indicate the position and detection radius for each letter, number, and command. The gray areas represent blocked or mute zones to prevent the system from recognizing them as significant.

This section details the Ouija Board Coordinate Mapping, an essential component for the OuijaEcho project's visual recognition system. Using a Cartesian coordinate system with its origin at the top-left corner, a center point (Position X/Y) and a radius (Radius) have been assigned to each alphanumeric and command element. This configuration allows the planchette-camera system to precisely determine the position of the pointer and validate the interaction during a high-confidence event ($I_c$). The data in this table is fundamental for communication with the robotic hand and the predictive AI.

• Supported environments: Browser, Node.js, Deno, and Bun.

npx ouijaecho

npm i ouijaecho

import ouijaecho from 'ouijaecho'

// do something

• Report issues - Share bugs or suggestions to refine the codebase.
• Submit pull requests - Propose enhancements or new features for the community.
• Star the repository - Show your support and help increase visibility.
• Support the project - Contribute financially to sustain development.
• Explore the code - Dive into the source and collaborate on innovations.

This software is licensed with GPL-3.0.