UUIDTool - A tool to manipulate UUIDs
UUIDTool is a command-line utility designed to work with Universally Unique Identifiers (UUIDs). It allows users to generate, analyze, and manipulate UUIDs in several ways
Disclaimer
This tool is intended to be used in CTF challenges, penetration testing, and other ethical hacking activities. Do not use it for illegal or malicious purposes.
Installation
pip install uuidtool
If you use an externally managed environment:
sudo apt install pipx
pipx install uuidtool
Or
git clone https://github.com/crazycat256/uuidtool.git
cd uuidtool
pipx install .
Usage
CLI Usage
$ uuidtool info e63034d3-acc1-11ef-8aaf-e63af2894db7
UUID: e63034d3-acc1-11ef-8aaf-e63af2894db7
Version: 1 (Time-based)
Variant: 8 (RFC 9562)
Timestamp: 2024-11-27 13:17:06 GMT (1732713426235925100)
Clock Sequence: 2735
Node: e6:3a:f2:89:4d:b7
$ uuidtool edit e63034d3-acc1-11ef-8aaf-e63af2894db7 -t 1732713730 -n 11:22:33:44:55:66
9b3eed00-acc2-11ef-8aaf-112233445566
$ uuidtool new -v 1 -t 1732718667 -c 0
19ed5780-acce-11ef-8000-e63af2894db7
$ uuidtool range e3aa7ac2-acd6-11ef-b995-e63af2894db7 5
e3aa7ac2-acd6-11ef-b995-e63af2894db7
e3aa7ac1-acd6-11ef-b995-e63af2894db7
e3aa7ac3-acd6-11ef-b995-e63af2894db7
e3aa7ac0-acd6-11ef-b995-e63af2894db7
e3aa7ac4-acd6-11ef-b995-e63af2894db7
$ uuidtool sandwich 4977ce85-acd9-11ef-801a-e63af2894db7 4977ce8b-acd9-11ef-801a-e63af2894db7
4977ce88-acd9-11ef-801a-e63af2894db7
4977ce87-acd9-11ef-801a-e63af2894db7
4977ce89-acd9-11ef-801a-e63af2894db7
4977ce86-acd9-11ef-801a-e63af2894db7
4977ce8a-acd9-11ef-801a-e63af2894db7
More examples can be found in USAGE.md.
Usage as a Library
import uuidtool, time
# Generate a UUID
uuidtool.uuid_v1(time.time_ns())
# Edit a UUID
uuidtool.edit_uuid("a0b0314a-13a0-11f0-97aa-644ed7120002", (time.time_ns() - 3600) * 1e9)
# Generate a range of UUIDs
uuidtool.uuid_range("a0b0314a-13a0-11f0-97aa-644ed7120002", 10, "asc")
# Generate a sandwich of UUIDs
uuidtool.sandwich("2e9d7ae1-13a6-11f0-86ee-644ed7120002", "2e9d7aeb-13a6-11f0-a54c-644ed7120002", "asc")
More examples can be found in USAGE.md.
License
This project is licensed under the MIT License - see the LICENSE file for details
Metadata
Release files for uuidtool 1.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| uuidtool-1.4.tar.gz | 14.0 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| uuidtool-1.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 29.9 kB
Release files / uuidtool-1.4.tar.gz
| Download URL | uuidtool-1.4.tar.gz |
|---|---|
| Size | 14.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b3400e5329618b578885bdb5e5328291fdec74828d1a5ebef026aecd93775887
|
|
BLAKE2b-256 checksum How to use checksums |
76f5076a8e7583c540880743935cc97c7a847f8fe7e9b6774e4c2f6fa0c29263
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.10.17
|
Release files / uuidtool-1.4-py3-none-any.whl
| Download URL | uuidtool-1.4-py3-none-any.whl |
|---|---|
| Size | 15.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
62efb999020c191974c24068a62b7c63de79f6afcdbd5126879b1648bafb74da
|
|
BLAKE2b-256 checksum How to use checksums |
e3792da684ebbf0291ced96a0c17119dbefc025d77001e7768ca77fe75b97ff0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.10.17
|
Security for uuidtool 1.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.