From 17b522fa1f7d202fc18b5635827bdb55cd4f2078 Mon Sep 17 00:00:00 2001
From: RetroPrime <devnull@localhost>
Date: Thu, 22 Dec 2016 06:57:49 -0500
Subject: [PATCH] adding MacOS samples in Packages

---
 .../MacOS/RetroFE.app/Contents/Info.plist     |  33 +++++++++++
 .../RetroFE.app/Contents/Resources/Misev.icns | Bin 0 -> 20102 bytes
 .../MacOS/collections/Arcade/settings.conf    |  55 ++++++++++++++++++
 .../collections/CREATING_COLLECTIONS.txt      |  14 +++++
 .../collections/Sega Genesis/settings.conf    |  50 ++++++++++++++++
 .../Environment/MacOS/launchers/Genesis.conf  |   3 +
 Package/Environment/MacOS/launchers/MAME.conf |   2 +
 Package/Environment/MacOS/launchers/Main.conf |   2 +
 README.md                                     |  10 ++--
 9 files changed, 164 insertions(+), 5 deletions(-)
 create mode 100644 Package/Environment/MacOS/RetroFE.app/Contents/Info.plist
 create mode 100644 Package/Environment/MacOS/RetroFE.app/Contents/Resources/Misev.icns
 create mode 100644 Package/Environment/MacOS/collections/Arcade/settings.conf
 create mode 100644 Package/Environment/MacOS/collections/CREATING_COLLECTIONS.txt
 create mode 100644 Package/Environment/MacOS/collections/Sega Genesis/settings.conf
 create mode 100644 Package/Environment/MacOS/launchers/Genesis.conf
 create mode 100644 Package/Environment/MacOS/launchers/MAME.conf
 create mode 100644 Package/Environment/MacOS/launchers/Main.conf

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 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>CFBundleDevelopmentRegion</key>
+    <string>English</string>
+    <key>CFBundleExecutable</key>
+    <string>retrofe</string>
+    <key>CFBundleGetInfoString</key>
+    <string>0.7.20, RetroFE</string>
+    <key>CFBundleIconFile</key>
+    <string>Misev.icns</string>
+    <key>CFBundleIdentifier</key>
+    <string>com.retrofe.RetroFE</string>
+    <key>CFBundleDocumentTypes</key>
+    <array>
+    </array>
+    <key>CFBundleInfoDictionaryVersion</key>
+    <string>6.0</string>
+    <key>CFBundlePackageType</key>
+    <string>APPL</string>
+    <key>CFBundleShortVersionString</key>
+    <string>0.7.20</string>
+    <key>CFBundleSignature</key>
+    <string>retrofe</string>
+    <key>CFBundleVersion</key>
+    <string>0.7.20</string>
+    <key>NSHumanReadableCopyright</key>
+    <string>Copyright 2016 by RetroFE Team.</string>
+    <key>LSMinimumSystemVersion</key>
+    <string>10.3</string>
+</dict>
+</plist>
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 0000000000000000000000000000000000000000..a3f4bda47007f57660a67f7f1db2db7dcd7edb67
GIT binary patch
literal 20102
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
Y!<X#dySpIU-ra?GEi&T)-QEfR2c?fDBme*a

literal 0
HcmV?d00001

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" -> "<Core Name>". Also run "Online Updater" -> "<Every Updater choice>" 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" -> "<Core Name>". Also run "Online Updater" -> "<Every Updater choice>" 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/<you>/.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/<you>/.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.