This module improves support for reading and interacting with PDF files in Emacs.
It uses pdf-tools, which is a replacement for the built-in
PDF files. The key difference being pages are not pre-rendered, but instead
rendered on-demand and stored in memory; a much faster approach, especially for
See pdf-tools’ project website for details and videos.
This module has no dedicated maintainers. Become a maintainer?
1.2. Module flags
This module has no flags.
- Added out-of-the-box support for HiDPI or Retina displays.
This module requires epdfinfo, a program the the pdf-tools plugin will build automatically when you open your first pdf file, unless you’re on Windows. Windows users must build it themselves.
2.1. Building epdfinfo on Windows
- Install MSYS2 and update the package database and core packages using the instructions provided.
Update and install dependencies, skipping any you already have:
Install PDF tools in Emacs, but do not try to compile the server. Instead, get a separate copy of the source somewhere else:
- Open mingw64 shell (Note: You must use mingw64.exe and not msys2.exe).
# Cask requires python2 (important: not 3!) $ pacman -S python2 # Make the mingw-shell aware of your python installation. Adjust the path if # Emacs is installed elsewhere! $ export PATH="/c/Program Files (x86)/Emacs/bin/:$PATH" # Cask needs to know where git.exe is; change this path if git is installed # elsewhere! $ export PATH="/c/Program Files/Git/bin:$PATH" # Install cask. Certificate errors can be ignored with (unsafe) -k option. $ curl -fsSL https://raw.githubusercontent.com/cask/cask/master/go | python # Make sure the build process can see cask $ export PATH="$HOME/.cask/bin:$PATH" $ cd /path/to/pdf-tools $ make -s
- This should produce a file server/epdfinfo.exe. Copy this file into the ~/.emacs.d/.local/straight/build/pdf-tools/.
- Start Emacs.
- Open a pdf file (or run
- Test it out:
3. TODO Usage
This module has no usage documentation yet. Write some?
4. TODO Configuration
This module has no configuration documentation yet. Write some?
5. TODO Troubleshooting
There are no known problems with this module. Report one?
6. TODO Appendix
This module has no appendix yet. Write one?