docs: Enhance SEO with improved README, metadata files, and troubleshooting guide

Author: Spieler1ONE1

CITATION.cff

@@ -0,0 +1,23 @@
+cff-version: 1.2.0
+title: "SCCharacters - BioMetrics System"
+message: "If you use this software, please cite it as below."
+type: software
+authors:
+  - given-names: "SpielerWAN"
+    family-names: ""
+    email: "contact@spielerwan.com"
+repository-code: "https://github.com/Spieler1ONE1/SCCharacters"
+url: "https://github.com/Spieler1ONE1/SCCharacters"
+abstract: "An advanced desktop application for managing, installing, and customizing Star Citizen character appearances (.chf files). Features include DNA preset management, backup/restore, and community sharing integration."
+keywords:
+  - "star citizen"
+  - "character customization"
+  - "game utility"
+  - "python"
+  - "pyside6"
+  - "biometrics"
+  - "chf file"
+  - "gaming tool"
+license: MIT
+version: 2.0.0
+date-released: 2024-05-20

CONTRIBUTING.md

@@ -4,6 +4,15 @@ First off, thanks for taking the time to contribute! 🎉
 
 The following is a set of guidelines for contributing to SCCharacters and its packages. These are mostly guidelines, not rules. Use your best judgment and feel free to propose changes to this document in a pull request.
 
+## Technology Stack
+
+This project is built using:
+- **Python 3.10+**: Core logic and backend.
+- **PySide6 (Qt for Python)**: Modern, responsive GUI framework.
+- **Star Citizen File Parsing**: Custom handlers for `.chf` and `.xml` configuration files.
+
+We welcome contributions from developers of all skill levels interested in **game tools development**, **GUI programming**, or **Star Citizen community projects**.
+
 ## Code of Conduct
 
 This project and everyone participating in it is governed by the [Code of Conduct](CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code.

README.md

@@ -1,18 +1,22 @@
-# 🧬 BioMetrics System & Manager
-> *Advanced Character Identity Management for Star Citizen*
-
-![Version](https://img.shields.io/badge/version-2.0.0-blue.svg) ![Platform](https://img.shields.io/badge/platform-Windows-blue) ![Star Citizen](https://img.shields.io/badge/Star%20Citizen-Ready-orange) [![Discord](https://img.shields.io/badge/Discord-Join%20Us-5865F2?logo=discord&logoColor=white)](https://discord.gg/TGjCmzHR)
+<div align="center">
+  <img src="assets/logo.png" alt="Star Citizen Character Manager Logo" width="200">
+  <h1>🧬 BioMetrics - Star Citizen Character Manager</h1>
+  <h3><i>The Ultimate Character Customization & DNA Preset Tool for Star Citizen</i></h3>
+  <br>
+  
+  ![Version](https://img.shields.io/badge/version-2.0.0-blue.svg) ![Platform](https://img.shields.io/badge/platform-Windows-blue) ![Star Citizen](https://img.shields.io/badge/Star%20Citizen-Ready-orange) [![Discord](https://img.shields.io/badge/Discord-Join%20Us-5865F2?logo=discord&logoColor=white)](https://discord.gg/TGjCmzHR)
+</div>
 
-**SCCharacters (BioMetrics)** is a powerful, immersive desktop application designed to streamline the management, installation, and customization of your Star Citizen character appearances (`.chf` files). Built with a modern, sci-fi aesthetic that mirrors the in-game universe, this tool serves as your personal extensive biometric database.
+**SCCharacters (BioMetrics)** is a powerful, immersive desktop application designed to streamline the management, installation, and customization of your **Star Citizen character appearances** (`.chf` files). Whether you're looking to **import character presets**, backup your **Star Citizen DNA**, or share your avatar with the community, this tool serves as your personal extensive biometric database. It simplifies the process of changing your in-game appearance without manually editing files.
 
 ---
 
 ## 🖼️ Interface Gallery
 
 <div align="center">
-  <img src="assets/screenshots/dashboard.png" alt="Dashboard" width="800">
+  <img src="assets/screenshots/dashboard.png" alt="Star Citizen Character Manager Dashboard UI" width="800">
   <br><br>
-  <img src="assets/screenshots/splash_screen.png" alt="Splash Screen" width="400">
+  <img src="assets/screenshots/splash_screen.png" alt="BioMetrics Tool Splash Screen" width="400">
 </div>
 
 ---
@@ -33,6 +37,20 @@
 - Windows 10/11
 - Star Citizen installed (LIVE/PTU)
 
+
+
+## 🎮 Game Compatibility & Support
+
+**BioMetrics** is updated regularly to support the latest Star Citizen patches.
+
+| Star Citizen Patch | BioMetrics Version | Status |
+| :--- | :--- | :--- |
+| **Alpha 3.24+** | v2.0.0+ | ✅ Fully Supported |
+| **Alpha 3.23** | v1.5.0 | ⚠️ Partial Support |
+| **Alpha 3.18 - 3.22** | Legacy | ❌ Deprecated |
+
+*Compatible with LIVE, PTU, and EPTU environments.*
+
 ### Installation
 
 <div align="center">
@@ -59,6 +77,22 @@
 
 ---
 
+## ❓ Frequently Asked Questions (FAQ)
+
+### How do I install Star Citizen character presets?
+Simply download the **BioMetrics Manager**, browse the online repository tab, and click "Install" on any character you like. The tool handles the file placement automatically.
+
+### Where are Star Citizen character files located?
+Star Citizen stores character files in `StarCitizen\LIVE\user\client\0\CustomCharacters`. BioMetrics detects this path automatically so you don't have to find it yourself.
+
+### Can I share my Star Citizen character DNA?
+Yes! Use the **Backup** feature to export your character to a file, which you can then share with friends or the community.
+
+### Is this tool safe to use with Star Citizen?
+Yes, this tool only manages local `.chf` files (character presets) and does not modify game memory or executable files. It is compliant with the Star Citizen Fandom FAQ.
+
+---
+
 ## 💬 Community
 
 Join our growing community on Discord to share your characters, ask for help, or discuss features:

SECURITY.md

@@ -0,0 +1,29 @@
+# Security Policy
+
+## Supported Versions
+
+We recommend using the latest version of SCCharacters (BioMetrics) to ensure optimal security and feature compatibility with the latest Star Citizen patch.
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 2.0.x   | :white_check_mark: |
+| 1.x.x   | :x:                |
+
+## Reporting a Vulnerability
+
+SCCharacters is a fan-made tool intended for local file management (`.chf` files). It does not interact with game memory or network packets directly, minimizing most security risks associated with game modification tools.
+
+However, if you discover a security vulnerability within the application itself (e.g., potential for malicious file handling):
+
+1.  Please **do not** open a public issue.
+2.  Email `security@spielerwan.com` or send a DM via our [Discord Server](https://discord.gg/TGjCmzHR).
+3.  We will acknowledge your report within 48 hours and provide an estimated timeline for a fix.
+
+### Safe Usage Guidelines
+
+To ensure your Star Citizen account safety and PC security:
+
+*   **Only download SCCharacters from official sources:**
+    *   [Official GitHub Releases](https://github.com/Spieler1ONE1/SCCharacters/releases)
+*   **Verify Character Files:** When importing `.chf` files from unknown sources, ensure they are valid Star Citizen character files. SCCharacters includes basic validation, but caution is always advised.
+*   **Anti-Cheat Compliance:** This tool operates strictly within the bounds of the [Star Citizen Fandom FAQ](https://support.robertsspaceindustries.com/hc/en-us/articles/360006895793-Star-Citizen-Fankit-and-Fandom-FAQ). It modifies user-accessible configuration files only and is safe to use with Easy Anti-Cheat (EAC).

assets/logo.png

@@ -0,0 +1,33 @@
+# 🔧 Troubleshooting Guide for Star Citizen Character Import
+
+Common issues and solutions for managing your Star Citizen character DNA with BioMetrics.
+
+## ⚠️ "Character Not Found" in Game
+
+**Problem:** You installed a character, but it doesn't appear in the Character Customization screen inside Star Citizen.
+
+**Solutions:**
+1.  **Check Game Mode:** BioMetrics supports LIVE, PTU, and EPTU. Ensure you selected the correct environment in the settings.
+2.  **Restart the Game:** Star Citizen loads character files at startup or when entering the character creator. A restart is often required.
+3.  **Verify Path:** Go to `Settings` in BioMetrics and check if the *Star Citizen Installation Path* is correct (e.g., `C:\Program Files\Roberts Space Industries\StarCitizen`).
+
+## 🚫 "Access Denied" Error
+
+**Problem:** The application cannot write to the `CustomCharacters` folder.
+
+**Solutions:**
+1.  **Run as Administrator:** Right-click `SCCharacters.exe` and select "Run as Administrator".
+2.  **Check Folder Permissions:** Ensure your Windows user has write permissions to the Star Citizen directory.
+3.  **Antivirus Interference:** Add `SCCharacters.exe` to your antivirus exclusion list.
+
+## 🧬 Corrupted Character File (.chf)
+
+**Problem:** A character preset causes the game to crash or look distorted.
+
+**Solutions:**
+1.  **Delete the File:** In BioMetrics, go to the "Installed" tab and delete the problematic character.
+2.  **Verify Integrity:** Use the "Verify Files" option in the RSI Launcher to repair your game installation if crashes persist.
+
+## 🐞 Reporting Bugs
+
+If your issue isn't listed here, please [open an issue on GitHub](https://github.com/Spieler1ONE1/SCCharacters/issues) with your log file attached.