diff --git a/README.md b/README.md new file mode 100644 index 0000000..b298c72 --- /dev/null +++ b/README.md @@ -0,0 +1,111 @@ +# 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. \ No newline at end of file