https://github.com/bugsplat-git/pdb-guid
💻🪟👀 Peek into Windows symbol files to read their unique identifiers
https://github.com/bugsplat-git/pdb-guid
bugsplat crash debugger dll exe guid minidump pdb symbol
Last synced: 9 months ago
JSON representation
💻🪟👀 Peek into Windows symbol files to read their unique identifiers
- Host: GitHub
- URL: https://github.com/bugsplat-git/pdb-guid
- Owner: BugSplat-Git
- Created: 2023-09-16T02:01:35.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-12-03T02:52:01.000Z (over 1 year ago)
- Last Synced: 2025-09-20T07:41:33.804Z (9 months ago)
- Topics: bugsplat, crash, debugger, dll, exe, guid, minidump, pdb, symbol
- Language: TypeScript
- Homepage: https://bugsplat.com
- Size: 2.86 MB
- Stars: 0
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://bugsplat.com)
#
BugSplat
### **Crash and error reporting built for busy developers.**
# pdb-guid
A nifty little library for reading unique identifiers from pdb, exe, and dll files.
## Command Line
1. Install this package globally `npm i -g pdb-guid`
2. Run pdb-guid with `-h` to see the latest usage information:
```bash
bobby@BugSplat % ~ % pdb-guid -h
pdb-guid
A command line utility and library for reading the GUID of a .pdb, .exe, or
.dll file.
Usage
--path string Path to a .pdb, .exe, or .dll file.
-h, --help Print this usage guide.
Example
pdb-guid path-to-exe-dll-or-pdb-file
Links
🐛 https://bugsplat.com
💻 https://github.com/BugSplat-Git/pdb-guid
💌 support@bugsplat.com
```
3. Run pdb-guid specifying a path to a pdb, exe, or dll file:
```bash
bobby@BugSplat % ~ % pdb-guid ./path/to/bugsplat.pdb
E546B55B6D214E86871B40AC35CD0D461
```
## API
1. Install this package locally `npm i @bugsplat/pdb-guid`.
2. Create a new instance of `PdbFile` by awaiting a call to the static factory function `PdbFile.createFromFile`. This method accepts files with a `.pdb` extension.
```ts
const pdbFile = await PdbFile.createFromFile('./path/to/bugsplat.pdb');
```
3. Create a new instance of `PeFile` by awaiting a call to the static factory function `PeFile.createFromFile`. This method accepts files with a `.exe` or `.dll` extension.
```ts
const peFile = await PeFile.createFromFile('./path/to/bugsplat.exe');
```
4. The `guid` property of `PdbFile` and `PeFile` instances will contain the unique identifier for the file.
```ts
const guid = pdbFile.guid;
```
## 🐛 About
[BugSplat](https://bugsplat.com) is a software crash and error reporting service with support for [Windows Native C++](https://docs.bugsplat.com/introduction/getting-started/integrations/desktop/cplusplus), [Qt](https://docs.bugsplat.com/introduction/getting-started/integrations/cross-platform/qt), [Unreal Engine](https://docs.bugsplat.com/introduction/getting-started/integrations/game-development/unreal-engine) and [many more](https://docs.bugsplat.com/introduction/getting-started/integrations). BugSplat automatically captures critical diagnostic data such as stack traces, log files, and other runtime information. BugSplat also provides automated incident notifications, a convenient dashboard for monitoring trends and prioritizing engineering efforts, and integrations with popular development tools to maximize productivity and ship more profitable software.