Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Sep 1, 2025

This PR adds detailed documentation and examples for the fve-dd tool to the dissect.fve project page, addressing the need for better guidance on unlocking encrypted volumes.

What's Added

Enhanced fve-dd Documentation:

  • Clear description of what the tool does and which encryption types it supports
  • Comprehensive examples showing different unlocking methods
  • Explanations of when and how to use each method

BitLocker Examples:

  • Unlocking with user passphrase
  • Unlocking with recovery password
  • Unlocking with .BEK files, including explanation that these are BitLocker External Key files typically stored on removable media

LUKS Examples:

  • Unlocking with passphrase
  • Unlocking with key files, with explanation of what LUKS key files contain
  • Advanced usage with specific key slots (--key-slot)
  • Advanced usage with key file offset and size parameters

Example Usage:

# BitLocker with .BEK file
$ fve-dd encrypted_volume.dd -f /path/to/recovery_key.BEK -o decrypted_volume.dd

# LUKS with key file
$ fve-dd encrypted_volume.dd -f /path/to/keyfile -o decrypted_volume.dd

All examples have been verified against the actual CLI interface to ensure accuracy. The documentation now provides the practical guidance requested for unlocking drives with both BitLocker .BEK files and LUKS key files.

Fixes #93. Fixes #92.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copy link
Contributor Author

Copilot AI commented Sep 1, 2025

@Schamper 👋 This repository doesn't have Copilot instructions. With Copilot instructions, I can understand the repository better, work faster and produce higher quality PRs.

I can generate a .github/copilot-instructions.md file for you automatically. Click here to open a pre-filled issue and assign it to me. I'll write the instructions, and then tag you for review.

Copilot AI changed the title [WIP] Add documentation about fve-dd to dissect.fve project page. Add comprehensive fve-dd documentation with examples for BitLocker and LUKS unlocking Sep 1, 2025
Copilot finished work on behalf of Schamper September 1, 2025 12:24
Copilot AI requested a review from Schamper September 1, 2025 12:24
@Schamper Schamper marked this pull request as ready for review September 1, 2025 12:52
@Schamper Schamper requested a review from Horofic September 2, 2025 11:08
Schamper and others added 3 commits September 8, 2025 17:23
Co-authored-by: Stefan de Reuver <[email protected]>
Co-authored-by: Stefan de Reuver <[email protected]>
Co-authored-by: Stefan de Reuver <[email protected]>
@Schamper Schamper requested a review from Horofic September 8, 2025 15:23
@Schamper Schamper requested a review from Horofic September 9, 2025 07:11
@Schamper Schamper merged commit ebcecec into main Sep 9, 2025
1 check passed
@Schamper Schamper deleted the copilot/fix-93 branch September 9, 2025 07:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add documentation about fve-dd to dissect.fve project page. Fix dissect.fve project page list

3 participants