manpages

dosbox-install(1)

dosbox-install(1) Reference Pages dosbox-install(1)

ИМЯ

dosbox-install - Games installer for DOSBox

СИНОПСИС

/usr/bin/dosbox-install [[-h] | [--help]] [[-V] | [--version]] [--verbose] [--executable EXE-filename] [--project Menu-itemname] [--basedir directory-for-C-drive] [file-or-URL...]

/usr/bin/dosbox-install [[-u] | [--uninstall] | [--remove]] [game-name...]

DESCRIPTION

dosbox-install performs four things:

•downloads given URL using wget or lftpget;

•if downloaded file is has archive suffix, extracts it to directory that is used for storing DOSBox apps;

•lookups executable file in created directory (BAT, COM or EXE);

•adds item to Main Menu of GUI environment for running founded executable by DOSBox.

COMMAND LINE ARGUMENTS

Each command line argument is handled as following:

•when this is a URL in proto://address format, steps 1-4 are performed;

•when this is a filename with ZIP, RAR or ARJ extension, steps 2-4 are performed;

•when this is a directory, steps 3 and 4 are performed;

•when this is a executable with EXE/BAT/COM extension, step 4 is performed.

EXAMPLES

•Download, extract, lookup executable, add icon to Main menu:

dosbox-install http://ilya-evseev.narod.ru/games/tower.zip

•Extract, lookup executable, add icon to Main menu:

dosbox-install /tmp/ugh.zip

•Lookup executable, add icon to Main menu:

dosbox-install /mnt/windows/Games/DefenderOfTheCrown/

•Add icon of executable to Main menu:

dosbox-install /mnt/windows/Games/LR/LR.COM

UNINSTALL

Running with -u switch removes already installed application that's name is given in command line:

•directory from DOSBox apps folder;

•menu item from Main menu folder.

OPTIONS

-h, --help

Display short usage.

-V, --version

Display program version.

--verbose

More detailed output about progress.

--executable EXE-filename

When a program directory contain more than once excutable, by default dosbox-install creates menu link to the first founded. This switch allows you to select main program executable explicitly. If executable is located not in the top program directory, then filename should contain relative path from top directory.

Examples:

dosbox-install --executable SIMFILES/SIM.EXE /mnt/windows/Games/SimCity/ dosbox-install --executable gpega.exe /usr/games/dosgames/GrandPrix

--basedir directory-mounted-as-C

By default drive C: is assigned to directory of selected executable. When executable is located not at program toplevel, but in subdirectory, this switch allows to select toplevel directory.

Example:

dosbox-install --basedir /mnt/windows/Games/SimCity/ SIMFILES/SIM.EXE

--project Menu-itemname

By default, item in Main menu has the same name as application folder. This switch is used for assigning custom name for menu item.

Example:

dosbox-install --project "Accolade GrandPrix Rally" /usr/games/dosgames/gp/gpega.exe

-u name

Removes selected subfolder from main DOS-apps folder, and menu item from Main menu.

Example:

dosbox-install --remove tower ugh para

FILES

/usr/games/dosbox is used as base directory for extracting processed archives.

/usr/lib/menu contain descriptions for menu items used for building Main menu for GUI.

AUTHORS

<evseev@altlinux.ru>, 2003-2004.

SEE ALSO

dosbox(1)

update-menus(1)

07/19/2025 [FIXME: source]