aDOSBox

This page contains information about our effort to port DOSBox to Android.
Project code is hosted by Google Code: http://code.google.com/p/adosbox/.
Project discussion group is hosted by Google Groups: http://groups.google.com/group/adosbox (deleted by Google)

Updates

  • May 2011: aDOSBox 0.2.5 has been released
  • May 2011: aDOSBox 0.2.4 Beta has been released
  • Apr 2011: aDOSBox 0.2 Beta has been released
  • Feb 2010: aDOSBox 0.1 Alpha has been released

Releases

  • aDOSBox 0.2.5 (released in May 2011)
    Downloads:
    Release Notes:
      Add dynamic settings for some DOSBox parametes. Press "menu" -> "DOSBox" Following features are supported:
    • Cycles can be dynamically changed (increase/decrease)
    • Cycle change step can be dynamically changed
    • Frameskip can be dynamically changed
    • Load DOSBox configuration. (Take effect when you restart aDosBox).
    • Save current DOSBox configuration to a file.
  • aDOSBox 0.2.4 beta (released in May 2011)
    Downloads:
    Release Notes:
    • Supports Android phone with resolution WVGA. Android OS version must be 2.2 and up.
    • Fixed mouse bugs.
    • Changed the way how config dialog is shown.
      In last version, "search" key is used to open config dialog and "menu" key is used to show virtual keyboard.
      In this version, "search" key is not mapped any longer because some handsets don't have it. Instead "menu" key is used. When "menu" key is pressed, an on-screen menu is shown near bottom by which you can
      • Show/hide on-screen keyboard. (You can also do this by tapping top left corner where a semi-transparent button is placed)
      • Open configuration dialog
      • Turn on/off on-screen jobsticks (arrow keys and customized buttons)
      • Quit the program
  • aDOSBox 0.2 beta (released in Apr 2011)
    Downloads:
    Release Notes:
    • Supports Android phone with resolution WVGA. Android OS version must be 2.2 and up.
    • This release is based on DOXBox-0.74
    • Some games (especially Mario, and PackMan) were tested to run successfully.
    • Virtual keyboard support is added.
      By default, on-screen arrow keys and shortcut keys are enabled. There are four on-screen buttons near bottom right corner labelled as 1,2,3 and 4. Default mappings are
      button 1: ENTER
      button 2: SPACE
      button 3: BACKSPACE
      button 4: ESCAPE
      You can change default mappings by following
      "Search button" -> "On-screen keyboard" -> "Remap on-screen controls"
    • Mapping of phone physical buttons
      • Menu: show/hide on-screen keyboard by which you can type text.
      • Search: show/hide system configuration dialog by which you can modify default settings (such as key mapping).
      • Back: corresponds to key ESCAPE in PC keyboard.
      • Volumn Up/Down: change media volumn of aDOSBox.
    • Note: This version is based on Pelya's work. Many thanks to him.
    Demo video clips:
    Known bugs:
    • Some symbols cannot be typed in through virtual keyboard. If you find any, please report it here so we can fix it in future version.
    • If you find any other bug, please file an issue here
    Call for tests:
    Because of limited resources, we cannot test aDOSBox on all Android phones. If you have Android phones and would like to share how aDOSBox runs on your device, feel free to post blog article make video, and send emails to us (click here). In addition, you can post your test results to issue list (Since our group was removed by Google, we don't have any official forum/BBS/group).
    Installation:
    1. Download the apk.
    2. Connect your Android phone to computer
    3. Install the the apk to your phone using command:
      adb install name_of_apk_file
      If you see output message like "[INSTALL_FAILED_ALREADY_EXISTS]", it means the apk has been installed. Use following command to uninstall it:
      adb uninstall org.hystudio.android.dosbox
      or directly use command
      adb install -r name_of_apk_file (-r means reinstall)
  • aDOSBox 0.1 alpha (released in Feb 2010)
    Downloads:
    Release Notes:
    • Supports Android phone with resolution HVGA or WVGA.
    • This release is based on DOXBox-0.73
    • Some games (especially Mario, and PackMan) were tested to run successfully. But the games run really slow.
    • Key mapping is done
      Press "left Alt" + "any key" to type the symbol on the physical key other than the letter. For example, on G1, press "left Alt" and "H" will generate colon. Press "left Alt" twice to lock the key. Press "left Alt" to unlock the key.
      Press "left Shift" and "any key" to type corresponding letter in uppper case. Press "left Shift" twice to lock the key. Press "left Shift" to unlock the key. When "left Shift" is locked and a key is pressed, upper case of the letter is generated.
    • Currently we don't support virtual keyboard. So if your phone does not have a physical keyboard, you cannot use aDOSBox. To support virtual keyboard is our future work.
    Demo video clips:
    Installation:
    1. Download and unzip the tarball.
    2. Connect your Android phone to computer
    3. Install the the apk to your phone using command:
      adb install name_of_apk_file
      If you see output message like "[INSTALL_FAILED_ALREADY_EXISTS]", it means the apk has been installed. Use following command to uninstall it:
      adb uninstall org.hystudio.dosbox
      or directly use command
      adb install -r name_of_apk_file (-r means reinstall)
    4. Copy file dosbox.conf to SD card of your phone using following command:
      adb push dosbox.conf /sdcard/dosbox.conf
      If you don't have a SD card, use following command
      adb push dosbox.conf /data/data/org.hystudio.dosbox/files/dosbox.conf

Feedback & Contribution

If you have any feedbacks or you want to contribute, don't forget to leave us message by clicking here.
Note: to avoid spam, we ask users to log in their google accounts to post feedbacks to our project. Your credential will NOT be leaked to our site, it is still under control of Google Account service.

Last Modified: May 18, 2011 12:48:30 AM