A PDF viewer for the Atari ST, STE, TT and Falcon, written in C for GEM: the text of a document on every machine, and its pages as they were made on the TT and the Falcon. EConvert, which comes with it, prepares PDFs so that EPDF opens them fast, on the Atari itself or through the Gateway.
Highlights
- Every page's text on any Atari, down to a 1 MB ST: the paragraphs joined and wrapped to the window, or each line as it is on the page, with the pictures where they stand. The text is read in the background, a page at a time, while you read; a long document's text goes to a cache file when memory is short.
- Fast on the stock machines: a scroll moves what stays on the screen and draws only what comes in; nothing waits for the reading.
- Modern but Atari: iconify, drag and drop, the desktop's AV protocol, help in EHypView or ST-Guide, the AERA family's look and keys.
- The pages as printed on a TT or Falcon: View > Pages draws each page with its fonts, pictures and drawings, in the screen's colours (16 or 256), from the top down. Zoom with ^+ and ^- (or the keypad's + and -) from 150 to 400 % as memory allows, and drag the page with the mouse; a band on the page says while a sharper one is being drawn. JPEG pictures go through the Falcon's DSP.
- The page strip: View > Page strip shows the pages in a column at the window's left, each its own preview (a PDF converted with EConvert's Page previews, in colour) or its first line; a click goes to the page.
- EConvert: many PDFs or a whole folder made ready for the Atari, on a Falcon or TT or through the Gateway: the text reflowed already, the pictures at the size the screen shows them, and each page whole in mono, colour or both. EPDF opens such a file at once on any Atari and marks its pages Optimised.
- The Gateway (AERA-Gateway on a Raspberry Pi): with Options > Open on the Gateway, a PDF is converted there while you read it; File > Save Optimised... keeps the converted copy.
- Translate: View > Translate shows the text in another language, through the Gateway's translation service.
- Hebrew and other right-to-left text, find, select and copy to the clipboard.
- Encrypted PDFs with an empty user password: RC4 and AES, up to AES-256.
Take the latest release from the Releases page. Its zip holds:
| File | What it is |
|---|---|
EPDF.PRG |
the program, for every ST, STE, TT and Falcon |
RENDER.OVL |
the pages' drawing on a TT or Falcon (View > Pages, zoom), loaded only on a 68020 or better |
EPDF.HYP, EPDF.REF |
the guide, for EHypView or ST-Guide |
NOTICES.TXT |
the licences of the parts EPDF is made with |
icons/EPDF.RSC, EPDF.ICN, EPDFMK.ICN |
the program's desktop icon |
icons/EPDFDOC.RSC |
the icon for PDF files on the desktop |
icons/EPDFNV.RSC, EPDFDNV.RSC |
the same two for NVDI without TOS's palette loaded |
icons/ECONVERT.RSC, ECONVERT.ICN, ECONVMK.ICN |
EConvert's desktop icon (ECONVNV.RSC for NVDI with its own palette) |
econvert/ |
EConvert, which prepares PDFs for EPDF on a Falcon or a TT: ECONVERT.PRG and the fonts it draws with (fonts/) |
- Copy
EPDF.PRGinto a folder of its own, such asC:\EPDF\. It keepsEPDF.INF(its settings),EPDF.TXC(the text of the document open, while it is) and anyCRASH.LOGbeside itself. - On a TT or Falcon, put
RENDER.OVLbesideEPDF.PRG, and the fonts fromeconvert/fontsin aFONTSfolder beside it (or leave EConvert's inECONVERT\FONTS): they draw the pages. - Copy
EPDF.HYPandEPDF.REFintoC:\GUIDES\, or besideEPDF.PRG. Help in EPDF opens them in EHypView or ST-Guide. - To open a PDF with a double-click, install
EPDF.PRGon the desktop as the application forPDFfiles: on TOS 2, 3 and 4 with Options > Install application...; in Thing and Teradesk in their own settings for applications. - The icons: take
EPDF.RSCandEPDFDOC.RSCunder TOS, EmuTOS, MagiC, or NVDI with TOS's palette loaded (COLORVDI.CPX);EPDFNV.RSCandEPDFDNV.RSCunder NVDI with its own palette.EPDFDOCis the icon for*.PDFin the desktop's Install icon....
Needs: any ST, STE, TT or Falcon with 1 MB or more; TOS 1.04 or newer, EmuTOS, MagiC or MiNT, with
or without NVDI; a screen 640 pixels wide or more. The pages as printed and EConvert need a 68030
(TT or Falcon); on a stock 4 MB Falcon the zoom stops at 150 %. EPDF takes about 390 KB when it starts, and more as it reads (the
pages' text up to a quarter of what is free, the rest in EPDF.TXC; a picture's own buffers while
it is decoded): on a 1 MB ST, run it without the family's accessories.
Under TOS, put Atari's FOLDR100.PRG first in AUTO, renamed for more room (FOLDR400.PRG).
TOS keeps an entry in a small internal pool for every folder a program or accessory has looked
into, and halts with "OUT OF INTERNAL MEMORY" when it runs out; FOLDRxxx makes the pool bigger.
EPDF and EConvert work on files. Only in Gateway mode do they use the network: a PDF goes to the
Gateway (AERA-Gateway's pdf service, port 8380, on a Raspberry Pi at home) through STinG,
MiNTnet or MagiC-Net, and the converted PDF comes back (docs/PI-GATEWAY.md). View > Translate
uses the Gateway's translation service the same way. Set the Gateway's address and port in
Options > Settings...; nothing is sent while Gateway mode and Translate are off. EPDF talks to
the Gateway in plain HTTP on the home network; it has no TLS of its own.
sudo apt install gcc-m68k-linux-gnu python3 # Debian/Ubuntu; no MiNTLib needed
make # binary/EPDF.PRG; host tools in build/
make test # unit tests on this computer
make dist # dist/EPDF-x.y.zip, as on the Releases page
make help HCP=/path/to/hcp # EPDF.HYP from docs/GUIDE.md (hcp: common/tools/build-hcp.sh)
make icons # icons/, src/gem/icon*.h and src/econv/icon*.h from common/icons/EPDF.txt, EPDFDOC.txtbinary/ and dist/ are what make builds; they are never committed, and a build changes no tracked
file. A release: tools/bump.py, commit and push, then Actions > Release > Run workflow on main
with what is new. The workflow tests, builds, tags the commit vX.Y and publishes the files and the
zip on the Releases page. Builds in between are never handed out: to try a change, release it.
The measurement run that chose EPDF's design (stage 0) is in docs/MEASUREMENT.md:
make measure on this computer, make measure-atari and tests/hatari/measure.py in Hatari.
src/ the PDF reader (portable C, also built for this computer in the tests)
src/view/ the text view's model: layout, the pages' text store, settings (host-tested)
src/gem/ GEM: the window, the menu, the dialogs, the pictures, the Gateway
src/conv/ the converter (EConvert's and the Gateway's): reflow, pictures, pages whole
src/econv/ EConvert's window
src/rovl/ RENDER.OVL, the pages' drawing on a 68030
gateway/ a read-only copy of AERA-Gateway's services, for the tests
atari/ the stage 0 measuring programs and LAUNCH.PRG for the rigs
tests/ host unit tests and the Hatari rigs (tests/hatari)
tools/ the corpus fetch, the measurement run, the help file, the release bump
docs/ the user guide (GUIDE.md, the source of EPDF.HYP), the measurement report, pictures
icons/ the desktop icons (made by make icons)
third_party/ FreeType and the Liberation fonts (pinned, with their licences)
common/ the shared AERA library (from AERA-Atari; never changed here)
make test runs the host unit tests (the text layout, the page store, the document view, the
settings file, the CCITT decoder) and checks the Atari programs: no FPU instruction in a 68030
build, no word or long at an odd stack offset in the 68000 one.
The Hatari rigs start the family's machines (ST, ST-1, TT, Falcon, Falcon-4) through
common/tools/machines.py:
make gui-test(tests/hatari/gui.py): EPDF opened on a document, scrolled, paged;make speed-test(tests/hatari/speed.py): each action's longest stretch between event calls onSTandFalcon-4, against the guidelines' times;make files-test(tests/hatari/files.py): each file's opens on a 1 MB ST, from Hatari's GEMDOS trace, while a 40-page book is read, paged through and closed: the PDF opened once,EPDF.TXCmade and opened once;tests/hatari/zoom.py,prepared.py,econv.py,econv_speed.py,gateway.py(against the Gateway's ownpdfgate.py) andtranslate_view.py: the pages, converted PDFs, EConvert, the Gateway and translation.
The Falcon of these rigs is Erez's configuration where the machine has the files: a 4 MB Falcon with
TOS 4.04 and NVDI in 256 colours (tests/hatari/erz.py); else the same machine on EmuTOS.
EPDF is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version. It is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See COPYING.
Copyright (C) 2026 AERA | Erez Yaary.
It includes, under their own licences (compatible with the GPL), as NOTICES.TXT lists:
- BearSSL by Thomas Pornin (MD5, SHA-2, AES for encrypted PDFs): MIT licence
- TJpgDec by ChaN (JPEG pictures): its own free licence
- libnsgif from NetSurf (GIF, in the family's picture code): MIT licence
- FreeType, the FreeType Project Licence or the GPL version 2 (the pages' drawing and EConvert)
- Liberation fonts 2.1.5, the SIL Open Font Licence 1.1 (the standard fonts EConvert and the pages' drawing use)
Part of AERA for Atari: ECal · EContact · EMail · EFTP · EHypView · ClaudeST · EWeb · EUpdate · EPDF · 8-bit: EDOS · EFTP_XL · Pi: AERA-Gateway