Skip to content
An iOS/tvOS Frontend for multiple emulators, currently supporting Sega Genesis, Game Gear/Master System, Sega CD, SNES, NES, GB/GBC and GBA.
C C++ Objective-C SourcePawn Objective-C++ JavaScript Other
Find file

README.mdown

Provenance

An iOS & tvOS Frontend for multiple emulators

Building Provenance

See the instructions on the wiki And follow them to the letter. Any issues raised that clearly demonstrate that the instructions haven't been followed will be closed.

Why 'Provenance'?

I was looking for a word with a similar meaning to Genesis and came across Provenance:

prov·e·nance
/ˈprävənəns/
Noun

The beginning of something's existence; something's origin.

Systems currently supported by Provenance:

  • Sega
    • SG-1000
    • Master System
    • Genesis / Mega Drive
    • MegaCD See wiki
    • Game Gear
  • Nintendo
    • NES
    • Famicom Disk System See Wiki
    • SNES (Super Nintendo)
    • Gameboy / Gameboy Color
    • Gameboy Advance

Features

  • Very accurate & full speed emulation
  • Stereo sound
  • Save States
  • Battery saves (native game saves, i.e. Sonic 3, Pokémon, etc)
  • Adjust onscreen control opacity so they don't get in your way
  • Portrait and landscape support
  • Supports all MFi game controllers, and some iCade Controllers
  • Local multiplayer with external controllers
  • Built-in web server
    • Import/Export game saves
    • Import/Export ROMs
  • "Open In..." support
    • Download a ROM using Mobile Safari and import it into Provenance
  • iTunes File Sharing
    • Just drop ROMs into the app from iTunes on your Mac or PC
  • Uses OpenVGDB to look up game information and artwork
    • OpenVGDB is a database maintained by the OpenEmu Team and automatically downloads available information and artwork
    • Custom artwork is also supported
  • Game library searching
  • Supports iOS 8+
    • 3D Touch shortcuts for recent games on iPhone 6S/Plus
  • Supports Apple TV tvOS 9+
    • TopShelf support

Feel free to suggest/request features using the Issues page, but please read all issues (open and closed) before raising new ones to avoid duplicates.

Please note that this is an open source project done in the free time of the author and contributors and new features and new emulator cores may take time. Adding a comment to an existing issue does not help speed up the development in any way.

Importing ROMs

See the instructions on the wiki

Screenshots

Provenance Screenshots

Attributions

Sega system emulation is provided by Genesis Plus GX, originally written by Charles Mac Donald, and later improved by Eke-Eke.

NES/Famicom Disk System emulation is provided by FCEUX.

SNES (Super Nintendo) emulation is provided by SNES9x.

Gameboy Advance emulation is provided by Visualboy Advance.

Gameboy/Gameboy Color emulation is provided by Gambatte.

The specific implementations used in Provenance are loosely based on some of the work done by OpenEmu (source) and RetroArch (source).

Provenance License

Copyright (c) 2016, James Addyman (JamSoft). All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

  1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
  2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
  3. Neither the name of the Provenance project nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY JAMES ADDYMAN (JAMSOFT) "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL JAMES ADDYMAN (JAMSOFT) OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

The views and conclusions contained in the software and documentation are those of the authors and should not be interpreted as representing official policies, either expressed or implied, of James Addyman (JamSoft).

OpenEmu License

Copyright (c) 2016, OpenEmu Team

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

  • Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
  • Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
  • Neither the name of the OpenEmu Team nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY OpenEmu Team ''AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL OpenEmu Team BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Something went wrong with that request. Please try again.