# Stellar Blade Menu Background Changer

## IMPORTANT: RAD Video Tools Required!

This tool requires RAD Video Tools to be installed separately for proper BK2 video conversion.

## Quick Start

1. **Download and install RAD Video Tools** (REQUIRED):
- Download from: https://www.radgametools.com/down/Bink/RADTools.7z
- Extract and install to: C:\Program Files (x86)\RADVideo

2. **Run the tool**:
- Double-click `StellarBladeModTool.exe`
- No Python installation needed!

3. **Use the tool**:
- Set your Stellar Blade installation path
- Choose "Video Conversion" to convert MP4 to BK2
- Or use "Use Converted File" if you already have a BK2 file
- Click "Restore Original" to revert changes

## What's Fixed in v2.2.1

- **Fixed PyInstaller compatibility**: No more crashes on startup
- **Improved error handling**: Better logging and error messages
- **Stable executable**: Runs properly as standalone .exe file
- **Enhanced logging**: Debug information saved to stellar_blade_mod.log

## Features

- **Guided Video Conversion**: Step-by-step instructions for RAD Video Tools
- **Use Converted File**: Install pre-converted BK2 files directly
- **Automatic Backup**: Original files are safely backed up
- **Easy Restore**: One-click restoration of original background
- **Path Detection**: Auto-detects game and RAD Video Tools locations

## Requirements

- **RAD Video Tools** (for BK2 conversion) - Download separately
- **Stellar Blade PC** (Demo or Full Version)
- **Windows 10/11** (64-bit recommended)

## Troubleshooting

- If RAD Video Tools isn't detected, use the Browse button to locate it
- Check `stellar_blade_mod.log` for detailed error information
- Make sure Stellar Blade is properly installed
- Run as Administrator if you encounter permission issues
- If the app crashes, check the log file for specific error details

## Files Included

- `StellarBladeModTool.exe` - Main application (no Python needed)
- `installation_guide.md` - Detailed installation instructions
- `requirements.txt` - Technical requirements information

## Support

For issues or questions, check the installation guide or create an issue on the project repository.

---
**Version**: 1.0.0
**Compatible with**: Stellar Blade PC Demo/Full Version
**Build**: Standalone executable (no Python installation required)
**Fix**: Resolved stdout redirection issues in PyInstaller builds