Official Homepage for DBGL: DOSBox Game Launcher

example

An open-source, free, multi-platform frontend for DOSBox

Latest news: DBGL version 0.66 is released!

If you're willing to volunteer to translate DBGL into another language, I'd like to know! Just know that you don't have to have any programming skills to be able to help! Simply follow these instructions. English, Chinese, Danish, Dutch, German, Italian and Spanish are already covered.


More DOSBox-related links

Other frontends

DBGL

DOSBox

Information

Game download

Game patches

Game emulators

Introduction

Hi everybody,

DBGL is a Java frontend for DOSBox, based largely upon the proven interface of D-Fend.

The frontend is by no means finished. It is a work in progress and lacking many features, but the core is working, and I think the product is somewhat usable as it is. Please bear in mind that the interface is still quite rough around the edges.

To name a few of its features:

  • D-Fend profiles importing
  • Multiple DOSBox versions support, select any pre-configured version per profile
  • Template support
  • Meta-information, links and custom labels can be specified per profile
  • Booter games support
  • Basic (7-)zipfile support (using a dosbox version that has physFS integrated, for example Ykhwong's or Gulikoza's)
  • Can easily handle 1000+ profiles (for those interested: DBGL uses the Java HSQLDB database engine, and SWT for its GUI)
  • No data replication; all DOSBox profile information that can be stored in the .conf file is stored in there, and only in there. Extra information such as the profile's Title, developer name, status etc. is stored in a single human-readable database file (database.script). What this basically means is that you can still start a given profile without even using DBGL (dosbox -conf dosbox.conf -conf profiles\lemmings.conf), if you want.
  • Use with DOSBox v0.73, v0.72, v0.71, v0.70, v0.65, v0.63 or CVS

Importing D-Fend profiles...

DBGL can optionally use the DOSBox 'Multiple Config Files' functionality, to use incremental config files. What this means, is that your game profile only stores the differences compared to the main dosbox.conf file. Then, suppose you want to switch all profiles from say output=surface to output=opengl, you only have to alter the main dosbox.conf setting to instantaneously alter all corresponding child profiles. Another advantage is that the resulting .conf files are smaller and simpler. 'Multiple Configuration Files'-functionality is available in DOSBox since v0.70 (or CVS since october 2006). An example:

[dosbox]
captures=..\captures\9
memsize=4

[cpu]
cycles=10000

[autoexec]
mount C "."
C:
cd \adv\amazonge\
amazon.exe
exit

...As they say, beauty is in the Eye of the Beholder...

Installation

Just extract to archive to any dir and start dbgl.cmd (Windows), or dbgl.sh (Linux). Mac users can simply drag the DBGL icon into their Applications folder and start it. Do not try to execute the JAR itself, it will not work correctly. Please note that you MUST have the Java Runtime Environment 1.5 (or higher) installed, it will not work without the JRE1.5, or with an older version. Moreover, java.exe should be in your path (or if you're running on Linux, /usr/bin/java should be (a symbolic link) pointing to the 1.5 JVM).

The archive contains DBGL with some pre-configured templates and the latest DOSBox release, so you can get going instantly.

Since the frontend was written in Java, it should be relatively easy to port to another platform. If anybody is interested in another build, I'll try to make one. Anyway, I'm releasing the source code for the entire thingy as well, so please feel free to hack away.

Download

First-time installation Upgrading an existing installation
Download the appropriate archive for your operation system and extract it to a directory of your choice. To check if your Java Runtime Environment is 64-bits, just open a terminal or cmd prompt and run 'java -version'. Just download the JAR and overwrite the single file in this zip archive. It is always a good idea to make backups of your profile information when upgrading; this means the /profiles, /captures, /db and /templates folders.

Update

Extract and overwrite the jar


Note 1: Java version 1.5(or higher) is required to run this application. Using a JVM version below 1.5 will most likely result in a DBGL crash as soon as you try to open the mount dialog box.

Note 2: On DBGL startup, Windows may or may not ask whether or not to allow the program to establish connections to other machines. You can choose 'Block' since DBGL doesn't need to connect to other computers, communication takes place on localhost only. In case you don't want to use the 'Send To' functionality, you can choose to disable it in the Settings dialog window, that will also get rid of the Windows popup.

Note 3: Some users have reported problems starting up DBGL. Please make sure you're using the right package for the right environment, and you have your JAVA_HOME environment setting properly configured.

Attention Linux users: Make sure you have the packages 'libsdl-sound' and 'libsdl-net' installed, because otherwise the included DOSBox build will NOT run.

Legacy builds

Changelog

v0.66 (2009-9-27)

  • Very easy migration to DOSBox 0.73: You can now select multiple profiles (shift, ctrl, ctrl-a) at once and change the associated DOSBox version in one go.
  • MobyGames querying! Thanks to some code from Manuel J. Gallego, DBGL can now contact MobyGames to receive game information by the profile's title. When multiple matches are found, DBGL will display a popup screen in which you may select the correct game. Even when editing multiple games at once, MobyGames consulting can be performed.
    IMPORTANT: An extra library file is required for this functionality. So, for existing DBGL installations, instead of just updating dbgl.jar, you will also require this file to be stored in the dbgl/lib folder.
  • Many updates to the user interface with optional icons and more toolbar buttons. Game screenshots can be shown in a column in the profiles table and default window sizes are adjusted to make sure everything inside is visible on all supported operating systems.
  • Implemented tooltips for all DOSBox settings. Descriptions were more or less taken straight from dosbox.conf (drsassafras).
  • Refactored Windows desktop shortcut creation, effectively fixing this on 64-bit JVMs. JShortcut was dropped in favour of CScript (WindowsXP and up).
  • Many Mac improvements, such as dialog layout fixes and button size corrections. The menu bar now shows the correct application name (drsassafras). Added a Carbon OSX package for OSX 10.4 (Tiger) environments.
  • Added support for other screenshot image filetypes: ".gif", ".jpg", ".tif", ".tiff", ".ico" and ".bmp" are possible (retrofan).
  • Implemented the possibility to run a template.
  • Fixed a major bug where dosbox.conf drive mounts were not correctly being used when running a game's setup (Ronald S.).
  • Worked around incorrect SWT behavior where text fields in the profile editing screen could become very small, depending on the text in other fields (code120).
  • Made profile title sorting case-insensitive (RetroFAN).
  • Added a Russian translation from Oleg and an Italian translation from code120.
  • Automated the build-process; anyone should be able to build DBGL now by just downloading the (somewhat large) src package and running ant. The big advantage for the end-user is that I will be able to provide packages for all the various platforms simultaneously in the future.
  • Updated libraries for all platforms to the latest stable releases (SWT 3.5 and HSQLDB 1.8.1.1).

DBGL on Mac, Linux and Windows

v0.65 (2009-5-27)

  • Full support for DOSBox 0.73! All the new configuration options are available (machine, cputype, oplemu, ioctl, etc.) and DBGL can properly transfer your profile settings from an older DOSBox release to the latest version (and vice versa).
  • German (Stefan) and Danish (MiniMax) translations were added, improvements to the Chinese translation (ClarkH).
  • Multiple improvements to ISO and 7-zip file browsing. What's more, browsing inside an cue/bin-pair is also possible now!
  • Improvements to default dialog layout and size, especially for Linux environments. Dialog sizes are also remembered across sessions (Markus)
  • Screenshot-buttons are displayed with a correct aspect ratio (code120).
  • Moved mixer command after mounts to be able to set cdaudio volume.
  • Right-click on a profile to quickly open the game folder (code120).
  • You may use custom titles for your profile links (red_avatar).
  • Fixed buggy log text screen updates while importing from D-Fend or migrating profiles.

Playing FIFA International Soccer in DOSBox 0.73
Legacy builds

Screenshots


The main dialog showing a list of profiles


Access the contextmenu by right-clicking


Click the Templates tab in the main window to manage them


This shot shows the profile's general information


Set the associated Dosbox version or load a template
with preconfigured settings

More profile settings; the audio section


The mounting tab where one
can select the mount location and game.exe

Editing a template is very similar to editing a profile


Click on a capture to view it enlarged, like this
 

Future work

Contact the author

Hi there, my name is Ronald Blankendaal, you may contact me by mail, or use the information provided at Vogons (rcblanke).

Of course, bug-reports and/or suggestions are very welcome. Please let me know what you think!

License

DBGL is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.


eXTReMe Tracker