# graphitemaster/incbin

Include binary files in C/C++

Repository: https://github.com/graphitemaster/incbin
Canonical: https://ross.abutalabs.com/products/incbin
Language: C
License: Unlicense
License Family: permissive
Last push: 2025-05-26T23:47:50+00:00

## Health v2 (maintenance only)
Score: 43/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 23, release rhythm 35, longevity 100
- inputs: {"age_days": 4230, "days_push": 464, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1185, forks 108 (observed 2026-08-28T04:03:54.865457+00:00)

## What it is
A single-header C/C++ library that embeds binary and text files directly into executables at compile time via macros and inline assembly. It produces aligned data arrays with size and end symbols, supporting a wide range of compilers including MSVC, GCC, and Clang.

## Use cases
- embed binary files in c/c++ executables
- include images or shaders as data in c++
- embed text files as strings at compile time
- bundle assets into a single binary without external files
- embed firmware resources in embedded c projects

## When to choose
- you need assets compiled into the binary with no runtime file loading
- you want a zero-dependency, single-header solution
- you need SIMD-aligned embedded data for vectorized code
- you target many compilers including MSVC and embedded toolchains

## When to avoid
- you need to load or swap assets at runtime
- your build pipeline already handles asset embedding via code generation
- you require strict MISRA compliance without independent verification
- your compiler lacks GCC-style inline assembler support and is not MSVC

## Facets
- artifact type: library
- maturity: stable
- function: compiler, developer-tools, file-system
- domain: developer-tools, cross-platform, embedded-systems
- platform: cross-platform, cpp, c, embedded
- tags: header-only, embed-binary-files, single-header, c-cpp, inline-assembly, public-domain

## Member repositories
- graphitemaster/incbin (main) score 43

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:54.865457+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:24:07.151671+00:00, confidence not recorded.
  - readme: https://github.com/graphitemaster/incbin (fetched 2026-08-28T04:03:54.865457+00:00, sha 093b84a3969a)
- Data as of 2026-08-30T08:39:29.467469+00:00.