{"id":20475489,"url":"https://github.com/bemxio/image-render-bootloader","last_synced_at":"2026-05-18T19:02:26.196Z","repository":{"id":169798572,"uuid":"644955249","full_name":"bemxio/image-render-bootloader","owner":"bemxio","description":"A bootsector program for rendering an image in 256-color VGA mode","archived":false,"fork":false,"pushed_at":"2025-07-04T14:20:50.000Z","size":29,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-04T14:53:48.954Z","etag":null,"topics":["assembly","bios","bootloader","dithering","image","nasm","python","rendering"],"latest_commit_sha":null,"homepage":"","language":"Python","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/bemxio.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}},"created_at":"2023-05-24T15:46:22.000Z","updated_at":"2025-07-04T14:39:53.000Z","dependencies_parsed_at":null,"dependency_job_id":"7c677808-2bc5-4e6e-9963-c8ccae8307c6","html_url":"https://github.com/bemxio/image-render-bootloader","commit_stats":null,"previous_names":["bemxio/bios-image-renderer","bemxio/image-render-bootloader"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bemxio/image-render-bootloader","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bemxio%2Fimage-render-bootloader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bemxio%2Fimage-render-bootloader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bemxio%2Fimage-render-bootloader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bemxio%2Fimage-render-bootloader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bemxio","download_url":"https://codeload.github.com/bemxio/image-render-bootloader/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bemxio%2Fimage-render-bootloader/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279012507,"owners_count":26085133,"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-10-12T02:00:06.719Z","response_time":53,"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":["assembly","bios","bootloader","dithering","image","nasm","python","rendering"],"created_at":"2024-11-15T15:16:10.664Z","updated_at":"2025-10-12T18:19:39.885Z","avatar_url":"https://github.com/bemxio.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# image-render-bootloader\nA program running inside the bootsector, designed to render an image in 256-color VGA mode. \n\nUses Floyd-Steinberg dithering to convert a regular RGB image into the data that can be displayed in 256-color VGA mode.\n\n## Usage\nTo build the bootloader in the easiest way, just follow the instructions below.\nYou can do it the manual way with an assembler and GIMP but then, you're on your own.\n\n### Installing dependencies\nFor Windows, you can install [`scoop`](https://scoop.sh/) and use it to install the necessary packages:\n```powershell\nscoop install nasm make python\n```\n\nAs for Linux, all of the packages should be in your default package manager. Here's an example for Debian-based distros:\n```bash\nsudo apt install nasm make python3\n```\n\nAfter that, use `pip` to install [Pillow](https://pypi.org/project/pillow/):\n```bash\npython -m pip install pillow\n```\n\nIf you want to run the bootloader, you need to install QEMU as well, which can be done with either `scoop install qemu` or `sudo apt install qemu`, depending on your OS.\n\n### Building\nBefore building the bootloader, you will need to do a couple of things. \n\n1. Download the image to be displayed, it can be anything you like. Just remember that the color palette is limited to 256 colors, thus some images might not look that good.\n2. Open the [`Makefile`](Makefile) and edit variables according to your configuration. The one you will most likely need to change is `IMAGE_PATH`, which should be set to the path of the image you downloaded in the previous step.\n3. Simply run `make` in the root directory of the project.\n\nThis will build the bootloader in the `build/bootloader.bin` file.\nIf you installed QEMU and want to run the bootloader, you can do so by running `make run` in the root directory of the project.\n\n## License\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbemxio%2Fimage-render-bootloader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbemxio%2Fimage-render-bootloader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbemxio%2Fimage-render-bootloader/lists"}