adding MacOS samples in Packages

This commit is contained in:
RetroPrime 2016-12-22 06:57:49 -05:00
parent bff4aaa745
commit 17b522fa1f
9 changed files with 164 additions and 5 deletions

View File

@ -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>

View File

@ -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
###############################################################################

View File

@ -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.

View File

@ -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
###############################################################################

View File

@ -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

View File

@ -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

View File

@ -0,0 +1,2 @@
executable = %ITEM_FILEPATH%
arguments =

View File

@ -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.