# devkitpro/libctru architecture

> Architecture diagram of the GitHub repository devkitpro/libctru, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/devkitpro/libctru
- Repository: https://github.com/devkitpro/libctru

## Overview

libctru is a low-level user-mode library for Nintendo 3DS homebrew, providing C/C++ programs with OS and hardware capabilities rather than a higher-level application framework. A typical workflow is that a homebrew program calls libctru APIs, which reach platform services or syscalls to perform work such as file access, networking, graphics, audio, or applet interaction. The graph groups the library’s main capability areas and shows only relationships supported by the README or supplied excerpts; several broad service areas are represented by their existing source directories because their implementations were not sampled.

Main entry points: [`libctru/include/3ds.h`](https://github.com/devkitpro/libctru/blob/master/libctru/include/3ds.h) (Public API), [`libctru/source/services/fs.c`](https://github.com/devkitpro/libctru/blob/master/libctru/source/services/fs.c) (Filesystem services), [`libctru/source/ndsp/ndsp.c`](https://github.com/devkitpro/libctru/blob/master/libctru/source/ndsp/ndsp.c) (DSP audio), [`libctru/include/3ds/svc.h`](https://github.com/devkitpro/libctru/blob/master/libctru/include/3ds/svc.h) (Kernel syscalls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime and kernel"]
  node_public_api["Public API<br/>[3ds.h]"]
  node_syscalls["C runtime syscalls<br/>[syscalls.c]"]
  node_os_api["OS abstractions<br/>[os.h]"]
  node_svc_api["Kernel syscalls<br/>[svc.h]"]
  node_threading["Threads and sync<br/>[thread.c]"]
  node_allocators["Memory allocators"]
  node_utilities["Utility functions"]
end

subgraph group_io["Storage and networking"]
  node_filesystem["Filesystem services<br/>[fs.c]"]
  node_archive_io["Archive devices<br/>[archive_dev.c]"]
  node_romfs["RomFS devices<br/>[romfs_dev.c]"]
  node_network["Sockets and networking"]
end

subgraph group_media["Graphics and audio"]
  node_gpu["GPU and shaders"]
  node_graphics["Graphics and display<br/>[gfx.c]"]
  node_audio["DSP audio<br/>[ndsp.c]"]
end

subgraph group_capabilities["System capabilities"]
  node_applets["System applets"]
  node_services["Platform services"]
end

node_homebrew(("Homebrew program"))

node_homebrew -->|"calls APIs"| node_public_api
node_public_api -.->|"exposes access"| node_filesystem
node_public_api -.->|"exposes access"| node_network
node_public_api -.->|"exposes access"| node_graphics
node_public_api -.->|"exposes access"| node_audio
node_public_api -.->|"exposes access"| node_applets
node_archive_io -->|"calls"| node_filesystem
node_filesystem -->|"sends requests"| node_svc_api
node_syscalls -->|"reads time"| node_os_api
node_os_api -->|"includes"| node_svc_api
node_audio -->|"loads component"| node_filesystem
node_audio -->|"reads settings"| node_services
node_network -->|"sends requests"| node_svc_api
node_syscalls -->|"joins threads"| node_threading

click node_public_api "https://github.com/devkitpro/libctru/blob/master/libctru/include/3ds.h"
click node_syscalls "https://github.com/devkitpro/libctru/blob/master/libctru/source/system/syscalls.c"
click node_os_api "https://github.com/devkitpro/libctru/blob/master/libctru/include/3ds/os.h"
click node_svc_api "https://github.com/devkitpro/libctru/blob/master/libctru/include/3ds/svc.h"
click node_threading "https://github.com/devkitpro/libctru/blob/master/libctru/source/thread.c"
click node_filesystem "https://github.com/devkitpro/libctru/blob/master/libctru/source/services/fs.c"
click node_archive_io "https://github.com/devkitpro/libctru/blob/master/libctru/source/archive_dev.c"
click node_romfs "https://github.com/devkitpro/libctru/blob/master/libctru/source/romfs_dev.c"
click node_network "https://github.com/devkitpro/libctru/tree/master/libctru/source/services/soc"
click node_gpu "https://github.com/devkitpro/libctru/tree/master/libctru/source/gpu"
click node_graphics "https://github.com/devkitpro/libctru/blob/master/libctru/source/gfx.c"
click node_audio "https://github.com/devkitpro/libctru/blob/master/libctru/source/ndsp/ndsp.c"
click node_allocators "https://github.com/devkitpro/libctru/tree/master/libctru/source/allocator"
click node_applets "https://github.com/devkitpro/libctru/tree/master/libctru/source/applets"
click node_services "https://github.com/devkitpro/libctru/tree/master/libctru/source/services"
click node_utilities "https://github.com/devkitpro/libctru/tree/master/libctru/source/util"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_public_api,node_syscalls,node_os_api,node_svc_api,node_threading,node_allocators,node_utilities toneBlue
class node_filesystem,node_archive_io,node_romfs,node_network toneAmber
class node_gpu,node_graphics,node_audio toneMint
class node_applets,node_services toneRose
class node_homebrew toneIndigo
```

## Components

### Runtime and kernel

- [Public API](https://github.com/devkitpro/libctru/blob/master/libctru/include/3ds.h): `libctru/include/3ds.h`
- [C runtime syscalls](https://github.com/devkitpro/libctru/blob/master/libctru/source/system/syscalls.c): `libctru/source/system/syscalls.c`
- [OS abstractions](https://github.com/devkitpro/libctru/blob/master/libctru/include/3ds/os.h): `libctru/include/3ds/os.h`
- [Kernel syscalls](https://github.com/devkitpro/libctru/blob/master/libctru/include/3ds/svc.h): `libctru/include/3ds/svc.h`
- [Threads and sync](https://github.com/devkitpro/libctru/blob/master/libctru/source/thread.c): `libctru/source/thread.c`
- [Memory allocators](https://github.com/devkitpro/libctru/tree/master/libctru/source/allocator): `libctru/source/allocator`
- [Utility functions](https://github.com/devkitpro/libctru/tree/master/libctru/source/util): `libctru/source/util`

### Storage and networking

- [Filesystem services](https://github.com/devkitpro/libctru/blob/master/libctru/source/services/fs.c): `libctru/source/services/fs.c`
- [Archive devices](https://github.com/devkitpro/libctru/blob/master/libctru/source/archive_dev.c): `libctru/source/archive_dev.c`
- [RomFS devices](https://github.com/devkitpro/libctru/blob/master/libctru/source/romfs_dev.c): `libctru/source/romfs_dev.c`
- [Sockets and networking](https://github.com/devkitpro/libctru/tree/master/libctru/source/services/soc): `libctru/source/services/soc`

### Graphics and audio

- [GPU and shaders](https://github.com/devkitpro/libctru/tree/master/libctru/source/gpu): `libctru/source/gpu`
- [Graphics and display](https://github.com/devkitpro/libctru/blob/master/libctru/source/gfx.c): `libctru/source/gfx.c`
- [DSP audio](https://github.com/devkitpro/libctru/blob/master/libctru/source/ndsp/ndsp.c): `libctru/source/ndsp/ndsp.c`

### System capabilities

- [System applets](https://github.com/devkitpro/libctru/tree/master/libctru/source/applets): `libctru/source/applets`
- [Platform services](https://github.com/devkitpro/libctru/tree/master/libctru/source/services): `libctru/source/services`

### Other components

- **Homebrew program**

## Connections

- Homebrew program → Public API: calls APIs
- Public API → Filesystem services: exposes access
- Public API → Sockets and networking: exposes access
- Public API → Graphics and display: exposes access
- Public API → DSP audio: exposes access
- Public API → System applets: exposes access
- Archive devices → Filesystem services: calls (evidence: `libctru/source/archive_dev.c`)
- Filesystem services → Kernel syscalls: sends requests (evidence: `libctru/source/services/fs.c`)
- C runtime syscalls → OS abstractions: reads time (evidence: `libctru/source/system/syscalls.c`)
- OS abstractions → Kernel syscalls: includes (evidence: `libctru/include/3ds/os.h`)
- DSP audio → Filesystem services: loads component (evidence: `libctru/source/ndsp/ndsp.c`)
- DSP audio → Platform services: reads settings (evidence: `libctru/source/ndsp/ndsp.c`)
- Sockets and networking → Kernel syscalls: sends requests (evidence: `libctru/source/services/soc/soc_getaddrinfo.c`)
- C runtime syscalls → Threads and sync: joins threads (evidence: `libctru/source/system/syscalls.c`)
