censor/Censor
1
37
Fork
You've already forked Censor
3

meta: What is redacted? What not? #120

Open
opened 2026年03月07日 13:28:36 +01:00 by mahlzahn · 0 comments

Important

The following description is not valid for Censor until v0.5.0. I recommend to update to the latest release for more secure redaction.

Elements under redaction rectangles

  • Text:
    • characters are removed when touched by redactions
  • Drawings ("line art", "vector graphics"):
    • drawings are removed when touched by redactions, see !115
  • Images ("bitmaps"):
    • images are partially redacted with the redaction rectangles replacing underlying pixels by white pixels
  • Annotations:
    • annotations are removed when touched by redactions, see !136
  • JavaScript scripts:
    • all sources are sanitized when the document is saved, see !140
  • Field entries and responses:
    • with v0.6.0, all responses were sanitized when the document is saved, see !140
    • starting from v0.7.0, entries are kept for unredacted form fields
  • Widgets (form fields, signatures, etc.):
    • widgets are removed when touched by redactions (starting from v0.6.0, see !151)
  • Links:
    • links are removed when touched by redactions (starting from v0.6.0, see !151)

Document elements

  • Attached files and embedded files are completely removed when the document is saved, see !140
  • Metadata is removed when the document is saved, see !140. It may be added back using Paper Clip if needed.
  • Page thumbnails are removed when the document is saved, see !140
  • Elements outside of page borders are removed
  • Encryption
    • currently, encrypted documents cannot be opened, see #138

Known issues

  • Sometimes (0.7%), point- or line-like elements are not redacted on page borders without warning, see #199
  • Rarely (0.3%), redactions cannot be saved without warning, see #198
  • Sometimes (3.3%), drawings are incompletely redacted, see #134 (upstream issue), you get warned in v0.6.0
  • Sometimes (1.3%), images (or vector drawings?) are incompletely redacted, see #165, you get warned in v0.6.0
  • Rarely (0.1%), text may not be properly redacted, see #158 (upstream issue), you get warned in v0.6.0

Fixed issues

  • Sometimes (2.0%), redaction coordinates are wrong and redaction is done wrong then, too, see #161, you get warned in v0.6.0, and it got fixed in v0.7.0, see !182
  • Rarely (0.3%), annotations are not redacted, but actually on such pages annotations are removed during the sanitization step, see #137 (upstream issue), you get warned in v0.6.0, and it got fixed in v0.7.1 (with PyMuPDF 1.27.2.3), see !193
  • Rarely (0.1%), signature redaction might not work properly, see #162, you get warned in v0.6.0, and it got fixed in v0.7.0, see !179
> [IMPORTANT] > The following description is **not** valid for Censor until [v0.5.0]. I recommend to update to [the latest release](https://codeberg.org/censor/Censor/releases) for more secure redaction. ## Elements under redaction rectangles - [x] Text: - characters are removed when touched by redactions - [x] Drawings ("line art", "vector graphics"): - drawings are removed when touched by redactions, see !115 - [x] Images ("bitmaps"): - images are partially redacted with the redaction rectangles replacing underlying pixels by white pixels - [x] Annotations: - annotations are removed when touched by redactions, see !136 - [x] JavaScript scripts: - all sources are sanitized when the document is saved, see !140 - [x] Field entries and responses: - with [v0.6.0], all responses were sanitized when the document is saved, see !140 - starting from [v0.7.0], entries are kept for unredacted form fields - [x] Widgets (form fields, signatures, etc.): - widgets are removed when touched by redactions (starting from [v0.6.0], see !151) - [x] Links: - links are removed when touched by redactions (starting from [v0.6.0], see !151) ## Document elements - [x] Attached files and embedded files are completely removed when the document is saved, see !140 - [x] Metadata is removed when the document is saved, see !140. It may be added back using [Paper Clip](https://apps.gnome.org/PdfMetadataEditor/) if needed. - [x] Page thumbnails are removed when the document is saved, see !140 - [x] Elements outside of page borders are removed - [ ] Encryption - currently, encrypted documents cannot be opened, see #138 ## Known issues - [ ] Sometimes (0.7%), point- or line-like elements are not redacted on page borders **without warning**, see #199 - [ ] Rarely (0.3%), redactions cannot be saved **without warning**, see #198 - [ ] Sometimes (3.3%), drawings are incompletely redacted, see #134 (upstream issue), you get warned in [v0.6.0] - [ ] Sometimes (1.3%), images (or vector drawings?) are incompletely redacted, see #165, you get warned in [v0.6.0] - [ ] Rarely (0.1%), text may not be properly redacted, see #158 (upstream issue), you get warned in [v0.6.0] ## Fixed issues - [x] Sometimes (2.0%), redaction coordinates are wrong and redaction is done wrong then, too, see #161, you get warned in [v0.6.0], and it got fixed in [v0.7.0], see !182 - [x] Rarely (0.3%), annotations are not redacted, but actually on such pages annotations are removed during the sanitization step, see #137 (upstream issue), you get warned in [v0.6.0], and it got fixed in [v0.7.1] (with PyMuPDF 1.27.2.3), see !193 - [x] Rarely (0.1%), signature redaction might not work properly, see #162, you get warned in [v0.6.0], and it got fixed in [v0.7.0], see !179 [v0.5.0]: https://codeberg.org/censor/Censor/releases/tag/v0.5.0 [v0.6.0]: https://codeberg.org/censor/Censor/releases/tag/v0.6.0 [v0.7.0]: https://codeberg.org/censor/Censor/releases/tag/v0.7.0 [v0.7.1]: https://codeberg.org/censor/Censor/releases/tag/v0.7.1
mahlzahn locked and limited conversation to collaborators 2026年03月07日 13:30:28 +01:00
This discussion has been locked. Commenting is limited to contributors.
No Branch/Tag specified
main
v0.7.3
v0.7.2
v0.7.1
v0.7.0
v0.6.0
v0.5.0
v0.4.0
v0.3.0
v0.2.0
v0.1.0
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
censor/Censor#120
Reference in a new issue
censor/Censor
No description provided.
Delete branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?