Contribute to SumatraPDF

SumatraPDF is an open-source, collaborative project. We always welcome new developers who want to join the project, contribute code and new features.

Getting the sources and compiling #

You’ll need latest Visual Studio. A free Community edition will work.

Get the sources from https://github.com/sumatrapdfreader/sumatrapdf

Open vs2022/SumatraPDF.sln compile and run.

Contribute to SumatraPDF #

We use a standard GitHub model:

fork https://github.com/sumatrapdfreader/sumatrapdf
submit pull request
I’ll review the code, provide the feedback and merge it when it’s ready

Before you start working on a significant addition, it’s a good idea to first discuss it in issue tracker.

Bug reports? Feature requests? Questions? #

You can use issue tracker for development related topics or forums for general topics.

Info for new developers #

Info to orient new developers to Sumatra code base.

You should install bun.

Many tasks are automated with bun scripts in cmd/ directory.

To build, use Visual Studio 2022 and open vs2022\SumatraPDF.sln solution. Look at different targets and configurations.

Don’t edit the solution directly. To learn how to make changes (add files, change compilation flags etc.) see info about build system.

We use GitHub Actions for a CI system. See .github directory. Most importantly it builds a 64-bit release version on every checkin to catch build errors.

Overview of the directories:

src : main Sumatra code
mupdf : library used to parse / render PDF files (from https://mupdf.com/)
ext : other third-party libraries (some are needed for mupdf, some for Sumatra code)
cmd : bun scripts that automates common tasks