https://github.com/fox-it/dissect.shellitem
A Dissect module implementing a parser for the Shellitem structures, commonly used by Microsoft Windows.
https://github.com/fox-it/dissect.shellitem
Last synced: 10 months ago
JSON representation
A Dissect module implementing a parser for the Shellitem structures, commonly used by Microsoft Windows.
- Host: GitHub
- URL: https://github.com/fox-it/dissect.shellitem
- Owner: fox-it
- License: agpl-3.0
- Created: 2022-08-05T07:20:33.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2025-06-20T07:55:53.000Z (12 months ago)
- Last Synced: 2025-07-02T12:48:14.314Z (12 months ago)
- Language: Python
- Homepage:
- Size: 75.2 KB
- Stars: 3
- Watchers: 10
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# dissect.shellitem
A Dissect module implementing a parser for the Shellitem structures, commonly used by Microsoft Windows. For more
information, please see [the documentation](https://docs.dissect.tools/en/latest/projects/dissect.shellitem/index.html).
## Requirements
This project is part of the Dissect framework and requires Python.
Information on the supported Python versions can be found in the Getting Started section of [the documentation](https://docs.dissect.tools/en/latest/index.html#getting-started).
## Installation
`dissect.shellitem` is available on [PyPI](https://pypi.org/project/dissect.shellitem/).
```bash
pip install dissect.shellitem
```
This module is also automatically installed if you install the `dissect` package.
## Build and test instructions
This project uses `tox` to build source and wheel distributions. Run the following command from the root folder to build
these:
```bash
tox -e build
```
The build artifacts can be found in the `dist/` directory.
`tox` is also used to run linting and unit tests in a self-contained environment. To run both linting and unit tests
using the default installed Python version, run:
```bash
tox
```
For a more elaborate explanation on how to build and test the project, please see [the
documentation](https://docs.dissect.tools/en/latest/contributing/tooling.html).
## Contributing
The Dissect project encourages any contribution to the codebase. To make your contribution fit into the project, please
refer to [the development guide](https://docs.dissect.tools/en/latest/contributing/developing.html).
## Copyright and license
Dissect is released as open source by Fox-IT () part of NCC Group Plc
().
Developed by the Dissect Team () and made available at .
License terms: AGPL3 (). For more information, see the LICENSE file.