Command Line Arguments

boxedwine [options] Program


boxedwine -root c:\root /bin/wine notepad

This will look for a file system in c:\root and run “/bin/wine” in the file system with an argument of notepad

BoxedWine -root c:\root -zip /bin/wine notepad

This will load the file system from and write the changes to c:\root


-bpp : Must be 8, 16 or 32. Useful for some games that require 8-bit or 16-bit color desktop in order to start.

-fullscreen : if no resolution is passed in via the resolution command line argument then the resolution will be the same as the monitor

-mount : Will mount a host directory or zip file, in the emulated file systems. Example: -mount “c:\my games” “/home/username/my games” or -mount “c:\my games\” “/home/username/my games”

-mount_drive : Will mount a host directory in the emulate file system and set up the Wine links so that it shows up as a drive in Wine. Example: -mount_drive “c:\my games” d

-nosound : Disable /dev/dsp which will disable sound

-resolution WxH : Initial emulated screen size. Default is 800×600. This is useful for apps/games that aren’t full screen and won’t change the screen size themselves.

-root path : Path to the file system the emulated linux environment will use

-scale X : X is % of the original. So -scale 100 would be normal.

-scale_quality X : X is 0, 1 or 2. 0 = nearest pixel sampling, 1 = linear filtering, 2 =anisotropic filtering

-w path : Initial working directory, default is /home/username. This needs to reference a path in the emulated file system.

-zip path : This will load the file system from the zip file. Use -root option for the location where new files can be created.

Advanced Arguments:

-uid X : Only useful if you want the emulated environment to report that it is root. In that case set the uid to 0.

-gid X : group id

-euid X : effective user id

-egid X : effective group id

-env var : this will add a environment variable like WINEDEBUG=+seh

-glext: If used, when Wine requests the list of OpenGL extension, it will be limited to this list. This is only useful if the an old OpenGL game, like Unreal, can’t handle the large list of extension a modern video card returns. For Unreal I use:

  • -glext “GL_EXT_multi_draw_arrays GL_ARB_vertex_program GL_ARB_fragment_program GL_ARB_multitexture GL_EXT_secondary_color GL_EXT_texture_lod_bias GL_NV_texture_env_combine4 GL_ATI_texture_env_combine3 GL_EXT_texture_filter_anisotropic GL_ARB_texture_env_combine GL_EXT_texture_env_combine GL_EXT_texture_compression_s3tc GL_ARB_texture_compression GL_EXT_paletted_texture”

-noexecfiles X : X is a colon delimited list of full paths that should not have an exec permission

-p2 : sets the emulated cpu to be a Pentium 2 with MMX

-p3 : sets the emulated cpu to be a Pentium 3 with MMX/SSE (default)

-record X : If Boxedwine was built with BOXEDWINE_RECORDER,  X is the directory where to record an automation session.  While recording F11 will take a full screen shot and holding F11 while dragging the mouse will take a partial screen shot.  This will record all mouse and keyboard actions.

-automation X : If Boxedwine was built with BOXEDWINE_RECORDER,  X is the directory where a previous record session was stored.  It will play back the script in that direction.