{"id":23366988,"url":"https://github.com/mattstypa/dos-director","last_synced_at":"2026-02-23T00:35:38.536Z","repository":{"id":261080097,"uuid":"882937643","full_name":"MattStypa/DOS-Director","owner":"MattStypa","description":"DOS Director is a flexible, menu-driven command launcher for simplifying DOS program management in environments like DOSBox.","archived":false,"fork":false,"pushed_at":"2024-11-12T17:41:10.000Z","size":25,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-02-14T00:42:14.718Z","etag":null,"topics":["dos","dosbox","emulation","retrocomputing","retrogaming"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MattStypa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-04T04:35:32.000Z","updated_at":"2024-12-05T02:45:21.000Z","dependencies_parsed_at":"2024-11-04T16:18:48.188Z","dependency_job_id":"778d512c-bfaa-4a05-9d77-b56127b6d8a7","html_url":"https://github.com/MattStypa/DOS-Director","commit_stats":null,"previous_names":["mattstypa/dos-director"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MattStypa%2FDOS-Director","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MattStypa%2FDOS-Director/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MattStypa%2FDOS-Director/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MattStypa%2FDOS-Director/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MattStypa","download_url":"https://codeload.github.com/MattStypa/DOS-Director/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247744328,"owners_count":20988784,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dos","dosbox","emulation","retrocomputing","retrogaming"],"created_at":"2024-12-21T14:35:05.642Z","updated_at":"2025-10-26T10:03:06.119Z","avatar_url":"https://github.com/MattStypa.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# DOS Director 1.1\n\n\u003e [!NOTE]\n\u003e This documentation is for DOS Director 1.1\u003cbr/\u003e\n\u003e For other versions [click here](https://github.com/MattStypa/DOS-Director/releases)\n\nWelcome to **DOS Director**! This project is designed to simplify your experience with DOS environments, making it easy to launch your favorite DOS programs without the hassle.\n\n\u003cimg width=\"1440\" alt=\"DOS Director screenshot\" src=\"https://github.com/user-attachments/assets/cbe5a21c-e43d-498b-ac96-0e9f9fa9ff99\"\u003e\n\n## What is DOS Director?\n**DOS Director** is a menu-driven command runner that allows you to easily configure and launch DOS programs. Originally developed to enhance my own DOSBOX experience, it has evolved into a flexible tool compatible with any DOS setup.\n\n## Features\n- **Easy Configuration**: Quickly create your own menu using a simple config file.\n- **Nested Menus**: Organize your commands into groups and submenus.\n- **Meta Commands**: Define commands to run before and after each selection for setup and cleanup.\n- **Compatibility**: Ideal for DOSBOX but works well in any DOS environment.\n\n## Downloading DOS Director\n[Click here to download DOS Director](https://github.com/MattStypa/DOS-Director/releases)\n\n## Freeware\n**DOS Director** is released as freeware, meaning it is available for use at no cost. Freeware software can be freely distributed and used without any financial obligation, making it accessible to everyone. While you can use DOS Director without charge, it is important to note that it cannot be modified.\n\n## How to Use DOS Director\nTo run **DOS Director**, pass a configuration file as a parameter when starting the program:\n\n```\nDIRECTOR.EXE MENU.CFG\n```\n\nFor convenience, a `start.bat` file is included in the release. \n\nYou can set it up in your `dosbox-x.conf` file as follows:\n\n```\nmount x drives/dos-director\nx:\nstart\n```\n\n## Configuration File Setup\n### Basic Setup\nThe configuration file defines options by wrapping the option name in square brackets. The commands for that option follow on the next lines.\n\nEmpty lines and indentation are ignored, and lines prefixed with `#` are treated as comments and also ignored.\n\n```\n[Doom II]\n  # Use novert to disable vertical mouse movement\n  mount c drives/doom2\n  c:\n  novert\n  capmouse /c\n  doom2\n  capmouse /r\n  novert /u\n```\n\n### Advanced Setup\nFor more complex configurations, you can use special tags and nested menus.\n\n#### Meta Commands\nYou can execute specific commands before and after every selected option using `{before}` and `{after}` tags. This is especially useful for unmounting drives.\n\n```\n{before}\n  mount -u c\n```\n\n#### Nested Menus\nTo create nested menus, wrap them in curly brackets.\n\n```\n[Utilities] {\n  [QuickBASIC 4.5]\n    mount c drives/qb45\n    mount d drives/code\n    c:\n    qb\n\n  [DOS prompt]\n    command\n\n  [Windows 95]\n    config -bootconf drives/win95/dosbox-x.conf\n\n  *[BACK]\n}\n```\n\nNotice the option prefixed with an asterisk `*`. This tells **DOS Director** that this option exits the current menu.\n\n#### Nested Meta Commands\nEach nested menu can have it's own `{before}` and `{after}` tags. All meta tags in the hierarchy will be executed in the top-to-bottm order.\n\n```\n{before}\n  echo Runs first\n\n{after}\n  echo Runs fourth\n\n[Submenu]\n  {before}\n    echo Runs second\n\n  {after}\n    echo Runs fifth\n\n  [Command]\n    echo Runs third\n```\n\n## Feedback and Support\nFor bugs and issues, please [click here](https://github.com/MattStypa/DOS-Director/issues). For questions, ideas, or other discussions, feel free to [click here](https://github.com/MattStypa/DOS-Director/discussions).\n\nThank you for checking out **DOS Director**! I look forward to your feedback and hope you find it useful for your DOS adventures!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattstypa%2Fdos-director","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmattstypa%2Fdos-director","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattstypa%2Fdos-director/lists"}