This page was last modified 13:32, 1 December 2021 by Mars2000you. Based on work by Gdx.



It's a tool provided by ASCII Corporation with MSX-DOS 2.



Displays the names, sizes and optional attributes of all the files in a specified directory, including the files in the sub-directories, then the total number of listed files, their corresponding Kb and the number of free kB on the disk

After all files in the specified folder have been listed, then files within descendant folders are also listed, and are shown indented. This allows to obtain the listing of a complete directory tree or disk.


XDIR /H <Device>:\<Path>\


  • Character backslash (\) serves as a separator between the folders and the file name in MSX-DOS2. You don't have to put it after the colon of the device name. Backslash is replaced by the character yen (¥) on Japanese MSX or the character won (₩) on Korean MSX.
  • Character slash (/) serves to declare an option. You can put the option after the command or behind the other parameter.


<Device> is the name for used device. It can only be a disk drive.

If you don't specify the drive, the computer will work with the currently active drive (by default, it's drive A:)

Device type Device name Remark
Disk drive A, B, C, D, E, F, G, H A floppy disk interface can control until 2 drives.

<Path> is used to specify the location in folders of folder that needs to be listed. The last name (the rightmost one) must be the name of the folder to list. Wildcards can replace some characters in folder name to get several folders. The asterisk (*) and question mark (?) are used as wildcard characters. The asterisk matches any sequence of characters, whereas the question mark matches any single character.

/H is used to allow the listing of hidden folders.



Related to

DIR, XDIR (SceneTool)


  • MSX1 and higher
  • MSX-DOS 2 / Nextor