You are reading the docs of the unreleased development version. Go to the latest version →
Skip to content

PDFs ​

Blank opens the PDFs people send you, so you can read them next to your own writing and see at once whether they're signed, by whom, and whether anything changed since.

Open a PDF ​

Press Mod O and pick a PDF, or drop one on Blank's icon, or right-click it in your file manager and choose Open With → Blank. It opens in a tab of its own, next to your documents.

The pages show as they print: one below the other, white in every theme, as wide as the window allows. Scroll with the mouse, ↑ ↓, Page Up Page Down, Space, or Home and End for the first and last page. The status bar says which page you're on; click it to go to another. Next to it is the PDF's paper, e.g. A4.

To see the pages larger or smaller, zoom as in your documents: Mod = and Mod -, Ctrl and the mouse wheel, or − and + in the status bar, where a click on the zoom fits the pages to the window again. The zoom is the same in every tab, and the spot under the pointer, or in the middle of the window, stays where it is.

Blank never changes the file itself. What you fill in and place on its pages stays in Blank until you sign, which saves a new file; so exporting, formatting, searching and the page setup aren't there: their shortcuts say so, and in the main menu they're greyed out, saying why when you point at them. Close the tab with Mod W as any other; when you start Blank again, it opens the PDF again from its file. A large PDF opens in the background: its tab says Opening … meanwhile, and you can go on in your other tabs.

Fill in and sign a PDF you received ​

A contract, a form, a lease: Blank shows you where the PDF wants your signature, a date or your details, lets you fill it in from the keyboard or with the mouse, and saves it signed as a new file next to the one you received.

The places to fill in ​

When a PDF opens, Blank looks for the places to fill in and marks each with a dashed box:

  • The PDF's form fields: text fields, checkboxes, radio buttons, lists, and empty signature fields. Read-only fields stay as they are. A field an earlier signer locked shows, but greyed out: pointing at it says An earlier signer locked this field, so it can't change any more, and Next passes it.
  • Lines with a label, in PDFs without a form: a line of underscores, dots or a drawn line next to Signature, Date, Place, Place, date or Initials, in English or German (Unterschrift, Datum, Ort, Datum, Kürzel, …), and Unterschrift Mieter as Signature · Mieter.

Once Blank found places in a PDF, Next in the signing toolbar goes to the next place you haven't filled in yet, in reading order, and says what it is, e.g. Signature on page 3. Press Enter to fill it in. It reads Next · 2 of 5 while places are left, and All places filled once you're done. Give it a key of your own in Settings ▸ Shortcuts (Next place to sign). Tab and Shift Tab go through the places and what you placed, as they're read.

ToMouseKeys
Sign a signature field or lineclick itEnter or Space
Date a date line, place a place lineclick itEnter or Space
Fill in a text fieldclick it, typetype, then Enter or Tab; Esc drops what you typed
Tick a checkbox, choose a radio buttonclick itSpace or Enter
Choose from a listclick it, pickEnter, ↑ ↓, Enter
Leave out a line Blank foundDelete (undo brings it back)
Undo, redoMod Z, Mod Shift Z

Your signature goes into a signature field as large as it fits. On a line, it stands on the line, large enough to read, as wide as the line allows. A date or place line gets today's date or your place, in letters as large as the line's label. A text field that asks for your name, the date or the place starts with it: press Enter to keep it, or type over it. Tab past it leaves it empty. Remove a signature from a place with Delete or Remove, and the place is back, selected. Move a signature off its place, and the place shows again too: the signature is then one of its own, where you put it.

The text you type into a form field shows in the field's own font, which the PDF chooses, so it takes Western European letters only: Greek, Cyrillic, Chinese or a Polish Ł say so above the field, naming the first letter it can't show, e.g. This field's font can't show “Ł”, and the field keeps what it had. Write it with letters the font has, e.g. L for Ł, or ask the sender for a form with another font.

Place your signature, initials, date and place ​

In a PDF tab, the toolbar above the pages has the signing tools: Signature, Initials, Date and Place, then Sign… and Next. They place a stamp anywhere on a page, also where Blank found no place.

  • With the mouse: click a tool, then click the page where it goes: it's placed there, centred on the click. While a tool waits for the click, the pointer is a crosshair; Esc or a second click on the tool puts it down again.
  • With the keyboard: press Alt F10 (or F6 until you're in the toolbar), go to a tool with ← → and press Enter or Space. It's placed on the page you're reading: a signature in the lower third, centred; initials at the bottom right; a date or place below your last signature.

The first time you use Signature or Initials, Blank asks you to make them, then places them. The date is today's, written as Settings ▸ Signing ▸ Date says, in the language you last chose in a document's status bar; the place is where you signed last. The first time you place a place, Blank asks where you sign, and remembers it.

What you placed is selected, with a ring and four corners, and a small toolbar above it:

ToMouseKeys
Move itdrag it← → ↑ ↓ by 1 pt, with Shift 10 pt
Make it larger or smaller (its shape stays)drag a cornerAlt → or ↑ larger, Alt ← or ↓ smaller, with Shift 10 pt
Remove itRemove on its toolbarDelete or Backspace
Put initials on every pageRepeat on every page on its toolbarTab to the toolbar, then Enter
Undo, redoMod Z, Mod Shift Z
Leave itclick elsewhere on the pagesEsc

It stays on its page, with at least a little of it showing, and grows to at most three times its size and shrinks to half. Repeated initials show faded on the other pages, at the same spot, moved into smaller pages. A screen reader names each stamp, e.g. Signature on page 2.

A PDF tab you filled in or placed something on has a dot, as a document with unsaved changes has. Blank keeps it when you close Blank, and when you start it again, it's back on the pages, as long as the file is the same. If the file changed, when Blank starts or when you open it again with Open again or Find it…, what was on pages it no longer has is gone, what no longer fits on a smaller page moves onto it, and so are its form's entries and the lines you left out, and Blank says so. Closing the tab asks whether to Sign… it first; Discard drops what you did.

Sign it ​

Sign…, or Mod S in a PDF tab, opens the Sign dialog:

  • Sign as: your certificate, which signs it digitally with your passphrase, or No digital signature (only the visible signature), which only shows your signature on the page. Without a signature on a page, a digital signature is invisible (PDF apps list it in their signature panel), and No digital signature needs one. A PDF others signed takes only a digital signature: No digital signature is greyed out there, since your signature would change pages they signed.
  • Initials: On every page puts your initials on every page, at the bottom right or left, or takes the repeated initials off again.
  • Place and Reason go into the digital signature.
  • It says how many places are still to fill in, and Open the signed PDF opens the result in a tab of its own, whose status bar then says Signed.

Then choose where to save it: Blank suggests the PDF's name with signed after it, next to it, e.g. lease signed.pdf, so the PDF you received stays as it is. The signed PDF holds what you typed into its form, your stamps, and your digital signature over all of it, added after what the PDF had, so earlier signatures stay intact. While Blank signs, the tab's fields, places and tools wait: they say Blank is signing this PDF. Once it's saved, the tab is as you received it again, with nothing left unsaved. If anything goes wrong, Blank says why and writes nothing; a wrong passphrase you just type again.

Some PDFs don't allow everything, and the tools say why when you point at them:

  • Signed or certified already: you can still fill in its fields and sign it digitally, but only one signature of yours can go on its pages, as the appearance of a signature field. Initials, a date or a place would change pages the earlier signers signed, so their tools are off, and so is Signature once one is placed. Fields an earlier signer locked are greyed out.
  • Allows no changes (certified so by its author), restricted by its author, or damaged: nothing can be filled in, added or signed, and the toolbar says why.
  • When Blank's page layout didn't start, the stamps are off, and the toolbar says so.

Print a PDF ​

Press Mod P, or choose Print… in the main menu or the tab's menu, and the PDF goes straight to your system's print dialog, as it is: Blank's own print dialog is for the pages Blank lays out. Choose the printer and its options there.

  • Linux: Blank prints the PDF whole, at its own size, and says so before the print dialog opens: leave all pages and 100% there. If you choose some pages or another scale anyway, Blank prints nothing and says why; print it again with all pages at 100%, or open the PDF in another app to print part of it.
  • macOS and Windows: the print dialog prints the pages you choose there.

If the file changed since Blank opened it, Blank doesn't print it, since it wouldn't be what the tab shows: the tab says the PDF changed, with Open again to show it as it is now, and then you can print it. If it was moved or deleted, the tab offers Find it….

When a PDF can't be shown ​

Instead of the pages, the tab then says why, with what you can do about it:

  • Moved or deleted: the file isn't where it was, also when you start Blank again. Find it… picks where it went.
  • Changed: another app changed the file after Blank opened it. Open again shows it as it is now.
  • Damaged, too large or complex: Blank can't read it, or it would take too much memory or time. Open it in another app.
  • Needs a password: Blank can't open PDFs that need a password.

Blank draws a PDF's pages with a separate program, blank-pdf, one for each PDF tab. A PDF that takes it down only takes down its tab: Blank starts it again once, and a page it couldn't draw says Blank couldn't draw this page. If it stops while it opens the PDF, or a second time, the tab says so, with Open again to try once more and Close tab. Everything else in Blank goes on as before.

Check the signatures ​

The status bar of a PDF tab says what the PDF's digital signatures say:

Status barWhat it means
Not signedThe PDF has no digital signatures.
Signed, Signed by 2Nothing changed since it was signed, and each certificate is yours or one you trust. Signatures others added later, and nothing else, don't count as a change.
Signed, signer unknownNothing changed since it was signed, but Blank doesn't know a certificate: see below how to trust it.
Changed and signed againA signature is valid for the version it signed, but the PDF was changed after it, by more than adding signatures, and signed again later; its list says by whom. Check who made the changes.
Weak signatureA signature relies on SHA-1, an old algorithm whose signatures can be forged. Don't rely on it.
Changed after signingSomeone changed the PDF after it was signed.
Signature invalidA signature doesn't match the PDF.
Signatures not checkedBlank couldn't read the PDF's signatures. Open the PDF in your PDF app to check them. If the file changed or was moved after Blank opened it, the status says so, and the list offers Open again for a changed file, to check it as it is now.

When the check finds something wrong or doubtful, a screen reader reads it out.

Click it to see each signature: who signed, when, by whose clock, and what Blank found. Details… shows the signer's certificate and its fingerprint. The time comes from one of two clocks:

  • computer clock: only the signer's computer says so, and it can be set to any time. A time without a time zone is shown as the PDF writes it.
  • timestamped by a server, e.g. timestamped by DigiCert (not checked): a timestamp server vouched for the time. Blank checks that the timestamp belongs to the signature, but not who made it, so it says not checked unless you trust the server's certificate. Your PDF app checks timestamp servers, if you need it.

A signature whose certificate a certificate authority issued shows as Intact · says it's issued by that authority: Blank repeats what the certificate claims. It checks that the PDF hasn't changed since, but it doesn't check certificate authorities or whether a certificate was revoked: your PDF app does that, if you need it.

Trust a certificate ​

To have someone's signatures show as Signed, trust their certificate once:

  1. Open the signature's Details….
  2. Compare all of the Fingerprint, every group, with the one the signer tells you, by phone or in person. If they sign with Blank, they find theirs in Settings ▸ Signing ▸ Fingerprint.
  3. If it's the same, choose Trust this certificate… and confirm.

From then on, their signatures show as Signed in every PDF. Your own certificate is always trusted. Settings ▸ Signing ▸ Trusted certificates lists the ones you trust, where Remove takes one off the list again.