Cube Eye

About Cube Eye

## 🚀 Overview

**CubeEye** is an advanced Android application designed to solve 3x3 Rubik's Cubes. It leverages computer vision to scan a physical cube and provides an interactive, animated 3D guide to solve it using near-optimal moves.

## ✨ Key Features

### 📷 Smart Scanning System

* **Real-time Color Detection:** Automatically identifies cube face colors using the camera via the custom `ColorAnalyzer`.
* **Guided Scanning:** An intuitive UI overlay guides users through the process of capturing all 6 faces correctly.
* **Validation Logic:** The built-in `CubeValidator` ensures the scanned state is physically solvable before proceeding.
* **Manual Correction:** Includes a `ColorPickerDialog` allowing users to manually adjust colors if lighting conditions affect automatic detection.

### 🧩 Intelligent Solver

* **Kociemba Algorithm:** Integrates the famous Two-Phase Algorithm (via the *min2phase* library) to find near-optimal solutions, often requiring fewer than 20 moves.
* **Fast Local Computation:** Solves complex scrambles in seconds directly on the device without needing a network connection.

### 🎥 Interactive 3D Guide

* **3D Visualization:** Features a fully interactive 3D render (`Cube3DView`) that accurately mimics the real cube's state.
* **Step-by-Step Animation:** Users can play, pause, and scrub through the solution moves at their own pace.

## 🛠 Technical Highlights

* **Modern Android Stack:** Built entirely using Kotlin and Jetpack Compose (Material 3).
* **Robust Architecture:** Follows Clean Architecture principles, utilizing MVVM patterns, Hilt for dependency injection, and Coroutines for asynchronous operations.
* **CameraX:** Implements a stable and efficient camera foundation for live preview and image analysis.
* **SceneView:** Utilizes the SceneView library for high-performance 3D rendering.

## 🐛 Known Issues / TODOs

* Optimize color detection thresholds to better handle extreme lighting conditions.
* Automate the integration of the "min2phase" library (currently included as manual source files).