aboutsummaryrefslogtreecommitdiffstats
path: root/src/content/docs/guides/file-operations.md
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--src/content/docs/guides/file-operations.md54
1 files changed, 42 insertions, 12 deletions
diff --git a/src/content/docs/guides/file-operations.md b/src/content/docs/guides/file-operations.md
index 40d7189..6b25cce 100644
--- a/src/content/docs/guides/file-operations.md
+++ b/src/content/docs/guides/file-operations.md
@@ -8,17 +8,43 @@ GpgFrontend offers a fast and convenient method for working with files. The
processes of encryption, decryption, signing, and verifying files are similar to
text-based operations but involve binary input and output.
-## Using File Panel for Encryption, Decryption, Signing, and Verifying
+## Quick File Operations via Direct Selection
+
+GpgFrontend enables you to quickly process any file or directory directly from
+the main interface, streamlining your workflow for secure file handling.
+
+1. Direct File Selection: In the main window, click the Open button and choose
+ either Open File or Open Directory from the drop-down menu.
+2. In the system dialog, select the file (e.g., CCC.eml) or directory you want
+ to process.
+3. Automatic File Panel Activation: If you select a file, the File Panel will
+ automatically open, with the chosen file highlighted and ready for operation.
+ If you select a directory, the File Panel opens showing the entire directory
+ contents, allowing you to browse and select one or more files for further
+ action.
+4. Proceed with Cryptographic Operations: With the File Panel open, you can now
+ select one or more keys from the Key ToolBox (individual public keys or key
+ groups). Then, you can click the appropriate toolbar button—Encrypt, Decrypt,
+ Sign, or Verify—to perform the desired cryptographic operation on the
+ selected file(s).
+
+![](https://image.cdn.bktus.com/i/2025/06/24/51136aa32550eeeaecdb8dff32d62526280919ab.webp)
+
+## Using File Panel Directly
After clicking the **File Panel** button, a system directory selection dialog
will appear. Follow these steps to perform various cryptographic operations:
-1. Open File Panel: Click the **File Panel** button in the toolbar at the top of the interface. This will open a system dialog allowing you to choose a directory.
-2. Select Directory: In the system dialog, navigate to the desired directory and select it. Once
- selected, a new tab named "File Panel" will open in GpgFrontend, displaying
- the contents of the chosen directory.
-3. Select a File: In the File Panel tab, click on the file you want to encrypt, decrypt, sign,
- or verify.
+1. Open File Panel: Click the **File Panel** button in the toolbar at the top of
+ the interface. This will open a system dialog allowing you to choose a
+ directory.
+2. Select Directory: In the system dialog, navigate to the desired directory and
+ select it. Once selected, a new tab named "File Panel" will open in
+ GpgFrontend, displaying the contents of the chosen directory.
+3. Select a File: In the File Panel tab, click on the file you want to encrypt,
+ decrypt, sign, or verify.
+
+![](https://image.cdn.bktus.com/i/2025/06/24/acb0e681d8f383589727d0012c3842c487033fa1.webp)
### 4. File Operations (Encrypt, Decrypt, Sign, Verify)
@@ -41,10 +67,12 @@ Understanding the appropriate file extensions helps in managing encrypted and
signed files properly. Here’s a breakdown of the file extensions used:
### ASCII Format
+
- **.asc**: ASCII-armored files. Can contain encrypted data or signatures in a
text-compatible format.
### Binary Format
+
- **.gpg**: Binary encrypted files or combined encrypted and signed files. More
efficient for storage and transmission.
- **.sig**: Binary signature files used exclusively for signature operations.
@@ -61,11 +89,11 @@ settings.
To change the output mode between ASCII and binary formats:
1. Open Settings: Navigate to the GnuPG Controller settings within GpgFrontend by accessing
- the settings menu.
-2. Locate Binary Mode Option: In the settings interface, under the "General" section, find the option
- labeled "Use Binary Mode for File Operations".
-3. Toggle Binary Mode: Check or uncheck this option to switch between binary (gpg/sig) and ASCII
- (asc) output formats.
+ the settings menu.
+2. Locate Binary Mode Option: In the settings interface, under the "General"
+ section, find the option labeled "Use Binary Mode for File Operations".
+3. Toggle Binary Mode: Check or uncheck this option to switch between binary
+ (gpg/sig) and ASCII (asc) output formats.
This streamlined process allows you to manage file encryption, decryption,
signing, and verification efficiently with GpgFrontend.
@@ -123,6 +151,7 @@ directory contents while preserving their original structure.
When a folder is selected for encryption, GpgFrontend automatically performs the
following operations:
+
1. Archiving: The folder is first archived using the tar utility, combining all
files and subdirectories into a single .tar archive.
2. Encryption: The `.tar` archive is then encrypted using GnuPG, resulting in a
@@ -139,6 +168,7 @@ transferable format.
GpgFrontend also offers automatic extraction when decrypting `.tar.gpg` or
`.tar.asc` files:
+
1. Decryption: The selected encrypted archive is decrypted using GnuPG,
producing the original `.tar` archive.
2. Extraction: If the decrypted content is a `.tar` archive, GpgFrontend