README

TODO: HELP NEEDED ! 
- Link a theme for each list - 
- Video with some freezes and memory leaks ... -

Version from "Livemamecab" https://github.com/fredbcode/livemamecab 
Demo ISO Here http://traceroot.c.la
Ubuntu PPA here https://launchpad.net/~sergio-br2/+archive/ubuntu/cabrio (Thanks Sergio Benjamim)

- Added <music> tag to themes, allowing selection of background music by Pieter Hulshoff
- Fixed memory leaks in XML configuration functions by Pieter Hulshoff
- Improved handling of long game lists by Pieter Hulshoff 
- Fix ffmpeg problem, should works with libavcodec53/54/55 fixed by f.dorin
- New option "video loop" for snap
- New option "video sound" for snap
- New option "theme sound" music theme onf/off
- New option "theme sound" volume (1 min -> 128 Max)  
- New option direct switch to list 
- New option hide buttons 
- Save selection game at cabrio start 
- SDL2 support by sergio-br2

New options:

<video-loop>false/true</video-loop>
<video-sound>false/true</video-sound> 
<theme-sound>false/true</theme-sound>
<music-volume>50</music-volume>
<hide-buttons>false/true</hide-buttons>
<concat-path>false/true</concat-path>

Option for music:

Put your music here /usr/share/cabrio/sounds/music.mp3
You can also use the tag <music> placed within the <theme> tag (in a theme XML file).
A directory indication will cause a random music file to be selected from that directory. 
In your theme file:

<name>lmc</name>
<music>/path/music/</music>

Option for direct list:

Example: keyboard touch "a" to directly switch to the first list and "b" for the second (max 5 lists)

<event>
<name>list1</name>
<value>a</value>
<device>
  <type>keyboard</type>
  <id>0</id>
</device>
</event>
<event>
<name>list2</name>
<value>b</value>
<device>
  <type>keyboard</type>
  <id>0</id>
</device>
</event>

Option to use full path for roms:

You can use directory tag to indicate a rom folder, so you don't need to use
full path in the rom-image tag. But some emulators have problem with this, 
because they need the full path instead Cabrio default approach: it first go
to the directory, and then executes the emulator. So you can use concat-path
tag, it will join both directory and rom-image in one string only:

<emulators>
  <emulator>
    <name>MAME</name>
    <display-name>MAME</display-name>
    <executable>retroarch</executable>
    <platform>Arcade</platform>
    <directory>/home/your-user/Path/to/your/ROMs/</directory>
    <concat-path>true</concat-path>
    <params>
      <param>
        <name>-L</name>
      </param>
      <param>
        <name>/usr/lib/libretro/mame_libretro.so</name>
      </param>
    </params>
  </emulator>
</emulators>
[...]
<game>
  <name>After Burner II</name>
  <platform>Arcade</platform>
  <rom-image>aburner2.zip</rom-image>
</game>

This results:

retroarch -L /usr/lib/libretro/mame_libretro.so /home/your-user/Path/to/your/ROMs/aburner2.zip

======

Cabrio is an emulator front-end primarily designed for use with arcade
cabinets. It features a simple graphical interface which is easy to use
with limited controls (e.g. a joystick).


Installation
------------
You will need the following libraries and their headers/development packages:
  * SDL2
  * SDL2_image
  * SDL2_gfx
  * SDL2_mixer
  * SDL2_ttf
  * glut
  * libxml2
  * ffmpeg

Compile the program by running 'make' in this directory. Install by running
'make install' (this will usually have to be done as root, but the location
can be edited in the Makefile).

See http://www.cabrio-fe.org/support/compile.html for more information.

Debian/Ubuntu:

apt-get install gcc make libc6-dev libavcodec-dev libavutil-dev libavformat-dev libswscale-dev libsdl2-dev libsdl2-image-dev libsdl2-gfx-dev libsdl2-mixer-dev libsdl2-ttf-dev libxml2-dev


Configuration
-------------
Please see http://www.cabrio-fe.org/support/quickstart.html


License
-------
Copyright (c) 2009 - Steve Maddison <steve@cosam.org>
Distributed under the GNU General Public License (see the COPYING file
for details).


Credits
-------
Default background, "Star-Forming Region LH 95 in the Large Magellanic
Cloud": NASA, ESA, and the Hubble Heritage Team (STScI/AURA)-ESA/Hubble
Collaboration, Acknowledgment: D. Gouliermis (Max Planck Institute for
Astronomy, Heidelberg). http://hubblesite.org/

Default font "FreeSans.ttf" courtesy of the GNU FreeFont project:
http://www.gnu.org/software/freefont/

Music Theme: Happy Arcade Tune 	
Author: rezoner from http://opengameart.org