A Sharp X68000 computer emulator for macOS platforms, based on the px68k emulator core. This repository is indirectly a fork of Mr. Hissorii's px68k. Based on his source code, Goroman converted it for iOS, and I made it works on MacOS.
MPX68K provides authentic Sharp X68000 emulation with modern Swift UI frameworks, bridging low-level C emulation code with SpriteKit for an optimal user experience on Apple silicon platforms.
- X68000 Hardware Emulation: CPU, sound, graphics, and I/O
- M68000 CPU: Powered by C68K emulator core
- FM Sound Synthesis: High-quality audio via fmgen
- Multiple Disk Formats: Support for .dim, .xdf, .hdf files
- Dual FDD Support: Menu-driven management for Drive 0 and Drive 1
- Hard Disk Support: HDD management with dedicated menu
- Screen Rotation: 90-degree rotation support for vertical games (tate mode)
- Enhanced Joycard: Keyboard, mouse input
- Native Menu Integration: Dedicated FDD, HDD, and Display menus with keyboard shortcuts
- macOS Support: Native menu bar and keyboard/mouse input
- iCloud Integration: Seamless file sync across devices
- macOS 15.0 or later
- Apple Silicon Mac
- Minimum 4GB RAM
- 1GB free disk space for ROM and disk images
MPX68K requires original SHARP X68000 system ROM files to function properly. These files are not included with the emulator and must be obtained separately.
You need the following ROM files from an original X68000 system:
| File | Description | Size |
|---|---|---|
CGROM.DAT |
Character Generator ROM | 768KB |
IPLROM.DAT |
Initial Program Loader ROM | 128KB |
Place the ROM files in the location:
- iCloud Document folder:
/Users/<username>/Documents/X68000 (/Users/<username>/Libraries/Containers/X68000/Data) ├── CGROM.DAT └── IPLROM.DAT
- Legal Notice: ROM files are copyrighted by SHARP CORPORATION. You must own an original X68000 system to legally use these files.
- File Names: ROM file names must be exactly
CGROM.DATandIPLROM.DAT. - File Integrity: Ensure ROM files are not corrupted. The emulator will display an error if files are missing or invalid.
- Backup: Always keep backup copies of your ROM files in a safe location.
When ROM files are properly installed, the emulator will:
- Load without ROM-related error messages
- Display the characteristic X68000 boot screen
- Show proper Japanese character rendering
If you see garbled text or boot failures, verify that your ROM files are correctly placed and named.
You need Apple Developer Account for using XCode and certification.
-
Clone the repository:
git clone https://github.com/YosAwed/MPX68K.git cd MPX68K -
Open in Xcode:
open X68000.xcodeproj
-
Build the project:
- Select your target platform (macOS)
- Build and run (⌘+R)
The project includes a dependency on the c68k CPU emulator which is built automatically.
- FDD → Open Drive 0... (⌘1): Insert disk into Drive 0
- FDD → Open Drive 1... (⌘2): Insert disk into Drive 1
- FDD → Eject Drive 0 (⇧⌘1): Eject disk from Drive 0
- FDD → Eject Drive 1 (⇧⌘2): Eject disk from Drive 1
- HDD → Open Hard Disk... (⌘H): Insert hard disk image
- HDD → Eject Hard Disk (⇧⌘H): Eject hard disk image
- Display → Rotate Screen (⌘R): Rotate screen between landscape and portrait modes
- Display → Landscape Mode: Set to standard horizontal orientation
- Display → Portrait Mode (90°): Set to vertical orientation for tate games
- Arrow Keys or WASD: 8-direction movement
- Space or J: Button A
- Z or K: Button B
| Extension | Description | Type | Platform Support | Security |
|---|---|---|---|---|
| .dim | Standard disk image | Floppy | macOS | Validated |
| .xdf | Extended disk format | Floppy | macOS | Validated |
| .hdf | Hard disk format | Hard Disk | macOS | Validated |
Hard disk images provide faster access and larger storage capacity compared to floppy disks: You can make HDD image using this application, but it requires initialization by using FORMAT.X running by Human68k on the emulator.
- Loading HDD Images: Use HDD → Open Hard Disk... menu or drag .hdf files
- Boot Priority: When both FDD and HDD are present, X68000 boots from FDD first (if a bootable disk is inserted), then falls back to HDD
- Performance: HDDs offer significantly faster loading times for large applications
- Capacity: Support for larger disk images suitable for complex software suites
- Persistence: Changes to HDD images are automatically saved
The X68000 follows the authentic boot sequence:
- FDD First: Always checks Drive 0 for bootable disk
- HDD Fallback: If no bootable FDD is present, boots from HDD
- System Disk Override: Insert a system floppy to boot from FDD even with HDD installed
- System Boot: Install X68000 system on HDD for faster startup when no FDD is inserted
- Applications: Store large software packages on HDD
- Development: Use HDD for compilers and development tools
- Games: Multi-disk games can be consolidated onto HDD
- Boot Override: Use system floppies to boot specific programs or perform maintenance
The X68000 emulator supports 90-degree screen rotation for vertical games, commonly known as "tate mode":
- Dragon Spirit: Classic vertical shooter requiring portrait orientation
- Other Vertical Games: Any X68000 game designed for vertical play
- Rotate Screen: Use Display → Rotate Screen (⌘R) to toggle between orientations
- Direct Selection: Choose Display → Portrait Mode (90°) for vertical games
- Window Adjustment: macOS automatically resizes the window for optimal display
- Control Consistency: Joycard controls remain unchanged regardless of rotation
- Smooth Rotation: SpriteKit-based rotation with proper aspect ratio maintenance
- Persistent Settings: Rotation preference is saved and restored between sessions
- Optimal Scaling: Automatic scaling ensures games fill the available screen space
- No Performance Impact: Rotation processing doesn't affect emulation performance
MPX68K uses a multi-layered architecture that bridges modern Swift UI frameworks with low-level C/C++ emulation code.
- Swift: UI layer, device management, file system, logging infrastructure
- C: Core emulation engine (CPU, hardware, memory management)
- C++: Sound generation (fmgen), emulation components
- Objective-C: Bridge layer for legacy compatibility
- GameScene.swift: Main emulation viewport using SpriteKit
- FileSystem.swift: Secure file handling and disk image management
- X68Logger.swift: Professional logging system with categorization
- X68Security.swift: Input validation and security functions
- JoyController.swift: GameController integration
- X68JoyCard.swift: Virtual joycard implementation
- px68k/: Complete X68000 hardware emulation in C/C++
- c68k/: Independent M68000 CPU emulator (static library)
For detailed architecture documentation with diagrams, see ARCHITECTURE.md.
- Dual FDD Drive Support: Independent Drive 0/1 management
- Hard Disk Drive Support: Complete HDD management with menu integration
- Screen Rotation Support: 90-degree rotation for vertical games (tate mode)
- Enhanced macOS Joycard: Keyboard and mouse input support
- Menu Integration: Native macOS menu bar with FDD, HDD, and Display shortcuts
- Window Management: Automatic window resizing for optimal display
- Memory Safety: Enhanced buffer bounds checking and validation
- Input Validation: Comprehensive file format validation with security checks
- Sandboxed File Access: Secure file system operations with proper scoping
- Professional Logging System: Replaced 200+ print statements with X68Logger
- Categorized logging (FileSystem, UI, Audio, Input, Emulation, Network)
- Debug logs automatically excluded from release builds
- Apple's unified logging system integration
- Performance monitoring and profiling capabilities
- Compiler Warnings Eliminated: Zero warnings in release builds
- Memory Management: Optimized Swift-C interoperability
- Build System: Enhanced Xcode project configuration
MPX68K/
├── X68000 Shared/ # Cross-platform Swift code
│ ├── px68k/ # C/C++ emulation core
│ │ ├── x68k/ # X68000 hardware components
│ │ ├── fmgen/ # FM sound synthesis (C++)
│ │ ├── m68000/ # CPU wrapper
│ │ └── x11/ # Platform abstraction
│ ├── *.swift # Swift UI and business logic
│ ├── X68Logger.swift # Professional logging system
│ ├── X68Security.swift # Security and validation
│ └── FileSystem.swift # Secure file management
├── X68000 macOS/ # macOS-specific code
│ ├── AppDelegate.swift # Menu integration
│ └── GameViewController.swift # Main view controller
├── c68k/ # M68000 CPU emulator (static lib)
│ └── c68k.xcodeproj # Independent build system
├── CLAUDE.md # Development guidelines
├── ARCHITECTURE.md # Detailed architecture docs
└── Settings.bundle/ # App settings configuration
- Xcode 15.0 or later
- macOS 15.0+ SDK
- Swift 5.9+
# Clean build
xcodebuild -project X68000.xcodeproj -scheme "X68000 macOS" -configuration Debug clean build
# Release build
xcodebuild -project X68000.xcodeproj -scheme "X68000 macOS" -configuration Release build
# Archive for distribution
xcodebuild -project X68000.xcodeproj -scheme "X68000 macOS" -configuration Release archive- C68K Library: Built automatically as dependency
- Main Project: Links against libc68k.a
- Package Dependencies: swift-crypto, swift-asn1 (managed by SPM)
- Zero Compiler Warnings: Clean builds with no warnings
- Memory Safety: Comprehensive bounds checking
- Thread Safety: Race condition prevention
- Performance Profiling: Built-in logging for performance monitoring
- Fork the repository
- Create a feature branch
- Make your changes
- Test on both platforms
- Submit a pull request
Please refer to CLAUDE.md for detailed development guidelines and architectural notes.
This project is based on px68k emulator. Please refer to the original px68k license terms.
- px68k (hissorii/px68k) — upstream emulator core. See upstream license files.
- c68k — MC68000 CPU emulator (via px68k). See upstream.
- fmgen by cisc — FM/PSG implementation (via px68k). See upstream.
No SHARP ROMs are distributed. Users must supply legally-owned ROMs.
- px68k: Original X68000 emulator core
- C68K: M68000 CPU emulator
- fmgen: FM sound synthesis library
- Sharp: Original X68000 computer system
SHARP X68000 is a trademark of SHARP CORPORATION. This project is not affiliated with SHARP CORPORATION.