BW-DOS: The Free SpartaDOS-Compatible Disk DOS
BW-DOS is a small, free disk-based DOS that uses the SpartaDOS file system and a SpartaDOS-style command line. It was written in the mid-1990s by Jiří Bernášek (BEWESOFT) and, after a long pause, picked up again from 2020 by Holger Janz. Today it's a popular pick for people who want SpartaDOS features (subdirectories, big disks, batch files) without a SpartaDOS X cartridge, and it sits on many modern utility and development disks.
What you'll learn: which BW-DOS version you have and why it matters, what BW-DOS can and can't do, how to work at its prompt, how to auto-run commands with STARTUP.BAT, and how the modern versions organise commands and manual pages.
What you need: any Atari 8-bit with a disk drive or an emulated drive. The 1.x originals want 48K. BW-DOS 1.4 runs in just 16K, with full function at 48K. Current versions are published at github.com/HolgerJanz/BW-DOS.
1. A short version history
In brief:
| Version | Date | Notes |
|---|---|---|
| 1.00 | June 16, 1994 | Original release by BEWESOFT, 48K required |
| 1.10 | July 14, 1994 | Same as 1.00 except the boot message (released with ABBUC) |
| Update #1 | April 1995 | New MENU, RAMDISK, DIRMAST; new MOVE, RTIME8, ARGSRTC commands |
| 1.30 | Dec 17, 1995 | Better directory placement, new BACKUP, COPY, UNERASE, DOSDRIVE, NEWED |
| TC 1.31 | 2020 | Built mainly to support The!Cart (Holger Janz) |
| 1.4 | 2022/2023 | Renamed commands, MAN pages, runs in 16K |
| 1.5 | Nov 6, 2024 | Integrated DOS drive, many internal commands now external, ED editor |
BW-DOS 1.30 was freeware and came on several disks: system disk, manual disk, two update disks and a BW-TAPE cassette system disk. The original manual was written in Czech.
2. What BW-DOS does (and doesn't)
- File system: SpartaDOS File System 2.0, extended to 1,424 entries per directory (SpartaDOS X-compatible). Up to 16 MB per disk, files up to 8 MB.
- Compatibility: highly compatible with SpartaDOS, including the boot process and commands. SpartaDOS's write-lock status for disks is not supported.
- Memory: it doesn't use extended RAM or the RAM under the OS ROM. That's why some programs that broke under SpartaDOS run under BW-DOS. There's also a command processor variant with no internal commands, for a lower MEMLO.
- Drives: five drive numbers (1, 2, 3, 4 and 8). Single, medium, double and double-sided double density, plus custom setups for Percom-block drives. XF551 high speed is supported.
- RAMdisk: up to 1 MB with Axlon or Port B banked memory. The 1.30 update added a driver for the JRC RAMBOX cartridge (32K–4096K).
- Open files: up to 5 at once.
- Other filesystems: the MENU program can also work with Atari DOS 2.0 single and double density and DOS 2.5 disks.
- It can be started from cartridges that load executable files.
3. Working at the prompt
BW-DOS boots to a command prompt like SpartaDOS's. You type a command plus parameters, separated by spaces. Drive specs and wildcards follow SpartaDOS conventions: D2:, *.COM, and > between directory names (e.g. >DOS>FA.COM).
Command names changed in 1.4. If you're following an old magazine article or a 1.30 manual, translate as follows:
| Up to 1.30 | 1.4 and later |
|---|---|
CWD |
CD |
CREDIR |
MD |
DELDIR |
RD |
ERASE |
DEL |
PROTECT / UNPROTECT |
LOCK / UNLOCK (1.5 adds external PROT/UNPROT) |
RENAME |
REN |
A typical session on 1.5 might look like this:
DIR list the current directory
DIR *.BAT *.SYS 1.5 accepts several patterns at once
MD GAMES make a subdirectory
COPY *.COM GAMES> copy files into it
CD GAMES change directory
PWD show where you are (new in 1.5)
MAN COPY read the manual page for COPY
CAR start the inserted cartridge
Other commands: MENU (a menu-driven front end, whose hotkeys 1.5 shows in inverse video), MOVE (reorganise files on a disk; 1.5 moves several at once), SORTDIR, recursive COPY /R, DEL /R and SORTDIR /R (1.5), UNERASE, BACKUP, FORMAT (from 1.5 it can also initialise hard disks), MEM, ED, and DOSDRIVE.
Cartridges: since 1.4, BW-DOS always starts its command processor at boot and doesn't hand control to an inserted cartridge automatically. Type CAR to enter it.
4. STARTUP.BAT and batch files
Batch files are plain ATASCII text files of commands with the extension .BAT. BW-DOS runs STARTUP.BAT automatically at boot, whereas SpartaDOS X and DOS XE use AUTOEXEC.BAT. Holger Janz's Fast Assembler 1.8 disk ships both, so one disk greets users of either DOS. Its STARTUP.BAT holds a single line:
TYPE README.DOC
The ED text editor (integrated in 1.5, based on JBW ED) is handy for writing batch files. In 1.4, a command that returns a DOS error aborts the batch. Fast Assembler's /E switch exists for exactly this reason.
5. The DOS drive and directory (1.5)
BW-DOS 1.5 has an integrated DOS drive, a particular drive where BW-DOS always looks first for commands. By convention, external commands live in a >DOS> directory and manual pages in >MAN> on that drive. To add a tool, copy its BW-DOS executable to >DOS> and its .MAN page to >MAN>. Fast Assembler, for example, installs DOS>FA.COM and MAN>FA.MAN, then you can run FA RAINBOW.ASM RAINBOW.COM from any directory.
Resident drivers like CLOCK.SYS, RAMDISK.SYS, RTIME8.SYS and XFSIO.SYS install and uninstall more robustly in 1.5. RAMDISK.SYS gained RAMBO 256K and Axlon-extension support in 1.4.
6. BW-DOS and Micro-SpartaDOS
BW-DOS 1.00–1.30 were distributed with Micro-SpartaDOS 2.3, BEWESOFT's tiny "game DOS". It makes a SpartaDOS-format disk boot into a file menu. If you build game compilation disks in SpartaDOS format, that's the usual partner.
Troubleshooting
- A command from an old article says "not found": check the rename table in section 3, or whether the command became external in 1.5 and must be in the DOS directory.
- Your cartridge didn't start at boot: expected since 1.4. Type
CAR. - A program wants the RAM under the OS or extended RAM: BW-DOS leaves those alone, so the program can use them. If a DOS feature you expected is missing, it may be a SpartaDOS X-only feature.
- Debugger compatibility: 1.5 restored the DOS 2 vectors
BW_DFMSDHandBW_DINT, so OSS's BUG/65 works again. It had broken in 1.4. - Disk write-protect via SpartaDOS volume flag ignored: not supported in BW-DOS. Use the physical write-protect notch.
Further reading
- BW-DOS sources, releases and manual pages:
github.com/HolgerJanz/BW-DOS. - Fast Assembler 1.8 manual (Holger Janz, 2024): a worked example of developing natively under BW-DOS 1.4+.
- Related guides on this site: SpartaDOS X guide, Choosing a DOS, MyDOS guide.
Credits
- comp.sys.atari.8bit FAQ (Michael Current), section 7.3.3 — BW-DOS entry; 7.3.4 Micro-SpartaDOS; 7.3.5 filenames — Michael Current (comp.sys.atari.8bit FAQ)
- Fast Assembler 1.8 manual and distribution (Holger Janz) — BW-DOS 1.4+ usage — GitHub project authors
- Nir Dary CD collection — BW-DOS 1.30 archive notes and Czech manual — Nir Dary collection
