# NukeBox V1.0.1  
### Unofficial War Thunder Audio Companion

---

## Overview

**NukeBox** is an open-source utility that automatically launches your custom music alongside **War Thunder**.

It watches for the game process (`aces`) and triggers a user-defined audio environment using `mpv`, turning your session into a fully controlled audio experience.

This is not a modification of the game itself.  
It is an external companion tool designed for control, atmosphere, and workflow.

---

## Purpose

War Thunder launches silent.  
NukeBox changes that.

Instead of manually starting music every session, NukeBox:

- Detects when War Thunder starts
- Automatically launches your playlist
- Stops playback when the game closes

It transforms the experience into something closer to a live operational environment rather than a static application.

---

## Features

- 🎧 **Automatic Music Launch**
  - Starts audio when War Thunder is detected

- 🔁 **Loop / Playlist Control**
  - Loop indefinitely or play once

- 📁 **Custom Music Directory**
  - Point to any folder containing audio files

- 🔊 **Volume Control**
  - Adjustable playback levels

- 🌗 **Theme System**
  - Dark / Light / Metallic UI modes

- ⚙️ **Profile System**
  - Save, edit, rename, delete configurations

- 🧠 **Process Monitoring**
  - Watches for `aces` (War Thunder executable)

- 🖥️ **Cross Platform Concept**
  - Built for Linux
  - Adaptable for Windows and macOS

---

## Requirements

### Linux (Primary Target)
```bash
sudo apt install mpv
```

### Python
- Python 3.x
- tkinter (usually included)

---

## How It Works

At its core, NukeBox runs a lightweight monitoring loop:

```text
IF War Thunder is running → start mpv with your music
IF War Thunder stops → terminate mpv
```

The GUI simply controls how this behavior is configured.

---

## Usage

### Run the Application

```bash
python3 nukebox.py
```

### Basic Flow

1. Launch NukeBox
2. Select your music folder
3. Configure volume / loop / fade
4. Launch War Thunder
5. Music starts automatically

---

## Advanced Use

NukeBox can be extended beyond normal usage:

### Auto Start on Boot
- Add to system startup scripts
- Use `.desktop` autostart (Linux)

### Run as Background Service
- Convert to a systemd service
- Always monitor for game launch

### Modify Target Application
- Replace `aces` with any process name
- Use NukeBox as a universal audio trigger system

---

## Important Notes

- This is an **unofficial utility**
- It does **not modify War Thunder**
- It does **not interact with game files**
- It operates entirely outside the game

---

## Aesthetic Direction

NukeBox embraces a **war room / control panel** aesthetic:

- Signal monitoring
- Audio waveform visuals
- Operational status feel
- USO / command center atmosphere

It is intentionally more than just a music launcher.

---

## Known Behavior

- Requires monitor loop to be active
- Uses `mpv` for playback
- Terminates audio cleanly when the game exits
- Designed for stability over complexity

---

## Philosophy

NukeBox is built on a simple idea:

> If a system can react, it should feel alive.

This tool removes manual friction and replaces it with automatic response.

---

## License

Open-source.  
Use, modify, extend as needed.

---

## Final Note

NukeBox is not required.  
It is not essential.  

But once it’s running, going back to silence feels… wrong.