{"id":21749041,"url":"https://github.com/adamperkowski/highlightos","last_synced_at":"2025-08-21T07:32:16.693Z","repository":{"id":220042129,"uuid":"750612096","full_name":"adamperkowski/highlightos","owner":"adamperkowski","description":"🌄 x86_64 OS (kernel) made from scratch in Rust \u0026 Assembly","archived":false,"fork":false,"pushed_at":"2025-08-04T12:39:53.000Z","size":6186,"stargazers_count":67,"open_issues_count":5,"forks_count":4,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-08-19T03:50:00.374Z","etag":null,"topics":["assembly","bios","bootloader","kernel","nasm","os","rust"],"latest_commit_sha":null,"homepage":"https://os.adamperkowski.dev","language":"Rust","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/adamperkowski.png","metadata":{"files":{"readme":"README-it.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"adamperkowski","custom":"https://adamperkowski.dev/donate"}},"created_at":"2024-01-31T00:58:43.000Z","updated_at":"2025-08-08T19:27:57.000Z","dependencies_parsed_at":"2024-05-31T13:28:59.573Z","dependency_job_id":"21a9a96b-b7b2-4b87-8f4b-b879ceba8293","html_url":"https://github.com/adamperkowski/highlightos","commit_stats":{"total_commits":234,"total_committers":5,"mean_commits":46.8,"dds":"0.047008547008547064","last_synced_commit":"e54d1c10d6a9071189553ef3c1c7acf4b850d778"},"previous_names":["adamperkowski/highlightos"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/adamperkowski/highlightos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamperkowski%2Fhighlightos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamperkowski%2Fhighlightos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamperkowski%2Fhighlightos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamperkowski%2Fhighlightos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adamperkowski","download_url":"https://codeload.github.com/adamperkowski/highlightos/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamperkowski%2Fhighlightos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271444229,"owners_count":24760748,"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-21T02:00:08.990Z","response_time":74,"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","kernel","nasm","os","rust"],"created_at":"2024-11-26T08:16:12.007Z","updated_at":"2025-08-21T07:32:16.688Z","avatar_url":"https://github.com/adamperkowski.png","language":"Rust","funding_links":["https://github.com/sponsors/adamperkowski","https://adamperkowski.dev/donate"],"categories":["Applications","Recently Updated"],"sub_categories":["Operating systems","[Who Wants to Be a Millionare](https://www.boardgamecapital.com/who-wants-to-be-a-millionaire-rules.htm)"],"readme":"# HighlightOS\n\n\u003c!-- logo instead of name --\u003e\n\nUn sistema operativo x86_64 (kernel) realizzato in Assembly e Rust.\n\n[![README in English](https://img.shields.io/badge/EN-%F0%9F%87%AC%F0%9F%87%A7-blue?color=%23ffb454\u0026labelColor=%230a0c0c)](https://github.com/adamperkowski/highlightos/blob/main/README.md)\n[![README in Polish](https://img.shields.io/badge/PL-%F0%9F%87%B5%F0%9F%87%B1-blue?color=%23ffb454\u0026labelColor=%230a0c0c)](https://github.com/adamperkowski/highlightos/blob/main/README-pl.md)\n[![README in Italian](https://img.shields.io/badge/IT-%F0%9F%87%AE%F0%9F%87%B9-blue?color=%23ffb454\u0026labelColor=%230a0c0c)](https://github.com/adamperkowski/highlightos/blob/main/README-it.md)\n[![Documentation](https://img.shields.io/badge/Documentation-%F0%9F%8C%84-blue?color=%23ffb454\u0026labelColor=%230a0c0c)](https://os.adamperkowski.dev)\n\n[![GitHub Release](https://img.shields.io/github/v/release/adamperkowski/highlightos?label=Latest%20Released%20Version\u0026color=%23ffb454\u0026labelColor=%230a0c0c)](https://github.com/adamperkowski/highlightos/releases)\n[![GitHub License](https://img.shields.io/github/license/adamperkowski/highlightos?label=License\u0026color=%23ffb454\u0026labelColor=%230a0c0c)](https://github.com/adamperkowski/highlightos/blob/main/LICENSE) ![GitHub repo size](https://img.shields.io/github/repo-size/adamperkowski/highlightos?label=Repo%20Size\u0026color=%23ffb454\u0026labelColor=%230a0c0c)\n[![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/adamperkowski/highlightos/asm.yml?branch=main\u0026label=ASM%20Build\u0026color=%23ffb454\u0026labelColor=%230a0c0c)](https://github.com/adamperkowski/highlightos/actions) [![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/adamperkowski/highlightos/rust.yml?branch=main\u0026label=HLKernel%20Build\u0026color=%23ffb454\u0026labelColor=%230a0c0c)](https://github.com/adamperkowski/highlightos/actions)\n\n## Table of contents\n- [Compilare da sorgente su Mac/Linux](#compilare-da-sorgente-su-maclinux)\n- [Eseguire in QEMU su Mac/Linux](#eseguire-in-qemu-su-maclinux)\n- [Eseguire su hardware fisico](#eseguire-su-hardware-fisico)\n- [Appendice](#appendice)\n  - [Stato dello sviluppo](#stato-dello-sviluppo)\n  - [Altre info](#altre-info)\n  - [Crediti](#crediti)\n\n\u003c!-- showcase --\u003e\n\u003c!-- features --\u003e\n\u003c!-- List of commands and features will be available soon. --\u003e\n\n\u003c!-- installation \u0026 docs --\u003e\n## Compilare da sorgente su Mac/Linux\n### Kernel Principale\n**Requisiti:**\n - [Git](https://git-scm.com) (controllo versione)\n - [Toolchain Rust](https://www.rust-lang.org/tools/install)\n\n**Step:**\n 1. Assicurati che `rustup` sia installato:\n```bash\nrustup --version\n```\n 2. Crea un clone locale di questa repository:\n```bash\ngit clone git@github.com:adamperkowski/highlightos.git \u0026\u0026 cd highlightos\n```\n 3. `cd` dentro la cartella `kernel/`:\n```bash\ncd kernel\n```\n 4. Compila il file binario avviabile:\n```bash\ncargo bootimage --release\n```\n\u003e Questo comando creerà la sottocartella `target/target/release` in cui verrà creato il file binario `bootimage-hlkernel.bin`.\n\n### HighlightOS ASM\n**Requisiti:**\n - [Git](https://git-scm.com)\n - [NASM](https://nasm.us) compilatore Assembly\n\n**Step:**\n 1. Crea un clone locale di questa repository:\n```bash\ngit clone git@github.com:adamperkowski/highlightos.git \u0026\u0026 cd highlightos\n```\n 2. `cd` nella cartella `asm/`:\n```bash\ncd asm\n```\n 3. Compila il file binario avviabile:\n```bash\nnasm -f bin boot.asm -o boot.bin\n```\n\u003e Questo comando creerà il file binario `boot.bin` nella directory corrente.\n\n## Eseguire in QEMU su Mac/Linux\n\n**Requisiti:**\n - [QEMU](https://www.qemu.org/download/#linux) (pacchetto intero)\n - Un file binario avviabile di HighlightOS che puoi prendere da [releases](https://github.com/adamperkowski/highlightos/releases) o [compilarlo per conto tuo](#compilare-da-sorgente-su-maclinux).\n\n**Step:**\n 1. `cd` nella cartella che contiene il file binario.\n 2. Esegui questo comando:\n```bash\nqemu-system-x86_64 -drive format=raw,file=\u003cyour_binary_filename\u003e.bin\n```\n\u003e [!IMPORTANT]\n\u003e Sostituisci `\u003cyour_binary_filename\u003e` con il nome del file binario che hai scaricato/compilato.\n\n## Eseguire su hardware fisico\nPuoi anche flashare il file binario su una chiavetta USB e avviarlo da un computer fisico. \n\nFlasha il binario con questo comando:\n```bash\ndd if=\u003cyour_binary_filename\u003e.bin of=/dev/sdX \u0026\u0026 sync\n```\n\n\u003e [!IMPORTANT]\n\u003e Assicurati di sostituire `\u003cyour_binary_filename\u003e.bin` con il nome del file binario e sostituisci `/dev/sdX` con la partizione della tua chiavetta USB. **Tutti i dati che contiene saranno cancellati!**\n\n\u003e [!NOTE]\n\u003e Puoi scegliere il dispositivo da cui avviare il computer mediante il boot menu del BIOS (accessibile premendo \u003ckbd\u003eF8\u003c/kbd\u003e or \u003ckbd\u003eF12\u003c/kbd\u003e).\n\u003e\n\u003e**\u003cins\u003eControlla che la tua scheda madre supporti il boot da media legacy\u003c/ins\u003e, dato che HighlightOS non è (ancora) compatibile con UEFI.**\n\n\u003c!-- contributing --\u003e\n## Appendice\n\n[![Documentation](https://img.shields.io/badge/Documentation-%F0%9F%8C%84-blue?color=%23ffb454\u0026labelColor=%230a0c0c)](https://os.adamperkowski.dev)\n\n### Stato dello sviluppo\nhttps://github.com/user-attachments/assets/663e8477-4275-411b-a39a-c12e54096ad8\n\n### Altre info\n**Sai che abbiamo un canale IRC? È `#highlightos` su [libera.chat](https://libera.chat).**\n\n[Qui](https://github.com/adamperkowski/highlightos/wiki/Commands#built-in-commands) puoi trovare una lista di tutti i comandi disponibili.\u003cbr\u003e\nPer scoprire di più, ti invitiamo a consultare la [wiki](https://github.com/adamperkowski/highlightos/wiki/).\n\n**_È altamente sconsigliato l'uso di file binari precompilati provenienti dalla sezione \"codice\" di questa repo._**\n\n### Contributori\n**Un grazie speciale a tutti coloro che hanno scelto di contribuire al progetto:**\n\n\u003ca href=\"https://github.com/adamperkowski/highlightos/graphs/contributors\"\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/adamperkowski/highlightos/gh-pages/CONTRIBUTORS.svg\"/\u003e\n\u003c/a\u003e\n\n### Crediti\n*Alcune parti del codice sono ispirate da [blog_os](https://github.com/phil-opp/blog_os). Progetto fighissimo!*\n\n*Traduzione in italiano a cura di/Italian translation by: [\u003efranzageek\u003c](https://github.com/franzageek)*\u003cbr\u003e\n\n### Copyright\n[Copyright \u0026copy; 2025 Adam Perkowski](/README.md#copyright)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadamperkowski%2Fhighlightos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadamperkowski%2Fhighlightos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadamperkowski%2Fhighlightos/lists"}