{"id":41602816,"url":"https://github.com/calladoum-elastic/ttd-rust","last_synced_at":"2026-01-24T10:52:24.892Z","repository":{"id":329020511,"uuid":"1099215851","full_name":"calladoum-elastic/ttd-rust","owner":"calladoum-elastic","description":"Rust bindings for the Microsoft Time Travel Debugging (TTD) SDK.","archived":false,"fork":false,"pushed_at":"2025-12-16T20:58:38.000Z","size":143,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-20T11:44:23.451Z","etag":null,"topics":["rust-crate","rust-lang","timetravel","ttd","windows"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/calladoum-elastic.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-18T18:04:29.000Z","updated_at":"2025-12-16T20:58:42.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/calladoum-elastic/ttd-rust","commit_stats":null,"previous_names":["calladoum-elastic/ttd-rust"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/calladoum-elastic/ttd-rust","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calladoum-elastic%2Fttd-rust","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calladoum-elastic%2Fttd-rust/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calladoum-elastic%2Fttd-rust/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calladoum-elastic%2Fttd-rust/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/calladoum-elastic","download_url":"https://codeload.github.com/calladoum-elastic/ttd-rust/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/calladoum-elastic%2Fttd-rust/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28725378,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-24T10:24:43.181Z","status":"ssl_error","status_checked_at":"2026-01-24T10:24:36.112Z","response_time":89,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["rust-crate","rust-lang","timetravel","ttd","windows"],"created_at":"2026-01-24T10:52:22.059Z","updated_at":"2026-01-24T10:52:24.883Z","avatar_url":"https://github.com/calladoum-elastic.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# `ttd-rust`\n\nRust bindings for the [**Microsoft Time Travel Debugging (TTD) SDK**](https://github.com/microsoft/WinDbg-Samples/blob/master/TTD/README.md).\n\nThis crate provides a safe and ergonomic Rust interface to the TTD SDK, enabling developers to record, replay, and analyze program execution using Microsoft's time-travel debugging technology.\n\n\u003e [!WARNING]\n\u003e TTD-Rust is currently a work in progress, the API (especially in the `ttd` crate) may change between commits.\n\u003e If you start using the library, prefer locking it to a specific commit\n\n## Overview\n\n[Microsoft Time Travel Debugging](https://learn.microsoft.com/en-us/windows-hardware/drivers/debugger/time-travel-debugging-overview) (TTD) is a powerful debugging tool that allows you to step forward and backward through program execution.\n\n`ttd-rust` wraps the native TTD SDK, making it accessible from Rust without requiring manual FFI boilerplate.\n\n## Features\n\n- Safe Rust wrappers around TTD SDK functions.\n- Multi replay engine/multi-cursor support\n- Thread-safe\n- Replay program execution from created traces. Trace recording bindings will be added soon.\n- Query events, memory state, and call stacks at any point in time.\n- Integration with existing Rust debugging workflows.\n\n## Build Requirements\n\n- Rust 1.90+\n- Windows 10 or later (TTD is Windows-only).\n  - `winget` must be present\n- C++ build tools (for compiling native bindings) including\n  - `cmake`\n  - VisualStudio 2019 or later\n\n## Installation\n\nAdd `ttd-rust` to your `Cargo.toml`:\n\n```toml\n[dependencies]\nttd-rust = { git = \"https://github.com/calladoum-elastic/ttd-rust\" }\n```\n\n## Build\n\n`cargo` will entirely handle the build. If the libraries/dlls are missing, it will automatically download them.\n\n```pwsh\ncargo build --all-targets\n```\n\n## Test\n\n### Test the C++ layer\n\n```pwsh\ncargo build\nctest -C Debug -T test --test-dir .\\ttd\\ttd_ffi\\build\\tests\n```\n\n### Test the Rust layer\n\n```pwsh\ncargo test\n```\n\n## Documentation\n\n* `cargo doc`\n* [Microsoft TTD Documentation](https://learn.microsoft.com/en-us/windows-hardware/drivers/debugger/time-travel-debugging)\n* [Microsoft TTD SDK Documentation](https://github.com/microsoft/WinDbg-Samples/blob/master/TTD/README.md)\n\n\n## Examples\n\n### Usage\n\n```rust\nuse ttd::replay::ReplayEngine;\nuse ttd::replay::events::EventType;\n\nfn main() -\u003e Result\u003c(), ttd::error::Error\u003e {\n  // Open a recording\n  let mut engine = ReplayEngine::open(r\"c:\\path\\to\\my_trace.run\")?;\n\n  // Print some info\n  dbg!(engine.system_info);\n\n  // Navigation through the trace can be done using cursors\n  let mut cursor = engine.cursor()?;\n\n  // Replay forward until the end of the trace\n  let replay_result = cursor.replay_forward(None)?;\n  assert_eq!(res.stop_reason, EventType::Process);\n\n  // Inspect memory state at a specific point\n  let memory_dump = cursor.read_memory(0x12345678)?;\n  println!(\"Memory dump: {:?}\", memory_dump);\n\n  // You can also retrieve the register context at current point\n  let ctx = cursor.thread_context()?;\n  println!(\"Regsisters\\n{}\", ctx);\n\n  Ok(())\n}\n```\n\n### Binaries\nSeveral examples were provided to illustrate how to use the Rust API:\n - `auto_unpack` - an automatic unpack that will extract encoded/encrypted payload injected using `VirtualAlloc(RWX)`/`VirtualProtect(RWX)`\n\n## License\n\nThis project is licensed under the Apache-2.0 License.\nSee LICENSE for details.\n\n## Disclaimer\n\n`ttd-rust` is not a Microsoft product.\nIt is a community maintained project that depends on the Microsoft TTD SDK.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcalladoum-elastic%2Fttd-rust","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcalladoum-elastic%2Fttd-rust","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcalladoum-elastic%2Fttd-rust/lists"}