diff --git a/Package/Environment/MacOS/RetroFE.app/Contents/Info.plist b/Package/Environment/MacOS/RetroFE.app/Contents/Info.plist new file mode 100644 index 0000000..6d4359e --- /dev/null +++ b/Package/Environment/MacOS/RetroFE.app/Contents/Info.plist @@ -0,0 +1,33 @@ + + + + + CFBundleDevelopmentRegion + English + CFBundleExecutable + retrofe + CFBundleGetInfoString + 0.7.20, RetroFE + CFBundleIconFile + Misev.icns + CFBundleIdentifier + com.retrofe.RetroFE + CFBundleDocumentTypes + + + CFBundleInfoDictionaryVersion + 6.0 + CFBundlePackageType + APPL + CFBundleShortVersionString + 0.7.20 + CFBundleSignature + retrofe + CFBundleVersion + 0.7.20 + NSHumanReadableCopyright + Copyright 2016 by RetroFE Team. + LSMinimumSystemVersion + 10.3 + + diff --git a/Package/Environment/MacOS/RetroFE.app/Contents/Resources/Misev.icns b/Package/Environment/MacOS/RetroFE.app/Contents/Resources/Misev.icns new file mode 100644 index 0000000..a3f4bda Binary files /dev/null and b/Package/Environment/MacOS/RetroFE.app/Contents/Resources/Misev.icns differ diff --git a/Package/Environment/MacOS/collections/Arcade/settings.conf b/Package/Environment/MacOS/collections/Arcade/settings.conf new file mode 100644 index 0000000..70b157c --- /dev/null +++ b/Package/Environment/MacOS/collections/Arcade/settings.conf @@ -0,0 +1,55 @@ +############################################################################### +# The location of where your ROM items exist. Examples: +# list.path = D:/ROMs/MAME (absolute path) +# list.path = ../ROMs/MAME (relative path to root of FE dir) +# +# If BASE_ITEM_PATH=D:/ROMs and the name of this collection is named "Arcade" +# then the configuration below will search in D:/ROMs/Arcade +############################################################################### +#list.path = %BASE_ITEM_PATH%/%ITEM_COLLECTION_NAME%/roms + +############################################################################### +# If a game is specified in include.txt then it will be included in the list +# regardless of if the rom actually exists or not. Set this variable to false +# to exclude any items that cannot be found. +############################################################################### +list.includeMissingItems = true + +############################################################################### +# Extensions are comma separated without spaces +############################################################################### +list.extensions = zip + +############################################################################### +# If a menu.xml file exists, it will display the menu alphabetically. To +# not auto-sort the menu items alphabetically, set the following to false. +# This does not apply to how your ROMs are sorted. +############################################################################### +list.menuSort = true + +############################################################################### +# The executable to run when an item in a collection item is selected +############################################################################### +launcher = mame + +############################################################################### +# On default, MAME roms are not clearly named. We need to use the MAME +# metadata for them. +############################################################################### +metadata.type = MAME + +############################################################################### +# Default media paths to scan for artwork. Uncomment and edit to override +# the default values. +# +# media.screenshot = %BASE_MEDIA_PATH%/%ITEM_COLLECTION_NAME%/medium_artwork/screenshot +# media.screentitle = %BASE_MEDIA_PATH%/%ITEM_COLLECTION_NAME%/medium_artwork/screentitle +# media.artwork_back = %BASE_MEDIA_PATH%/%ITEM_COLLECTION_NAME%/medium_artwork/artwork_back +# media.artwork_front = %BASE_MEDIA_PATH%/%ITEM_COLLECTION_NAME%/medium_artwork/artwork_front +# media.logo = %BASE_MEDIA_PATH%/%ITEM_COLLECTION_NAME%/medium_artwork/logo +# media.medium_back = %BASE_MEDIA_PATH%/%ITEM_COLLECTION_NAME%/medium_artwork/medium_back +# media.medium_front = %BASE_MEDIA_PATH%/%ITEM_COLLECTION_NAME%/medium_artwork/medium_front +# media.screenshot = %BASE_MEDIA_PATH%/%ITEM_COLLECTION_NAME%/medium_artwork/screenshot +# media.screentitle = %BASE_MEDIA_PATH%/%ITEM_COLLECTION_NAME%/medium_artwork/screentitle +# media.video = %BASE_MEDIA_PATH%/%ITEM_COLLECTION_NAME%/medium_artwork/video +############################################################################### diff --git a/Package/Environment/MacOS/collections/CREATING_COLLECTIONS.txt b/Package/Environment/MacOS/collections/CREATING_COLLECTIONS.txt new file mode 100644 index 0000000..9ba6300 --- /dev/null +++ b/Package/Environment/MacOS/collections/CREATING_COLLECTIONS.txt @@ -0,0 +1,14 @@ +To create a new collection run the following commands at a commmand prompt. +(assuming you are in the root of your RetroFE directory) + +For Windows: + Core/RetroFE.exe -createcollection "Nintendo Entertainment System" + +For Linux or Mac: + ./RetroFE -createcollection "Nintendo Entertainment System" + + +Replace "Nintendo Entertainment System" with the collection name of your choosing. + +This will create a "Nintendo Entertainment System Folder", create the rom folder, +artwork folders and default configuration files. \ No newline at end of file diff --git a/Package/Environment/MacOS/collections/Sega Genesis/settings.conf b/Package/Environment/MacOS/collections/Sega Genesis/settings.conf new file mode 100644 index 0000000..86944b5 --- /dev/null +++ b/Package/Environment/MacOS/collections/Sega Genesis/settings.conf @@ -0,0 +1,50 @@ +############################################################################### +# The location of where your ROM items exist. Examples: +# list.path = D:/ROMs/MAME (absolute path) +# list.path = ../ROMs/MAME (relative path to root of FE dir) +# +# If BASE_ITEM_PATH=D:/ROMs and the name of this collection is named "Nintendo +# Entertainment System" then the configuration below will search in +# "D:/ROMs/Nintendo Entertainment System" +############################################################################### +# list.path = %BASE_ITEM_PATH%/%ITEM_COLLECTION_NAME%/roms + +############################################################################### +# If a game is specified in include.txt then it will be included in the list +# regardless of if the rom actually exists or not. Set this variable to false +# to exclude any items that cannot be found. +############################################################################### +list.includeMissingItems = true + +############################################################################### +# Extensions are comma separated without spaces +############################################################################### +list.extensions = zip + +############################################################################### +# If a menu.xml file exists, it will display the menu alphabetically. To +# not auto-sort the menu items alphabetically, set the following to false. +# This does not apply to how your ROMs are sorted. +############################################################################### +list.menuSort = true + +############################################################################### +# The executable to run when an item in a collection item is selected +############################################################################### +launcher = Genesis + +############################################################################### +# Default media paths to scan for artwork. Uncomment and edit to override +# the default values. +# +# media.screenshot = %BASE_MEDIA_PATH%/%ITEM_COLLECTION_NAME%/medium_artwork/screenshot +# media.screentitle = %BASE_MEDIA_PATH%/%ITEM_COLLECTION_NAME%/medium_artwork/screentitle +# media.artwork_back = %BASE_MEDIA_PATH%/%ITEM_COLLECTION_NAME%/medium_artwork/artwork_back +# media.artwork_front = %BASE_MEDIA_PATH%/%ITEM_COLLECTION_NAME%/medium_artwork/artwork_front +# media.logo = %BASE_MEDIA_PATH%/%ITEM_COLLECTION_NAME%/medium_artwork/logo +# media.medium_back = %BASE_MEDIA_PATH%/%ITEM_COLLECTION_NAME%/medium_artwork/medium_back +# media.medium_front = %BASE_MEDIA_PATH%/%ITEM_COLLECTION_NAME%/medium_artwork/medium_front +# media.screenshot = %BASE_MEDIA_PATH%/%ITEM_COLLECTION_NAME%/medium_artwork/screenshot +# media.screentitle = %BASE_MEDIA_PATH%/%ITEM_COLLECTION_NAME%/medium_artwork/screentitle +# media.video = %BASE_MEDIA_PATH%/%ITEM_COLLECTION_NAME%/medium_artwork/video +############################################################################### diff --git a/Package/Environment/MacOS/launchers/Genesis.conf b/Package/Environment/MacOS/launchers/Genesis.conf new file mode 100644 index 0000000..d927500 --- /dev/null +++ b/Package/Environment/MacOS/launchers/Genesis.conf @@ -0,0 +1,3 @@ +executable = open +arguments = -FWg -a /Applications/RetroArch.app --args -f "%ITEM_FILEPATH%" -L /Applications/RetroArch.app/Contents/Resources/cores/genesis_plus_gx_libretro.dylib + diff --git a/Package/Environment/MacOS/launchers/MAME.conf b/Package/Environment/MacOS/launchers/MAME.conf new file mode 100644 index 0000000..1c2ad70 --- /dev/null +++ b/Package/Environment/MacOS/launchers/MAME.conf @@ -0,0 +1,2 @@ +executable = open +arguments = -FWg -a /Applications/RetroArch.app --args -f "%ITEM_FILEPATH%" -L /Applications/RetroArch.app/Contents/Resources/cores/mame2014_libretro.dylib diff --git a/Package/Environment/MacOS/launchers/Main.conf b/Package/Environment/MacOS/launchers/Main.conf new file mode 100644 index 0000000..e38aed4 --- /dev/null +++ b/Package/Environment/MacOS/launchers/Main.conf @@ -0,0 +1,2 @@ +executable = %ITEM_FILEPATH% +arguments = diff --git a/README.md b/README.md index 6e7ffec..f0cffb3 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ RetroFE is a cross-platform frontend designed for MAME cabinets/game centers/etc. with a focus on simplicity and customization. -# Installing on MacOS # +# Installing on MacOS # The quickest and easiest way to install RetroFE for mac is to use [Homebrew]("http://brew.sh") and type: @@ -16,12 +16,12 @@ This will install RetroFE in /usr/local/opt/retrofe. RetroFE can then be started brew linkapps retrofe -### Install RetroArch: +### Install RetroArch (RetroFE requires a backend to load the emulator cores) brew cask install retroarch -RetroArch will be installed in /Applications. The RetroFE's sample configuration is setup to use RetroArch for mac. Before starting RetroFE you need to start up RetroArch to download the Genesis Plus GX core and the MAME 2014 core. In RetroArch use arrow keys to move and select by hitting X on the keyboard "Online Updater" -> "Core Updater" -> "". Also run "Online Updater" -> "" to keep RetroArch up to snuff. Check out RetroArch's documentation to learn more. Especially read about using Shaders to make games look better. +RetroArch will be installed in /Applications. The RetroFE's sample configuration is setup to use RetroArch for mac. Before starting RetroFE you need to start up RetroArch to download the Genesis Plus GX core and the MAME 2014 core as an example. In RetroArch use arrow keys to move and select by hitting X on the keyboard "Online Updater" -> "Core Updater" -> "". Also run "Online Updater" -> "" to keep RetroArch up to snuff. Check out RetroArch's documentation to learn more. Especially read about using Shaders to make your games look even better. ### Accessing RetroFE Configurations and installing ROMS @@ -67,14 +67,14 @@ RetroFE will load it's media and configuration files relative to where the binar ### Set RETROFE_PATH via flat file -Depending on your version of OS X the GUI will read user defined Environment variables from [another place]("http://stackoverflow.com/questions/135688/setting-environment-variables-in-os-x"). If you find this dificult to setup you can get around it by creating a text file in your HOME directory: /Users//.retrofe with one line no spaces: /your/new/retrofe. This will also work in Linux. RetroFE's configuration search order is 1st: ENV, Flat file, executable location. +Depending on your version of OS X the GUI will read user defined Environment variables from [another place]("http://stackoverflow.com/questions/135688/setting-environment-variables-in-os-x"). If you find this dificult to setup you can get around it by creating a text file in your HOME directory: /Users//.retrofe with one line no spaces: /your/new/retrofe. This will also work in Linux. RetroFE's configuration search order is 1st: ENV, Flat file, and executable location. ** See below for optional flat file example ** echo /your/new/retrofe > ~/.retrofe -## Mac download and compile RetroFE fron source code ## +## Mac download and compile RetroFE from source code ## If you don't use Homebrew you will need to download and install the same dependencies as given in the linux instuctions. You may need to export the libs with $LIBRARY_PATH and or supply the include folders with $CPATH before building.