Index
  1. About
  2. Components
  3. EmuExec
  4. Driver HowTo
  5. Screenshots
  6. ToDo
  7. Changelog
Welcome to

KDEAddons-Emulation 3.5.2
 
"Simplify emulation by desktop integration"

1. About
The general puropse of this package is the full desktop integration of all available emulators and virual machines for the linux operating system. Using kde and its basic components, it is possible to reduce the setup and access up to a minimum. To get a small overview, feel free to read the documentation and install the deb or rpm package which should run on every distribution based on kde 3.x or higher.

2. Components
This is the component list of this package.
Don´t expect this list to be complete. It´s just a small overview which will grow soon!
Konqueror/Desktop
 
  • Mimetypes
 Over 35 mimetypes with 60 known extensions
  • Menu items
 Intuitive KMenu for everything what is possible
  • Images/Artwork
 Over 300 images and icons
  • Dialogs and tools
 Many nice dialogs and tools for various tasks
 
Konqueror/Services
 
  • XMess service
 Select system and image type to start
  • ISO/Img mount
 Un/Mount Amiga/Mac/IMG files using a simple click
  • ISO/Img boot
 Boot iso or image with the right mouse button
  • Emuexec service
 Autodetect the best driver for rom/zip file
  • Netplay settings
 Start server or connect as client
 
Frontends and tools
 
  • kqemu
 QEMU frontend and config generator
  • kqemu-img
 QEMU image generator and converter
  • kqemu-wm
 QEMU kdm wrapper
  • kbiosget
 XMess/Vice bios downloader
  • kmameget
 Mame artwork downloader
  • wine-lnk-wrapper
 Use lnk files natively in konqueror
  • wine-url-wrapper
 Open url files in konqueror
  • wine-exe-wrapper
 Distinguish between dos or win executable
  • confgen-freevo
 Automatically generate and add freevo settings
  • confgen-mythtv
 Generate mythtv config and insert using sql
  • online installer
 Online installers for many emulators and tools


3. EmuExec
EmuExec is the most importent component, because it prepares everything at starts the machine.
To have a starting point, just take a look at the usage information:		 


Usage: emuexec [driver] [command] [file]

Available commands:

run Execute image-file
cmd Output full command
exe Output executable path
opts Output commandline options
info Show file and system information

Available drivers:

aranym, atari5200, atari800, atariplusplus, autoprobe, dgen, dosbox, fceu,
gngeo, hatari, mednafen, mupen64, neopocott, o2em, openmsx, qemu,
rdragon, scummvm, sdlgnuboy, sdlhandy, sms_sdl, snes9x, stella, uae, vba,
virtualjaguar, x128, x64, xcbm2, xe, xeuphoric, xmame, xmess, xmess-a5200,
xmess-a7800, xmess-coleco, xmess-genesis, xmess-gg, xmess-jaguar, xmess-sms,
xpet, xplus4, xvic, xyame, zsnes

Info: Emuexec uses its drivers to get all information on how to start the virtual machine or emulator. It acts as a wrapper script to collect all infomation switches and preferences and initiates the emulation process. By using this wrapper you will get the following benefts:

  • One configuration file for all emulation/virtualisation tasks
  • Easy setup tool using kommander-script (kemuexec)
  • Supports zip,rar,tar,gzip,bzip2,lha,arj,ace and 7zip decompression
  • Fullscreen emulation for emulators without fullscreen mode
  • Resolution switching using xrandr (when requested by driver)
  • Autoprobe driver for automatical selection of best emulator
  • Automatic Screenshot functionality
  • Dynamic integration into any filemanager or htpc (freevo,mythtv)


4. Driver HowTo
Writing your own driver is very simple. It just consists of 3 easy steps:
  1. Use the template below and enter all options and information
  2. Copy the file into "/usr/share/emulation/lib/"
  3. Run "emuhelper update"
After the last step, EmuExec is aware of the new driver. If it´s worth to include into default drivers, just send it to me and I will do it. But please test it as much as you can and give me detailed information about the used emulator.		 

##
## Emulator basics
##

emu_executable="myemu" #Emulator command without path
emu_driver_name="mydriver" #Name of this file/driver
emu_driver_version="1.0" #Pseudo driver version
emu_systems=";pce;oric;" #Systems emulated by driver
emu_system_fullname="My Emu" #Display name of system
emu_defaults="-donothing" #Default emulator options
emu_file_option="-cart" #Option specified before rom-image
emu_file_suffixes=";pce;rom;" #Suffixes supported by driver
emu_decomp_suffixes=";zip;" #Native decompression supported by driver
emu_decomp_tar="1" #Driver supports tar files
emu_autoscreenshot="1" #Automatically take screenshot
emu_autoscreenshot_delay="25" #Take screenshots after n seconds

##
## Video Settings
##

#Video driver
emu_video_opengl="-vogl" #opengl video
emu_video_x11="-vox11" #x11 video
emu_video_sdl="-vosdl" #sdl video

#Window/Fullscreen mode
emu_video_fullscreen="-fs" #fullscreen mode 
emu_video_windowed="-win" #windowed mode

#Scale factor
emu_video_scale_1="-x 1 -y 1" #Scale factor 1
emu_video_scale_2="-x 2 -y 2" #Scale factor 2
emu_video_scale_3="-x 3 -y 3" #Scale factor 3
emu_video_scale_4="-x 4 -y 4" #Scale factor 4

##
## Audio Settings
##

#Audio driver
emu_audio_driver_off="-aodummy" #Disable audio output
emu_audio_driver_alsa="-aoalsa" #Use alsa sound
emu_audio_driver_arts="-aoarts" #Use arts daemon
emu_audio_driver_oss="-aooss" #Use opensound
emu_audio_driver_sdl="-aosdl" #Use sdl sound

#Audio device
emu_audio_device_off="-ad off" #Disable audio device
emu_audio_device="-ad /dev/dspX" #Use $audio_device for X
#Audio mode
emu_audio_stereo="-stereo" #Force stereo output
emu_audio_mono="-mono" #Force mono output

#Audio settings
emu_audio_optimized="-stereo -28800" #Optimized audio values
emu_audio_default="-mono -14400" #Default audio values

##
## Input Settings
##

emu_gamepad_off=""
emu_gamepad_player1="-joy1 /dev/jsX" #Use $gamepad_player1 for X
emu_gamepad_player2="-joy2 /dev/jsY" #Use $gamepad_player2 for Y
emu_gamepad_player3="" #See above
emu_gamepad_player4="" #See above

##
## Advanced Settings
##

#Gui settings
emu_adv_show_gui="-showgui" #Show emulator gui
emu_adv_hide_gui="-nogui" #Hide emulator gui
#Cheats
emu_adv_enalbe_cheats="-cheats" #Enable cheats
emu_adv_disalbe_cheats="-nocheats" #Disable cheats
#system
emu_adv_system_auto="-autonorm" #Autoprobe tv norm
emu_adv_system_pal="-pal" #Force pal mode
emu_adv_system_ntsc="-ntsc" #Fprce ntsc mode

##
## Various fixes (e.G. no fullscreen support, resolution, etc...)
##

#Fullscreen-fix using kstart
#emu_fullscreen_fix="kstart --activate --currentdesktop --fullscreen --maximize"

#Fullscreen-fix using xrandr
#emu_fullscreen_xrandr="800 x 600"

##
## Main function (do not change if you don´t know what you do!)
##

source $GLOBALDIR/lib/generic/emuexec_main


5. Screenshots
Shot1
KEmuExec and Konqueror example
Shot2
Virtual Machine Configuration

Shot3
KMenu and advanced options