{"id":13474492,"url":"https://github.com/FydeOS/chromium_os-vm-vmware","last_synced_at":"2025-03-26T21:31:38.432Z","repository":{"id":79144836,"uuid":"200825866","full_name":"FydeOS/chromium_os-vm-vmware","owner":"FydeOS","description":"Build and run your Chromium OS on VMWare virtual machine client","archived":true,"fork":false,"pushed_at":"2024-06-26T11:24:00.000Z","size":704,"stargazers_count":221,"open_issues_count":11,"forks_count":32,"subscribers_count":14,"default_branch":"main","last_synced_at":"2024-10-30T07:48:01.689Z","etag":null,"topics":["chromeos","chromium-os","cros-sdk","gentoo","overlay","vmware","vmware-virtual-machine"],"latest_commit_sha":null,"homepage":"https://chromiumos.io","language":"Shell","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/FydeOS.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":"2019-08-06T10:03:23.000Z","updated_at":"2024-09-27T21:01:16.000Z","dependencies_parsed_at":"2024-10-30T05:32:11.252Z","dependency_job_id":null,"html_url":"https://github.com/FydeOS/chromium_os-vm-vmware","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FydeOS%2Fchromium_os-vm-vmware","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FydeOS%2Fchromium_os-vm-vmware/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FydeOS%2Fchromium_os-vm-vmware/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FydeOS%2Fchromium_os-vm-vmware/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FydeOS","download_url":"https://codeload.github.com/FydeOS/chromium_os-vm-vmware/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245738687,"owners_count":20664327,"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":["chromeos","chromium-os","cros-sdk","gentoo","overlay","vmware","vmware-virtual-machine"],"created_at":"2024-07-31T16:01:12.742Z","updated_at":"2025-03-26T21:31:37.788Z","avatar_url":"https://github.com/FydeOS.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"### Public archive\n\nThis project will no longer be maintained and will be turned into public archive as of 2024. Development of Chromium OS for VMware will continue on openFyde: https://github.com/openFyde/overlay-amd64-openfyde_vmware\n\n\u003cbr\u003e\u003cbr\u003e\n\u003chr\u003e\n\u003cbr\u003e\u003cbe\u003e\n\n# Chromium OS VM for VMWare\n\n## TL:DR;\nIf you aren't bothered with the detailed technicality and are only after the pre-built \"click-to-play\" image, check out the [release](https://github.com/FydeOS/overlay-variant-amd64-generic-vmware/releases) tab.\n\n\n## What's this repository\nThis repository contains necessary files that work with the [Chromium OS SDK](https://www.chromium.org/chromium-os/build) (cros_sdk) to build Chromium OS image that works with VMWare virtual machine client. \n\n\n## Why do I need this\nVMWare virtual machine clients work on more OS platforms than kvm-qemu, which is the \"official VM support for Chromium OS\" shipped with cros-sdk. If you are interested in working / testing / tinkering Chromium OS on your favourite OS platform that does not support kvm-qemu natively, this may help. Otherwise, you don't need this.\n\n\n## How do I build Chromium OS VM for VMWare using this repository\n\nThe following is a quick overview guide to get you started. This guide assumes you are comfortable with operations under Linux shell environment and have basic familiarity with the [bible](https://chromium.googlesource.com/chromiumos/docs/+/master/developer_guide.md). \n\n### 0. Read the [bible](https://chromium.googlesource.com/chromiumos/docs/+/master/developer_guide.md), if you have not yet done so.\nIt's best if could give the entire process a go and check if you could produce a working Chromium OS image.\n\n### 1. Sync the repo from the correct branch\nThis overlay was only tested under [release-R75-12105.B](https://chromium.googlesource.com/chromiumos/platform/crosutils/+/refs/heads/release-R75-12105.B) branch of the Chromium OS manifest, per [Get the source code](https://chromium.googlesource.com/chromiumos/docs/+/master/developer_guide.md#get-the-source-code) in the bible, you would need to do the following to get the code:\n\n```\n(outside)\ncd ${HOME}/chromiumos\nrepo init -u https://chromium.googlesource.com/chromiumos/manifest.git --repo-url https://chromium.googlesource.com/external/repo.git -b release-R75-12105.B\nrepo sync -j4\n```\n\n### 2. Clone this overlay and make it known to cros_sdk\n - At this point, you should be in your chroot. \n - Clone this repository to `~/trunk/src/overlays` under your cros_sdk chroot.\n   - Or you can clone to somewhere else and symlink to `~/trunk/src/overlays` for better management\n   - This requires a `.local_mounts` file in your `~/trunk/src/scripts` per [here](https://www.chromium.org/chromium-os/tips-and-tricks-for-chromium-os-developers#TOC-How-to-share-files-for-inside-and-outside-chroot).\n - Edit `~/trunk/src/third_party/chromiumos-overlay/eclass/cros-board.eclass` and add `amd64-generic_vmware` to the list. Pay attention to the dash and underscore in the board name, try not to mis-spell.\n\n### 3. Setup board, prepare the host environment and start building\n - Per the bible, now you can do:\n   ```\n   (inside) export BOARD=amd64-generic_vmware\n   (inside) setup_board --board=${BOARD}\n   (inside) ./build_packages --board=${BOARD} --nousepkg\n   (inside) ./build_image --board=${BOARD} --noenable_rootfs_verification test\n   ```\n - Note that the `--nousepkg` flag is required to combat `./build_packages` being lazy to pull pre-built binaries and cause build error.\n\n### 4. Convert the Chromium OS image to VMDK\nAssuming the build went well and now you have the `chromiumos_test_image.bin` file. There is this `convert_to_vmware.sh` script in this repository that does the conversion for you. Execute the script to see help.\n\n### 5. Additional notes on using the VMDK file to create VMWare virtual machine\n - We have only tested VMWare Workstation 15 \u0026 Fusion 11, lower versions of VMWare clients may not work.\n - You need to create a \"Custom VM\" and choose \"Other Linux kernel 4.x (64 bits)\", choose the VMDK file you've just built when prompted.\n - In the Settings of this VM, under \"Hard drive\" you need to convert bus type from SCSI to either NVMe or SSD.\n - In the Settings of this VM, under \"Display\", you need to turn on 3D acceleration and ideally allocate 768MB shared memory.\n \n\n## Additional notes and help\n - This Chromium OS VM is only meant for development purposes.\n - To get help, please report any issue in this repo or join our [telegram group](https://t.me/hi_fydeos).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFydeOS%2Fchromium_os-vm-vmware","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FFydeOS%2Fchromium_os-vm-vmware","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFydeOS%2Fchromium_os-vm-vmware/lists"}