Mercurial > hgrepos > Python2 > PyMuPDF
comparison mupdf-source/docs/guide/install.md @ 2:b50eed0cc0ef upstream
ADD: MuPDF v1.26.7: the MuPDF source as downloaded by a default build of PyMuPDF 1.26.4.
The directory name has changed: no version number in the expanded directory now.
| author | Franz Glasner <fzglas.hg@dom66.de> |
|---|---|
| date | Mon, 15 Sep 2025 11:43:07 +0200 |
| parents | |
| children |
comparison
equal
deleted
inserted
replaced
| 1:1d09e1dec1d9 | 2:b50eed0cc0ef |
|---|---|
| 1 # Installing | |
| 2 | |
| 3 ## Download | |
| 4 | |
| 5 Either [download a release](https://mupdf.com/releases) or clone the latest | |
| 6 source from the Git repository: | |
| 7 | |
| 8 git clone --recursive git://git.ghostscript.com/mupdf.git | |
| 9 | |
| 10 ## Build on Windows | |
| 11 | |
| 12 For Windows use the Visual Studio solution file in `platform/win32/mupdf.sln`. | |
| 13 | |
| 14 ## Build on MacOS | |
| 15 | |
| 16 MacOS should be buildable in the same way as for Linux, but the exact set of | |
| 17 required libraries may vary. No viewer option is available as standard. | |
| 18 | |
| 19 ## Build on Linux (and BSD and macOS) | |
| 20 | |
| 21 Use the GNU makefile to build on Linux or the BSDs. | |
| 22 | |
| 23 make | |
| 24 | |
| 25 The viewers require the X11 (and OpenGL for mupdf-gl) headers and libraries to build. | |
| 26 Install these packages (the exact package names may vary depending on your distro of choice): | |
| 27 | |
| 28 sudo apt install xorg-dev libxcursor-dev libxrandr-dev libxinerama-dev | |
| 29 sudo apt install mesa-common-dev libgl1-mesa-dev packages libglu1-mesa-dev | |
| 30 | |
| 31 Alternatively, if you only want to build the MuPDF library command line tools: | |
| 32 | |
| 33 make tools | |
| 34 | |
| 35 ## Testing the build | |
| 36 | |
| 37 The steps above will put the libraries and binaries in the `build/release/` directory. | |
| 38 | |
| 39 The tools and viewers are portable executables that don't need any auxiliary | |
| 40 files, so can be run from anywhere. To make sure that everything works, you can | |
| 41 run them directly from the build directory: | |
| 42 | |
| 43 ./build/release/mutool -v | |
| 44 | |
| 45 ## Install on Linux | |
| 46 | |
| 47 You can safely copy the binaries to any directory in your path. | |
| 48 | |
| 49 cp ./build/release/mutool ~/.local/bin/mutool | |
| 50 | |
| 51 Or, if you prefer you can install the binaries, libraries, and headers system wide: | |
| 52 | |
| 53 make prefix=/usr/local install | |
| 54 | |
| 55 Good luck! |