# FCE360 — Archived Mirror (Xbox 360 NES/Famicom Emulator)

This repository preserves **FCE360**, an Xbox 360 port of the NES/Famicom emulator, as it originally appeared on Google Code.  
**No changes** have been made to the uploaded files (including original Visual Studio/XDK project folders).  
The goal is **historical preservation** and ease of access for research.

> **Status:** Archived / Unmaintained  
> **Upstream:** Google Code (defunct) → mirrored here  
> **License:** GPL-2.0-or-later (see source headers / included license files)  
> **Structure:** Subversion-style layout (trunk/branches/tags/wiki)

---

## What's in this repo

This repository contains the complete source code for FCE360 in a Subversion-style layout:

- **`trunk/fce360/`** — Main source code directory
  - `fceux/` — Core emulator source code (FCEUX-based)
    - `fceux/` — FCEUX emulator core (CPU, PPU, mappers, input, etc.)
    - `xbox/` — Xbox 360-specific implementation (audio, video, input, UI)
    - `media/` — UI assets (XUI files, images, effects)
    - `utils/` — Utility code (unzip support)
  - `fceux.sln` — Visual Studio 2008 solution file
  - `lib/` — Third-party libraries
    - `zlib-1.2.5/` — Compression library (included)
- **`branches/`** — Empty (no branches in this snapshot)
- **`tags/`** — Empty (no tags in this snapshot)
- **`wiki/`** — Wiki documentation directory

Original project layout as retrieved; nothing removed or modified.

---

## About FCE360

FCE360 is a homebrew port of a NES/Famicom emulator to Xbox 360, originally by **Ced2911** and contributors.  
It uses the Xbox 360 homebrew toolchain (XDK/XUI/Direct3D 9-era projects) and depends on the FCEU/FCEUX codebase.

**Credits (historical):**
- Port & Xbox 360 frontend: **Ced2911** (and community contributors)
- Core emulator: **FCEU / FCEUX** teams
- Additional third-party libraries (e.g., zlib/libpng) under their respective licenses

If you are a rights holder and want attribution adjusted or content removed, please open an issue.

---

## Building (historical reference)

> **Note:** Building requires legal access to the Xbox 360 XDK and appropriate SDK components.  
> Neither binaries nor SDK files are provided or linked here.

Typical historical setup:
1. Windows with **Visual Studio 2008** (VC9; the project file targets this version).
2. Xbox 360 **XDK** with XUI and D3D9 support installed and configured.
3. **zlib-1.2.5** is included in `lib/zlib-1.2.5/` (no external copy needed).
4. **SDL** may be referenced in include paths but is not included in this repository.

To build:
1. Open `trunk/fce360/fceux.sln` in Visual Studio 2008.
2. Select the Xbox 360 platform and desired configuration (Debug/Release).
3. Resolve any missing dependencies (e.g., SDL if referenced).
4. Build the solution.

Project paths and exact SDK version expectations come from the original snapshot and may need local path fixes.

---

## Running (for archival releases)

This repository contains source code only. To run on an Xbox 360:
1. Build the project using the instructions above to generate `default.xex`.
2. Copy the built executable and required media files to your RGH/JTAG console (e.g., `Hdd1:\_Emus\fce360\`).
3. Ensure all media assets from `fceux/media/` are included with the build.
4. Launch `default.xex` from your file manager (Aurora/Freestyle/etc.).
5. Place your **legally owned** ROMs in the emulator's expected `roms` folder (path varies by build).
6. Some features may require additional BIOS/data files not provided here (do not request or upload them).

Because this is an archival snapshot, UI, controls, and paths may differ from other forks. Use the in-app UI/help.

---

## Why preserve this?

- Google Code is gone; many console homebrew projects became hard to find.
- Keeping an **unaltered** snapshot helps researchers verify provenance, reproduce builds, and compare ports.

If you fork this for active development, please clearly label your fork and document your changes.

---

## Legal

- Code in this snapshot is **GPL-2.0-or-later** unless a file states otherwise.  
- Third-party libraries retain their original licenses.
- Xbox 360 XDK is proprietary. Do **not** ask for SDK files or links.

---

## Contributing to this mirror

This repository intentionally mirrors an original drop.  
If you spot metadata errors (description, dates) or want to add context documents (read-only), open an issue.  
For functional changes, please fork to keep this mirror pristine.

---

## Acknowledgements

Thanks to the original authors and the preservation community for keeping classic console homebrew accessible.