{"id":26339599,"url":"https://github.com/voltageddebunked/syncos","last_synced_at":"2025-03-16T03:18:01.569Z","repository":{"id":281079042,"uuid":"944083207","full_name":"VoltagedDebunked/syncos","owner":"VoltagedDebunked","description":"A Stable, Modern and Fast x86-64 Operating System.","archived":false,"fork":false,"pushed_at":"2025-03-06T21:10:33.000Z","size":52,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-06T22:22:20.240Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C","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/VoltagedDebunked.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":"2025-03-06T18:56:38.000Z","updated_at":"2025-03-06T21:10:37.000Z","dependencies_parsed_at":"2025-03-06T22:22:21.746Z","dependency_job_id":"b8f44248-acde-475b-8fa5-cc90d91bb685","html_url":"https://github.com/VoltagedDebunked/syncos","commit_stats":null,"previous_names":["voltageddebunked/syncos"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VoltagedDebunked%2Fsyncos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VoltagedDebunked%2Fsyncos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VoltagedDebunked%2Fsyncos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VoltagedDebunked%2Fsyncos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VoltagedDebunked","download_url":"https://codeload.github.com/VoltagedDebunked/syncos/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243818101,"owners_count":20352629,"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":[],"created_at":"2025-03-16T03:18:01.141Z","updated_at":"2025-03-16T03:18:01.564Z","avatar_url":"https://github.com/VoltagedDebunked.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SyncOS\n\nA modern, robust operating system kernel for x86-64 built with reliability and synchronization in mind.\n\n![License: GPL-3.0](https://img.shields.io/badge/License-GPL%203.0-blue.svg)\n\n## Overview\n\nSyncOS is a minimalist kernel designed specifically for the x86-64 architecture. It provides basic kernel functionality with a focus on proper synchronization primitives and hardware abstraction.\n\n## Features\n\n- **x86-64 architecture**: Optimized for modern 64-bit Intel/AMD processors\n- **Modular design**: Clean separation of kernel components\n- **UEFI boot**: Uses Limine bootloader for UEFI booting\n- **BIOS fallback**: Optional legacy BIOS boot support\n- **Robust memory management**: Properly aligned and protected kernel structures\n- **Interrupt handling**: Complete IDT setup with exception handlers\n- **Serial I/O**: Fully functional serial port communication\n- **Standard library**: Basic kernel-level standard library implementation\n\n## Project Structure\n\n- `/src`: Contains the kernel source code\n  - `/src/core`: Core kernel functionality\n  - `/src/syncos`: OS-specific components (GDT, IDT, serial, etc.)\n  - `/src/kstd`: Kernel standard library implementation\n- `/config`: Configuration files for building and booting\n- `/limine`: Limine bootloader files (downloaded during build)\n- `/ovmf`: OVMF firmware files for UEFI (downloaded during build)\n\n## Building\n\n### Prerequisites\n\nTo build SyncOS, you'll need:\n\n- GCC or Clang with target architecture support\n- NASM (for x86_64 assembly)\n- xorriso\n- mtools\n- curl\n- git\n- make\n\n### Build Commands\n\nBuild the kernel:\n\n```bash\nmake\n```\n\n### Build Targets\n\n- `make all`: Build an ISO image\n- `make all-hdd`: Build a hard disk image\n- `make clean`: Remove build artifacts\n- `make distclean`: Remove all generated files, including dependencies\n\n## Running\n\n### Using QEMU\n\nRun with default settings:\n\n```bash\nmake run\n```\n\nRun with custom QEMU flags:\n\n```bash\nmake run QEMUFLAGS=\"-m 4G -smp 4\"\n```\n\n### Debug Mode\n\nStart QEMU in debug mode and wait for GDB connection:\n\n```bash\nmake run-debug\n```\n\nThen connect with GDB:\n\n```bash\ngdb -ex \"target remote localhost:1234\" src/bin-x86_64/kernel\n```\n\n## Development\n\n### Adding New Features\n\n1. Implement your feature in the appropriate directory\n2. Update the main kernel to initialize your feature\n3. Make sure to follow x86-64 calling conventions and memory layout\n\n## License\n\nSyncOS is licensed under the GNU General Public License v3.0 (GPL-3.0). See the LICENSE file for details.\n\n## Contact\n\nMaintainer: Voltaged  \nRepository: https://github.com/voltageddebunked/syncos","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoltageddebunked%2Fsyncos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvoltageddebunked%2Fsyncos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoltageddebunked%2Fsyncos/lists"}