Official Homepage for DBGL: DOSBox Game Launcher
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. |
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
- Make it as stable as a rock
- Game import/export
- Implement filtering based on various criteria
Export profile list
Create a Mac OSX build
- Rename an existing profile configuration file
Add support for dosbox.conf drive mounting
- Write more documentation on DBGL usage for readme.txt
- Add icon selection option for desktop shortcut creation
- Implement long-to-short-filename-translation
Add the possibility to alter multiple profiles at once
- Add an option to use profile titles for captures directories
- Make a suggestion
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.