Lightemerald/windows-user-space-emulator
2
0
Fork 0
mirror of https://github.com/momo5502/emulator.git synced 2026-01-18 03:13:55 +00:00
Code Issues Packages Projects Releases Wiki Activity
2,077 Commits 2 Branches 0 Tags
423cd0812fe0d24836f2aeb0c42f53b5d68abbe1
Go to file
Clone
Open with VS Code Open with VSCodium Open with Intellij IDEA
Download ZIP Download TAR.GZ Download BUNDLE
Maurice Heumann 423cd0812f Build(deps): Bump react-window from 1.8.11 to 2.0.2 in /page (#499) 
Bumps [react-window](https://github.com/bvaughn/react-window) from
1.8.11 to 2.0.2.
<details>
<summary>Release notes</summary>
<p><em>Sourced from <a
href="https://github.com/bvaughn/react-window/releases">react-window's
releases</a>.</em></p>
<blockquote>
<h2>2.0.2</h2>
<p>Fixed edge-case bug with <code>Grid</code> imperative API
<code>scrollToCell</code> method and &quot;smooth&quot; scrolling
behavior.</p>
<h2>2.0.1</h2>
<ul>
<li>Remove ARIA <code>role</code> attribute from <code>List</code> and
<code>Grid</code>. This resulted in potentially invalid configurations
(e.g. a ARIA <em>list</em> should contain at least one <em>listitem</em>
but that was not enforced by this library). Users of this library should
specify the <code>role</code> attribute that makes the most sense to
them <a
href="https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/list_role#best_practices">based
on mdn guidelines</a>. For example:</li>
</ul>
<pre lang="tsx"><code>&lt;List
  role=&quot;list&quot;
  rowComponent={RowComponent}
  rowCount={names.length}
  rowHeight={25}
  rowProps={{ names }}
/&gt;;
<p>function RowComponent({ index, style, ...rest }:
RowComponentProps&lt;object&gt;) {
return (
&lt;div role=&quot;listitem&quot; style={style}&gt;
...
&lt;/div&gt;
);
}
</code></pre></p>
<h2>2.0.0</h2>
<p>Version 2 is a major rewrite that offers the following benefits:</p>
<ul>
<li>More ergonomic props API</li>
<li>Automatic memoization of row/cell renderers and props/context</li>
<li>Automatically sizing for <code>List</code> and <code>Grid</code> (no
more need for <code>AutoSizer</code>)</li>
<li>Native TypeScript support (no more need for
<code>@types/react-window</code>)</li>
<li>Smaller bundle size</li>
</ul>
<h2>Upgrade path</h2>
<p>See the <a href="https://react-window.vercel.app/">documentation</a>
for more details, but here is an example of what the v1 to v2 upgrade
might look like:</p>
<h3>Before</h3>
<pre lang="tsx"><code>import { FixedSizeList, type
ListChildComponentProps } from &quot;react-window&quot;;
<p>function Example({ names }: { names: string[] }) {
const itemData = useMemo&lt;ItemData&gt;(() =&gt; ({ names }),
[names]);</p>
<p>return (
&lt;FixedSizeList
children={Row}
height={150}
itemCount={1000}
&lt;/tr&gt;&lt;/table&gt;
</code></pre></p>
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Changelog</summary>
<p><em>Sourced from <a
href="https://github.com/bvaughn/react-window/blob/master/CHANGELOG.md">react-window's
changelog</a>.</em></p>
<blockquote>
<h2>2.0.2</h2>
<p>Fixed edge-case bug with <code>Grid</code> imperative API
<code>scrollToCell</code> method and &quot;smooth&quot; scrolling
behavior.</p>
<h2>2.0.1</h2>
<ul>
<li>Remove ARIA <code>role</code> attribute from <code>List</code> and
<code>Grid</code>. This resulted in potentially invalid configurations
(e.g. a ARIA <em>list</em> should contain at least one <em>listitem</em>
but that was not enforced by this library). Users of this library should
specify the <code>role</code> attribute that makes the most sense to
them <a
href="https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/list_role#best_practices">based
on mdn guidelines</a>. For example:</li>
</ul>
<pre lang="tsx"><code>&lt;List
  role=&quot;list&quot;
  rowComponent={RowComponent}
  rowCount={names.length}
  rowHeight={25}
  rowProps={{ names }}
/&gt;;
<p>function RowComponent({ index, style, ...rest }:
RowComponentProps&lt;object&gt;) {
return (
&lt;div role=&quot;listitem&quot; style={style}&gt;
...
&lt;/div&gt;
);
}
</code></pre></p>
<h2>2.0.0</h2>
<p>Version 2 is a major rewrite that offers the following benefits:</p>
<ul>
<li>More ergonomic props API</li>
<li>Automatic memoization of row/cell renderers and props/context</li>
<li>Automatically sizing for <code>List</code> and <code>Grid</code> (no
more need for <code>AutoSizer</code>)</li>
<li>Native TypeScript support (no more need for
<code>@types/react-window</code>)</li>
<li>Smaller bundle size</li>
</ul>
<h2>Upgrade path</h2>
<p>See the <a href="https://react-window.vercel.app/">documentation</a>
for more details, but here is an example of what the v1 to v2 upgrade
might look like:</p>
<h3>Before</h3>
<pre lang="tsx"><code>import { FixedSizeList, type
ListChildComponentProps } from &quot;react-window&quot;;
<p>function Example({ names }: { names: string[] }) {
const itemData = useMemo&lt;ItemData&gt;(() =&gt; ({ names }),
[names]);</p>
<p>return (
&lt;FixedSizeList
&lt;/tr&gt;&lt;/table&gt;
</code></pre></p>
</blockquote>
<p>... (truncated)</p>
</details>
<details>
<summary>Commits</summary>
<ul>
<li><a
href="c9349a4b7b"><code>c9349a4</code></a>
2.0.1 -&gt; 2.0.2</li>
<li><a
href="6adc6c04a1"><code>6adc6c0</code></a>
Merge pull request <a
href="https://redirect.github.com/bvaughn/react-window/issues/832">#832</a>
from bvaughn/issues/831</li>
<li><a
href="bd562c5734"><code>bd562c5</code></a>
Add tests</li>
<li><a
href="cced926021"><code>cced926</code></a>
Fix scrollToCell bug</li>
<li><a
href="d1af943a69"><code>d1af943</code></a>
README formatting</li>
<li><a
href="caa4266121"><code>caa4266</code></a>
README formatting</li>
<li><a
href="2e326fbb73"><code>2e326fb</code></a>
2.0.0 -&gt; 2.0.1</li>
<li><a
href="6bcf34eec6"><code>6bcf34e</code></a>
README formatting tweak</li>
<li><a
href="ddfab80999"><code>ddfab80</code></a>
Lighthouse changes to docs site</li>
<li><a
href="e46efe922f"><code>e46efe9</code></a>
Update README</li>
<li>Additional commits viewable in <a
href="https://github.com/bvaughn/react-window/compare/1.8.11...2.0.2">compare
view</a></li>
</ul>
</details>
<br />


[![Dependabot compatibility
score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=react-window&package-manager=npm_and_yarn&previous-version=1.8.11&new-version=2.0.2)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores)

Dependabot will resolve any conflicts with this PR as long as you don't
alter it yourself. You can also trigger a rebase manually by commenting
`@dependabot rebase`.

[//]: # (dependabot-automerge-start)
[//]: # (dependabot-automerge-end)

---

<details>
<summary>Dependabot commands and options</summary>
<br />

You can trigger Dependabot actions by commenting on this PR:
- `@dependabot rebase` will rebase this PR
- `@dependabot recreate` will recreate this PR, overwriting any edits
that have been made to it
- `@dependabot merge` will merge this PR after your CI passes on it
- `@dependabot squash and merge` will squash and merge this PR after
your CI passes on it
- `@dependabot cancel merge` will cancel a previously requested merge
and block automerging
- `@dependabot reopen` will reopen this PR if it is closed
- `@dependabot close` will close this PR and stop Dependabot recreating
it. You can achieve the same result by closing it manually
- `@dependabot show <dependency name> ignore conditions` will show all
of the ignore conditions of the specified dependency
- `@dependabot ignore this major version` will close this PR and stop
Dependabot creating any more for this major version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this minor version` will close this PR and stop
Dependabot creating any more for this minor version (unless you reopen
the PR or upgrade to it yourself)
- `@dependabot ignore this dependency` will close this PR and stop
Dependabot creating any more for this dependency (unless you reopen the
PR or upgrade to it yourself)


</details>
2025-09-05 14:59:16 +01:00
.github
Update build.yml
2025-08-25 07:18:15 +02:00
cmake
Update compiler-env.cmake
2025-09-03 07:17:28 +01:00
deps
Build(deps): Bump deps/flatbuffers from 067bfdb to 82396fa (#507)
2025-09-02 12:34:00 +01:00
docs/images
Add cover image
2025-01-10 21:13:15 +01:00
page
Support latest react-window version
2025-09-05 15:34:03 +02:00
src
Build(deps): Bump icicle-cpu
2025-09-02 07:43:24 +00:00
.clang-format
Extend clang-format column limit to 140
2025-08-16 14:55:07 +02:00
.clang-format-ignore
Move clang format to root
2025-06-18 18:23:31 +02:00
.clang-tidy
Fix more warnings
2025-03-18 20:58:26 +01:00
.gitignore
Display emulation status
2025-07-11 13:43:21 +02:00
.gitmodules
Merge remote-tracking branch 'origin/main' into unicorn-upgrade-2
2025-08-23 10:40:48 +02:00
CMakeLists.txt
Automatically build as library if project is not toplevel
2025-08-24 13:00:39 +02:00
CMakePresets.json
Use RelWithDebInfo
2025-05-29 10:13:17 +02:00
LICENSE
Switch to GPL as unicorn requires it
2024-10-23 19:10:13 +02:00
README.md
Update README.md
2025-08-19 18:11:13 +02:00

README.md


Sogen is a high-performance Windows user space emulator that operates at syscall level, providing full control over process execution through comprehensive hooking capabilities.

Perfect for security research, malware analysis, and DRM research where fine-grained control over process execution is required.

Built in C++ and powered by the Unicorn Engine (or the icicle-emu 🆕).

Try it out: sogen.dev

Key Features

  • 🔄 Syscall-Level Emulation
    • Instead of reimplementing Windows APIs, the emulator operates at the syscall level, allowing it to leverage existing system DLLs
  • 📝 Advanced Memory Management
    • Supports Windows-specific memory types including reserved, committed, built on top of Unicorn's memory management
  • 📦 Complete PE Loading
    • Handles executable and DLL loading with proper memory mapping, relocations, and TLS
  • ⚡ Exception Handling
    • Implements Windows structured exception handling (SEH) with proper exception dispatcher and unwinding support
  • 🧵 Threading Support
    • Provides a scheduled (round-robin) threading model
  • 💾 State Management
    • Supports both full state serialization and fast in-memory snapshots (currently broken 😕)
  • 💻 Debugging Interface
    • Implements GDB serial protocol for integration with common debugging tools (IDA Pro, GDB, LLDB, VS Code, ...)

Preview

Preview

YouTube Overview

YouTube video

Click here for the slides.

Quick Start (Windows + Visual Studio)

Tip

Checkout the Wiki for more details on how to build & run the emulator on Windows, Linux, macOS, ...

1. Checkout the code:

git clone --recurse-submodules https://github.com/momo5502/sogen.git

2. Run the following command in an x64 Development Command Prompt in the cloned directory:

cmake --preset=vs2022

3. Build the solution that was generated at build/vs2022/emulator.sln

4. Create a registry dump by running the grab-registry.bat as administrator and place it in the artifacts folder next to the analyzer.exe

5. Run the program of your choice:

analyzer.exe C:\example.exe
Description
🪅 Windows User Space Emulator
emulatorhacktoberfestreverse-engineeringwindows
Readme GPL-2.0 16 MiB
Languages
C++ 85.1%
TypeScript 9.9%
Rust 2.6%
CMake 1.5%
CSS 0.3%
Other 0.5%