{"id":14139308,"url":"https://github.com/Maccraft123/Cadmium","last_synced_at":"2025-08-05T04:31:22.352Z","repository":{"id":37810933,"uuid":"310400975","full_name":"Maccraft123/Cadmium","owner":"Maccraft123","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-19T20:19:57.000Z","size":112522,"stargazers_count":341,"open_issues_count":34,"forks_count":66,"subscribers_count":17,"default_branch":"master","last_synced_at":"2025-06-19T21:26:25.793Z","etag":null,"topics":["cadmium","chromebook","chromebooks","chromeos","debian","duet","kernel","kevin","linux","mt8183"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Maccraft123.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","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},"funding":{"patreon":"macc24"}},"created_at":"2020-11-05T19:44:08.000Z","updated_at":"2025-06-19T20:20:00.000Z","dependencies_parsed_at":"2023-02-17T21:30:35.528Z","dependency_job_id":"e17340c4-fd0c-43eb-8093-bbe6526a0e6a","html_url":"https://github.com/Maccraft123/Cadmium","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/Maccraft123/Cadmium","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maccraft123%2FCadmium","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maccraft123%2FCadmium/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maccraft123%2FCadmium/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maccraft123%2FCadmium/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Maccraft123","download_url":"https://codeload.github.com/Maccraft123/Cadmium/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maccraft123%2FCadmium/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268836001,"owners_count":24314950,"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","status":"online","status_checked_at":"2025-08-05T02:00:12.334Z","response_time":2576,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["cadmium","chromebook","chromebooks","chromeos","debian","duet","kernel","kevin","linux","mt8183"],"created_at":"2024-08-16T17:00:58.560Z","updated_at":"2025-08-05T04:31:21.567Z","avatar_url":"https://github.com/Maccraft123.png","language":"Shell","funding_links":["https://patreon.com/macc24"],"categories":["Shell"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"/pics/logo/cd_smol.png\" alt=\"Logo\" data-canonical-src=\"/pics/cd_smol.png\"/\u003e\u003c/p\u003e\n\nThanks @LoganMD for the logo\n\n# Cadmium, A Linux ~~distro~~ installer for some RISC laptops\n\n## Hardware support:\n- (FW) entries are meant to indicate that firmware(that is included in Cadmium) is needed for piece of hardware to work correctly.\n- \"Y\" means \"Is known to work as of last time it was tested\"\n- \"N\" means \"Is known to not work as of last time it was tested\"\n- \"?\" means \"Not tested/Unknown\"\n- \"P\" means \"Partial/Incomplete support, refer to notes\"\n- \"N/A\" means \"Missing hardware\"\n\n| Feature      | RK3288 | MT8173 | MT8183 | SC7180 | X1 Elite |\n| ------------ | ------ | ------ | ------ | ------ | -------- |\n| Display      | Y      | Y      | Y      | Y      | Y        |\n| OpenGL       | Y      | N      | 3.1    | 4.6    | 4.6      |\n| Vulkan       | N      | N      | N      | Y      | Y        |\n| Video decode | ?      | ?      | ?      | Y      | N        |\n| USB Host     | Y      | Y      | Y      | Y      | Y        |\n| USB Device   | N      | N      | N      | N      | ?        |\n| KVM          | Y      | Y      | Y      | Y      | N        |\n| CPUFreq      | Y      | Y      | Y      | Y      | Y        |\n\n| Commercial name          | Codename       |  SOC     | Pen input | Internal Installation  | WiFi | Bluetooth | Audio | Suspend/Resume | Notes                             |\n| ------------------------ | -------------- | -------- | --------- | ---------------------- | ---- | --------- | ----- | -------------- | --------------------------------- |\n| Asus Chromebook C100PA   | veyron-minnie  | RK3288   | N/A       | ?                      | ?    | ?         | ?     | Y              |                                   |\n| Samsung Chromebook Plus  | gru-kevin      | RK3399   | ?         | ?                      | ?    | ?         | ?     | Y              | Libreboot available               |\n| Lenovo Chromebook S330   | elm-hana       | MT8173   | N/A       | ?                      | ?    | ?         | ?     | Y              |                                   |\n| Lenovo Chromebook Duet   | kukui-krane    | MT8183   | ?         | Y                      | Y    | ?         | Y     | Y              |                                   |\n| Acer Chromebook Spin 513 | trogdor-lazor  | SC7180   | ?         | Y                      | Y    | ?         | Y     | Y              | Manual audio switching required   |\n| Lenovo Yoga Slim 7x      | N/A            | X1 Elite | N/A?      | Dual-boot with Windows | Y    | Y         | N     | Only manual    | EFI booting                       |\n\n## Official discord server is at https://discord.gg/ZZbwyvKCmV\n\n## Installation\n- Make sure that you have developer mode unlocked\n- Enable booting from usb, by running ```enable_dev_usb_boot``` in ChromeOS root shell accessible when you log in as root after pressing ctrl + alt + refresh.\n- Reboot\nOnce you have this out, continue with instructions:\n\n- *Edit ./config to reflect your laptop*\n- ``` ./build-all /dev/sdX ``` On a Linux machine(ChromeOS doesn't count(except in linux chroot)). For Debian rootfs, binfmt and debootstrap are needed to work correctly.\n- When ```build-all``` is ran like ```./build-all \u003cfile\u003e \u003csize\u003e```, it builds Cadmium to \u003cfile\u003e with size of \u003csize\u003e(8G should be fine)\n- Enable developer mode\n- Plug pendrive into your laptop.\n- Boot from USB\n- After running ``` ./install``` after connecting to internet, Cadmium will be installed on internal emmc memory\n- To update kernel on eMMC memory run: ```./install-kernel``` from pendrive\n\n### OR\n- Enable developer mode(instructions are in the wiki for krane)\n- Download and uncompress ```cadmium-\u003cdevice\u003e.tar.gz``` to your pendrive\n- Boot from USB\n- Run ```./install```\n\n#### *Binary drivers are unsupported in Cadmium and never will be*\n\n## Dependencies on build machine, Debian is recommended\n- Recent Linux distribution\n- A working LLVM toolchain\n- Build dependencies for kernel compilation\n- ```debootstrap``` when Debian rootfs is used\n- ```qemu-user-static``` when build machine can't run binaries for the target machine, with binfmt support\n- For Chromebook machines running stock boot firmware: ```vboot-utils u-boot-tools``` (vbutil_kernel or futility, cgpt and mkimage)\n- For EFI machines: ```ukify```, usually provided in ```systemd-boot``` or related package\n- ```bc``` to calculate number of threads to be used for compilation\n- ```curl``` to download the kernel\n- ```bsdtar``` for writing the archive file (from the ```libarchive-tools``` .deb package)\n- ```f2fs-tools``` for creating the filesystem used by Cadmium\n- ```parted``` to prepare gpt table to be modified by cgpt\n- ```rsync```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMaccraft123%2FCadmium","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMaccraft123%2FCadmium","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMaccraft123%2FCadmium/lists"}