- NOTE: You may need to install the [Microsoft Visual C++ Redistributable](https://go.microsoft.com/fwlink/?LinkId=746572)
- NOTE: You may need to install the [Microsoft Visual C++ Redistributable](https://go.microsoft.com/fwlink/?LinkId=746572)
-**macOS**:
-**macOS**:
-`brew install --cask gearsystem`
-`brew install --cask gearsystem`
- Or install manually: [Gearsystem-3.2.0-macOS.zip](https://github.com/drhelius/Gearsystem/releases/download/gearsystem-3.2.0/Gearsystem-3.2.0-macOS.zip)
- Or install manually: [Gearsystem-3.3.0-macOS.zip](https://github.com/drhelius/Gearsystem/releases/download/gearsystem-3.3.0/Gearsystem-3.3.0-macOS.zip)
- NOTE: You may need to install `libsdl2` and `libglew`
- NOTE: You may need to install `libsdl2` and `libglew`
-**iOS**: Build Gearsystem with Xcode and transfer it to your device. You can open rom files from other apps like Safari or Dropbox, or use your iCloud Drive.
-**iOS**: Build Gearsystem with Xcode and transfer it to your device. You can open rom files from other apps like Safari or Dropbox, or use your iCloud Drive.
- Supported platforms (standalone): Windows, Linux, macOS, Raspberry Pi and iOS.
- Supported platforms (libretro): Windows, Linux, macOS, Raspberry Pi, Android, iOS, tvOS, PlayStation Vita, PlayStation 3, Nintendo 3DS, Nintendo GameCube, Nintendo Wii, Nintendo WiiU, Nintendo Switch Emscripten, Classic Mini systemts (NES, SNES, C64 ...) and QNX.
- Full debugger with disassembler, breakpoints, debug symbols, memory editor, IO inspector and VRAM viewer including tiles, sprites, backgrounds and palettes.
- Full debugger with disassembler, breakpoints, debug symbols, memory editor, IO inspector and VRAM viewer including tiles, sprites, backgrounds and palettes.
- Portable mode by creating a file named `portable.ini` in the same directory as the application binary.
-Windows and Linux *Portable Mode* by creating a file named `portable.ini` in the same directory as the application binary.
@@ -60,7 +61,7 @@ Please, consider [sponsoring](https://github.com/sponsors/drhelius) and followin
...
@@ -60,7 +61,7 @@ Please, consider [sponsoring](https://github.com/sponsors/drhelius) and followin
### macOS
### macOS
- Install Xcode and run `xcode-select --install` in the terminal for the compiler to be available on the command line.
- Install Xcode and run `xcode-select --install` in the terminal for the compiler to be available on the command line.
- Run this commands to generate a Mac *app* bundle:
- Run these commands to generate a Mac *app* bundle:
``` shell
``` shell
brew install sdl2
brew install sdl2
...
@@ -88,8 +89,8 @@ make
...
@@ -88,8 +89,8 @@ make
### iOS
### iOS
- Install Xcode for macOS. You need iOS 13 SDK or later.
- Install latest Xcode for macOS.
- Build the project `platforms/ios/Gearsystem.xcodeproj`
- Build the project `platforms/ios/Gearsystem.xcodeproj`.
- Run it on real hardware using your iOS developer certificate. Make sure it builds on *Release* for better performance.
- Run it on real hardware using your iOS developer certificate. Make sure it builds on *Release* for better performance.
### Libretro
### Libretro
...
@@ -140,7 +141,6 @@ sudo make install
...
@@ -140,7 +141,6 @@ sudo make install
- Use `export SDL_AUDIODRIVER=ALSA` before running the emulator for the best performance.
- Use `export SDL_AUDIODRIVER=ALSA` before running the emulator for the best performance.
- Gearsystem generates a `gearsystem.cfg` configuration file where you can customize keyboard and gamepads. Key codes are from [SDL](https://wiki.libsdl.org/SDL_Keycode).
- Gearsystem generates a `gearsystem.cfg` configuration file where you can customize keyboard and gamepads. Key codes are from [SDL](https://wiki.libsdl.org/SDL_Keycode).