{"id":27291360,"url":"https://github.com/mattieb/windows-iso-to-usb","last_synced_at":"2026-05-20T14:15:36.269Z","repository":{"id":229322281,"uuid":"747942946","full_name":"mattieb/windows-iso-to-usb","owner":"mattieb","description":"converts a Windows ISO to a bootable USB disk","archived":false,"fork":false,"pushed_at":"2024-03-23T14:12:43.000Z","size":451,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-11T21:56:40.264Z","etag":null,"topics":["iso","usb","windows","windows-11"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mattieb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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}},"created_at":"2024-01-25T00:08:50.000Z","updated_at":"2025-02-14T01:40:38.000Z","dependencies_parsed_at":"2024-03-23T15:26:24.007Z","dependency_job_id":null,"html_url":"https://github.com/mattieb/windows-iso-to-usb","commit_stats":null,"previous_names":["mattieb/windows-iso-to-usb"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattieb%2Fwindows-iso-to-usb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattieb%2Fwindows-iso-to-usb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattieb%2Fwindows-iso-to-usb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mattieb%2Fwindows-iso-to-usb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mattieb","download_url":"https://codeload.github.com/mattieb/windows-iso-to-usb/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248487715,"owners_count":21112188,"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":["iso","usb","windows","windows-11"],"created_at":"2025-04-11T21:57:00.135Z","updated_at":"2026-05-20T14:15:36.232Z","avatar_url":"https://github.com/mattieb.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# windows-iso-to-usb\n\nA macOS tool to convert a Windows 11 ISO image to a bootable USB drive.\n\n## Requirements\n\n- The command-line tools from [wimlib](https://wimlib.net) (available in [Homebrew](https://brew.sh))\n\nAll remaining requirements are already included in macOS. Patches are welcome for portability.\n\n## Usage\n\n```\nwindows-iso-to-usb ISO_FILE DISK\n```\n\nWrites the content the ISO image in ISO_FILE to the USB disk at DISK.\n\nDISK must be the device name (e.g. \"/dev/disk6\" or just \"disk6\"). You can find it with the \"diskutil\" command:\n\n```\ndiskutil list\n```\n\nOr with Disk Utility, with \"View\" → \"Show All Devices\" set:\n\n![The macOS Disk Utility app, with a USB disk selected, and the text \"disk6\" highlighted in the \"Device\" information field.](doc/disk-utility.png)\n\nwindows-iso-to-usb will show you information about the disk before erasing it, to confirm it is the disk you want to use.\n\n## How it works\n\n[windows-iso-to-usb](./windows-iso-to-usb) tries to mimic the output of the [Windows Media Creation Tool](https://www.microsoft.com/en-us/windows/learning-center/windows-media-creation-tool) as closely as possible. Specifically, it uses an MBR partition table and a single FAT32 volume which it names \"ESD-USB\".\n\nFAT32 has a limitation of 4 GB files, so one extra step is needed: splitting a large install.wim file into files that will fit. Here, we mimic the steps taken [in Microsoft's Flash Drive installer documentation](https://learn.microsoft.com/en-us/windows-hardware/manufacture/desktop/install-windows-from-a-usb-flash-drive?view=windows-11#if-your-windows-image-is-larger-than-4gb) and split the image into chunks of 3800 MB.\n\nSome ISO images (such as the ones created by [windows-esd-to-iso](https://github.com/mattieb/windows-esd-to-iso)) don't have install.wim, but have install.esd instead. If this is present, it convert it to an install.wim file before splitting.\n\n## Caveats\n\n- While this tool will likely operate on ARM ISOs, I have not tested the produced USB images.\n\n- The \"install\" images are compressed with LZX compression, instead of LZMS compression like the images produced by the Windows Media Creation Tool. This does not materially affect the produced installer, and is [due to wimlib design](https://wimlib.net/forums/viewtopic.php?t=702). I do not consider this an issue.\n\n## Licensing\n\nWhile this tool itself is [already licensed to you](./LICENSE.md), Windows itself may require licensing and activation.\n\nYou must address this; this tool does not.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattieb%2Fwindows-iso-to-usb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmattieb%2Fwindows-iso-to-usb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmattieb%2Fwindows-iso-to-usb/lists"}