specter-mem 1.0.4

ARM64 memory manipulation framework for iOS/macOS — inline hooking, stealth code patching, hardware breakpoints, and shellcode loading
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

# Specter

[![CI](https://github.com/Batchhh/libspecter/actions/workflows/ci.yml/badge.svg)](https://github.com/Batchhh/libspecter/actions/workflows/ci.yml)
[![Crates.io](https://img.shields.io/crates/v/specter-mem.svg)](https://crates.io/crates/specter-mem)


ARM64 memory manipulation framework for iOS/macOS. Compiled as a static library (`libspecter.a`) consumed via a plain C/C++ header (`specter.h`).

Provides inline function hooking, stealth code patching, hardware breakpoints, memory read/write, symbol resolution, and shellcode loading — all targeting `aarch64-apple-ios` & `aarch64-apple-darwin`.

## Quick start for Rust sources

```bash
cargo add specter-mem
```

## Build

The release targets **iOS** (`aarch64-apple-ios`) and **macOS** (`aarch64-apple-darwin`).

```bash
rustup target add aarch64-apple-ios   # once
make                                  # builds both iOS and macOS (release)
make ios                              # iOS only
make macos                            # macOS only
make debug                            # both targets (debug)
make check                            # verify exported symbols match specter.h
```

## Integrate

```
-L<path> -lspectre -lc++ -framework Foundation -framework Security
```

## Docs

[docs/usage.md](docs/usage.md) — C/C++ API reference and examples

[docs/rust.md](docs/rust.md) — Rust API reference and examples

[docs/architecture.md](docs/architecture.md) — Internal design and data flows

## Contributing

1. Fork the repo and create a branch from `main`.
2. Run `cargo fmt --all` and `cargo clippy --lib -- -D warnings` before pushing.
3. Keep PRs focused — one logical change per pull request.
4. Open an issue first for anything large or architectural.

Bug reports and feature requests are welcome via [GitHub Issues](https://github.com/Batchhh/libspecter/issues).

## Legal

This project is intended for **educational and research purposes only**. Use it only on devices and applications you own or have explicit authorization to test. The author is not responsible for any misuse or damage caused by this software.

## License

MIT — see [LICENSE](LICENSE).