Skip to content

Repository files navigation

Picklock

A Picklock session: attaching to a process, scanning for a value, and writing to it

Read, write and scan the memory of a running process from any terminal.
Pure Python. It installs on a bare server as easily as on a desktop.

Python Package Pypi License Python Version


A terminal client for reading, writing and scanning process memory, on Windows, Linux and macOS.

pip install picklock
picklock

It uses PyMemoryEditor as its only dependency, so it can be used easily anywhere.

Documentation

Full documentation lives at picklock.readthedocs.io — the scan cycle, address expressions, pointer chains, scripting, platform permissions, and every command's arguments.

Quick startAttach to a process, find a value, change it.
ScanningThe first-scan/refine cycle, AOB and regex scans.
Addressesmodule+offset, dereferences, and #N scan rows.
Reading and writingValue types, typed reads and writes, hex views and watches.
PointersPointer scans, and the workflow that makes a path survive a restart.
ScriptingNon-interactive use, exit codes, JSON export.
Command referenceEvery command and flag, generated from the code.
PermissionsWhat each OS wants before it lets you attach.
TroubleshootingScans that find nothing, chains that stop working.

Use help to list Picklock's commands, and help <command> to get more details about one command.

🤝 Contributing

Pull requests, bug reports and feature ideas are very welcome. Read CONTRIBUTING.md for the development setup, test layout and the small set of platform-specific quirks to be aware of.

⭐ Related

Every read, write, scan and pointer walk is performed by PyMemoryEditor, the cross-platform memory library Picklock is built on. If you find Picklock useful, check out that one too — it is what makes any of this work on three operating systems at once.

License

Released under the MIT License — free for personal and commercial use.

About

A terminal client to inspect, modify and search the memory of any running process from anywhere.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages