aboutsummaryrefslogtreecommitdiffstats
path: root/src/content/docs/guides/understand-interface.md
blob: 3659dc7d1ed491f91f105faa44d6fc0aeaaafa2c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
---
title: Interface Understanding
sidebar:
  order: 2
---

This documentation explains the layout and features of the latest GpgFrontend
interface, helping users to efficiently utilize all cryptographic operations in
different workspaces.

![Interface](https://image.cdn.bktus.com/i/2025/06/24/f0121645a9c0d8f0e67b2b9f4d1788bd42c7674a.webp)

## Workspace Overview

GpgFrontend organizes your cryptographic workflow into multiple workspaces
(tabs), making it easy to work with files, plain text, and email data
simultaneously.

There are three main workspace types, each represented by a tab:

- File Panel: For batch file and folder operations.
- Text Editor: For editing and encrypting/decrypting plain text.
- Mail Editor: For handling email messages in a dedicated editor.

You can open multiple tabs of each type and switch between them as needed.

### File Panel

The File Panel is dedicated to cryptographic operations on files and folders. It
allows you to:

- Browse and select files or folders from your system.
- Encrypt, decrypt, sign, or verify one or multiple files.
- Switch between ASCII and binary output modes.
- Activate Batch Mode for multi-file operations.
- Automatically handle folder archiving/encryption (see the File Operations
  section for details).

Files and folders selected via Open are always opened in a File Panel tab.

### Text Editor

The Text Editor allows users to input any desired text or work on existing
files.

#### Key Features

- **Operations Bar**: Located at the top, it provides options to encrypt,
  decrypt, sign, and verify text directly.
- **Standard Shortcuts**: Supports basic shortcuts like **Ctrl+C**, **Ctrl+V**,
  and **Ctrl+S** for copying, pasting, and saving text.
- **Plain Text Format**: Text is encoded in UTF-8 without formatting to ensure
  clarity and compatibility. Future plans may include rich text editing.

#### Large Text File Support

- Files up to **1MB** are supported. Larger files may cause performance issues
  and are not recommended.
- While loading large files, editing will be temporarily disabled until the
  entire file is processed.

### Mail Editor

The Mail Editor is specifically designed for working with EML-format email
messages.

- Open and Edit EML Files: Load .eml files (standard email format) directly for
  viewing and editing their content.
- Compose, Encrypt, Sign, and Verify Emails: Easily write or modify email
  content and apply encryption, digital signatures, or verify received
  signatures—all in one place.

:::caution[Note]

The Mail Editor is optimized for .eml files, ensuring compatibility with standard email clients and maintaining proper formatting and metadata during cryptographic operations.

:::

## Information Panel

The **Information Panel** displays the results of current operations (e.g.,
encryption, decryption, signing) and their status, such as success or failure.
It provides helpful details about the operation, such as timestamps, key IDs,
and algorithms used.

### Color Coding for Status

- **Green**: Indicates a successful operation with no issues.
- **Yellow**: Suggests a successful operation but with potential warnings.
- **Red**: Signifies an unsuccessful operation or critical errors.

### Dashboard Actions Menu

- **Copy**: Copies content from the Information Panel to the clipboard.
- **Save File**: Saves the Information Panel's content as a plain text file
  (UTF-8).
- **Clear**: Clears all content from the Information Panel, resetting it for the
  next operation.

## Key Toolbox

The **Key Toolbox**, located on the right side of the interface, lists all
available keys. It provides details such as key type, name, email address, and
usage. Users can select keys for specific operations by ticking the boxes in the
first column.

### Key Details

- **Type**:
  - `pub`: Public key (for encryption or verification).
  - `pub/sec`: Key pair with both public and private keys.
  - `pub/sec#`: Key pair with missing primary key.
  - `pub/sec^`: Key pair with components stored on a smart card.
- **Email Address**: Shows the email associated with each key.
- **Usage**: Indicates key functionality with codes:
  - `C`: Certification.
  - `E`: Encryption.
  - `S`: Signing.
  - `A`: Authentication.

### Categories

The toolbox categorizes keys by type (e.g., public or private) using tabs.
Expired or revoked keys are not displayed by default and can be viewed in
**Manage Keys**.

## Operations Bar

The Operations Bar at the top provides one-click access to all core
cryptographic and workspace features. Here are the main buttons, from left to
right:

1. **Open**: Open a file or directory, launching the File Panel for file-based
   operations.
2. **Workspace**: Manage and switch between different workspaces or tabs, such
   as File Panel, Text Editor, and Mail Editor.
3. **Encrypt**: Encrypt the currently selected file(s) or text using the
   selected recipient keys.
4. **Decrypt**: Decrypt the currently selected encrypted file(s) or text. No key
   selection is required—gpg automatically detects and uses the
   appropriate private key(s) from your keyring.
5. **Sign**: Digitally sign the selected file(s) or text with your private key.
6. **Verify**: Verify the signature of the selected file(s) or text.
7. **New Keypair**: Generate a new key pair.
8. **Import Key...**: Import existing public or private keys into your keyring.
9. **Manage Keys**: Access the key management interface.

### Customization

You can hide unused functions or add frequently used ones via the view settings
menu in the application.