# OpenLock

**Repository Path**: songyxin/OpenLock

## Basic Information

- **Project Name**: OpenLock
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-01
- **Last Updated**: 2026-03-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenLock - Secure Application Lock with Biometric Authentication

OpenLock is a secure application lock system that combines traditional password authentication with advanced biometric technologies including fingerprint recognition and facial recognition. Built with JavaFX, MySQL, and biometric recognition libraries, it provides a robust security solution for protecting sensitive applications.

## Features

- **Multi-factor Authentication**: Support for password, fingerprint, and facial recognition
- **Modern UI**: Clean and intuitive JavaFX interface
- **Biometric Enrollment**: Easy enrollment of fingerprint and facial data
- **Secure Storage**: Encrypted storage of biometric templates in MySQL database
- **Cross-platform**: Compatible with x64 platforms
- **Extensible Architecture**: Modular design allowing easy integration of additional biometric methods

## Technical Stack

- **Language**: Java 8+
- **Framework**: JavaFX 17
- **Database**: MySQL 5.5+
- **Build Tool**: Maven
- **Biometric Libraries**: Custom biometric device interfaces with Windows Biometric Framework support
- **Face Recognition**: OpenCV integration
- **Configuration**: Properties-based configuration management

## Architecture

The application follows a modular architecture with the following components:

- **MainApp**: JavaFX application entry point with modern UI
- **DatabaseManager**: Handles MySQL database connections and user management
- **BiometricAuthenticator**: Orchestrates biometric authentication processes
- **BiometricDevice Interface**: Abstract interface for biometric hardware
- **WindowsFingerprintScanner**: Implementation for Windows fingerprint scanners
- **FaceRecognitionCamera**: Implementation for camera-based face recognition
- **AppConfig**: Configuration management system
- **User Model**: Data model for user accounts

## Installation

1. Ensure you have Java 8+ and Maven installed
2. Clone this repository
3. Install MySQL and create a database named `openlock_db`
4. Update the database credentials in `src/main/resources/application.properties` if needed
5. Build the project: `mvn clean compile`
6. Run the application: `mvn javafx:run`

## Usage

1. **Registration**: Click "Create New Account" to register a new user
2. **Authentication Options**:
   - Password authentication
   - Fingerprint authentication
   - Facial recognition authentication
3. **Biometric Enrollment**: During registration, you can enroll fingerprint and/or facial data

## Security Considerations

- Passwords should be properly hashed (currently implemented in plain text for demonstration)
- Biometric templates are stored securely in the database
- Session management implemented with timeout functionality
- Secure communication protocols for database connections

## Platform Compatibility

This application is designed for x64 platforms with specific support for:
- Windows 10/11 (with Windows Biometric Framework support)
- Modern processors supporting Java 8+
- MySQL-compatible databases

## Future Enhancements

- Integration with additional biometric modalities (iris scanning, voice recognition)
- Enhanced encryption for biometric template storage
- Cross-platform support for Linux and macOS
- Advanced anti-spoofing measures
- Integration with enterprise identity management systems

## Contributing

We welcome contributions to enhance the security and functionality of OpenLock. Please submit pull requests with improvements or bug fixes.

## License

This project is licensed under the MIT License - see the LICENSE file for details.