{"id":49735671,"url":"https://github.com/commander-z3r0/mobian-recipes","last_synced_at":"2026-05-09T08:09:29.474Z","repository":{"id":308262883,"uuid":"977638756","full_name":"commander-Z3R0/mobian-recipes","owner":"commander-Z3R0","description":"debos recipes for generating Mobian images (Fork from https://salsa.debian.org) with the aim of facilitating the fork on GitHub of Mobian","archived":false,"fork":false,"pushed_at":"2025-11-23T00:54:23.000Z","size":319,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-11-23T02:28:38.194Z","etag":null,"topics":["debian-linux","linux","linux-mobile","mobian","mobile","phosh"],"latest_commit_sha":null,"homepage":"https://salsa.debian.org/Mobian-team/mobian-recipes","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/commander-Z3R0.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-05-04T16:54:34.000Z","updated_at":"2025-11-23T00:54:27.000Z","dependencies_parsed_at":"2025-08-05T02:35:50.242Z","dependency_job_id":"397a028e-309a-448d-a9d4-d1eb640a1a71","html_url":"https://github.com/commander-Z3R0/mobian-recipes","commit_stats":null,"previous_names":["commander-z3r0/mobian-recipes"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/commander-Z3R0/mobian-recipes","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commander-Z3R0%2Fmobian-recipes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commander-Z3R0%2Fmobian-recipes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commander-Z3R0%2Fmobian-recipes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commander-Z3R0%2Fmobian-recipes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/commander-Z3R0","download_url":"https://codeload.github.com/commander-Z3R0/mobian-recipes/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commander-Z3R0%2Fmobian-recipes/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32811671,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T08:22:46.396Z","status":"online","status_checked_at":"2026-05-09T02:00:06.633Z","response_time":123,"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":["debian-linux","linux","linux-mobile","mobian","mobile","phosh"],"created_at":"2026-05-09T08:09:24.335Z","updated_at":"2026-05-09T08:09:29.468Z","avatar_url":"https://github.com/commander-Z3R0.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mobian-recipes\n\nA set of [debos](https://github.com/go-debos/debos) recipes for building a\ndebian-based image for mobile phones, initially targetting Pine64's PinePhone.\n\nPrebuilt images are available [here](http://images.mobian.org/).\n\nThe default user is `mobian` with password `1234`.\n\n## Build\n\nTo build the image, you need to have `debos` and `bmaptool`. On a Debian-based\nsystem, install these dependencies by typing the following command in a terminal:\n\n```\nsudo apt install debos bmap-tools xz-utils\n```\n\nIf you want to build an image for a Qualcomm-based device, additional packages\nare required, which you can install with the following command:\n\n```\nsudo apt install android-sdk-libsparse-utils yq mkbootimg\n```\n\nBuilding with disk encryption support will also require the package `cryptsetup` to be installed\non your host.\n\nSimilarly, if you want to use F2FS for the root filesystem (which isn't such a\ngood idea, as it has been known to cause corruption in the past), you'll need to\ninstall `f2fs-tools` as well.\n\nThe build system will cache and re-use it's output files. To create a fresh build\nremove `*.tar.gz`, `*.sqfs` and `*.img` before starting the build.\n\nIf your system isn't debian-based (or if you choose to install `debos` without\nusing `apt`, which is a terrible idea), please make sure you also install the\nfollowing required packages:\n- `debootstrap`\n- `qemu-system-x86`\n- `qemu-user-static`\n- `binfmt-support`\n- `squashfs-tools-ng` (only required for generating installer images)\n\nThen simply browse to the `mobian-recipes` folder and execute `./build.sh`.\n\nYou can use `./build.sh -d` to use the docker version of `debos`.\n\n### Building QEMU image\n\nYou can build a QEMU x86_64 image by adding the `-t amd64` flag to `build.sh`\n\n### Running QEMU image\n\n#### From commandline\n\nThe resulting files are raw images. You can start qemu like so:\n\n```\nqemu-system-x86_64 -drive format=raw,file=\u003cimagefile.img\u003e -enable-kvm \\\n    -cpu host -vga virtio -m 2048 -smp cores=4 \\\n    -drive if=pflash,format=raw,readonly=on,file=/usr/share/OVMF/OVMF_CODE_4M.fd\n```\n\nUEFI firmware files are available in Debian thanks to the\n[OVMF](https://packages.debian.org/sid/all/ovmf/filelist) package.\nComprehensive explanation about firmware files can be found at\n[OVMF project's repository](https://github.com/tianocore/edk2/tree/master/OvmfPkg).\n\n\nIt can be useful to be able to SSH into the QEMU image, in order to collect\nlogs directly from the host system. This can be done lanching qemu like this:\n\n```\nqemu-system-x86_64 -drive format=raw,file=\u003cimagefile.img\u003e -enable-kvm \\\n    -cpu host -vga virtio -m 2048 -smp cores=4 \\\n    -drive if=pflash,format=raw,readonly=on,file=/usr/share/OVMF/OVMF_CODE_4M.fd \\\n    -nic user,hostfwd=tcp::8888-:22\n```\n\nthat forwards port 8888 on the host to port 22 on the guest system. Then, connection\nfrom the host system to the guest is as simple as\n\n```\n$ ssh mobian@localhost -p 8888\n$ sftp -P 8888 mobian@localhost\n```\n\n#### Using virt-manager\n\nYou may want to run the image under [virt-manager](https://packages.debian.org/stable/virt-manager)\nfor easier access to USB redirection and keyboard controls. \n\nTo create a VM for mobian image on x86_64, launch virt-manager, click `New VM` -\u003e \n`Import existing disk image` -\u003e select the raw image and OS version then progress to the \n`Ready to begin installation` page, check `customize configuration before install` then click finish.\n\nUnder `Hypervisor Details`, change firmware to `UEFI x86_64: /usr/share/OVMF/OVMF_CODE_4M.fd` then `apply` and `begin installation`, \nthe image should now boot up.\n\n\n#### Convert and resize disk image\n\nYou may also want to convert the raw image to [qcow2](https://www.qemu.org/docs/master/system/images.html#disk-image-file-formats) format\nand resize it like this:\n\n```\nqemu-img convert -f raw -O qcow2 \u003craw_image.img\u003e \u003cqcow_image.qcow2\u003e\nqemu-img resize -f qcow2 \u003cqcow_image.qcow2\u003e +20G\n```\n\n## Install\n\nInsert a MicroSD card into your computer, and type the following command:\n\n```\nsudo bmaptool copy \u003cimage\u003e /dev/\u003csdcard\u003e\n```\n\nor:\n\n```\nsudo dd if=\u003cimage\u003e of=/dev/\u003csdcard\u003e bs=1M\n```\n\n*Note: Make sure to use your actual SD card device, such as `mmcblk0` instead of\n`\u003csdcard\u003e`.*\n\n**CAUTION: This will format the SD card and erase all its contents!!!**\n\n## Contributing\n\nIf you want to help with this project, please have a look at the\n[roadmap](https://wiki.debian.org/Teams/Mobian/Roadmap) and\n[open issues](https://salsa.debian.org/Mobian-team/mobian-recipes/-/issues).\n\nIn case you need more information, feel free to get in touch with the developers\non [#mobian:matrix.org](https://matrix.to/#/#mobian:matrix.org).\n\n# License\n\nThis software is licensed under the terms of the GNU General Public License,\nversion 3.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcommander-z3r0%2Fmobian-recipes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcommander-z3r0%2Fmobian-recipes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcommander-z3r0%2Fmobian-recipes/lists"}