Files
novelWriter/setup

Build and Install novelWriter

The root folder of the repository contains two scripts for setup and install:

Script setup.py

The setup.py is a standard Python setup script with a couple of additional options:

General

help Print the help message

pip Install all package dependencies for novelWriter using pip.

clean Will attempt to delete the build and dist folders.

Additional Builds

qthelp Build the help documentation for use with the Qt Assistant. Run before install to have local help enable in the the installed version

sample Build the sample project as a zip file. Run before install to enable creating sample projects in the in-app New Project Wizard.

Python Packaging

pack-pyz Creates a pyz package in a folder with all dependencies using the zipapp tool. This option is intended for Windows deployment.

freeze Freeze the package and produces a folder with all dependencies using the pyinstaller tool. This option is not designed for a specific OS.

onefile Build a standalone executable with all dependencies bundled using the pyinstaller tool. Implies freeze, cannot be used with setup-exe

General Installers

install Installs novelWriter to the system's Python install location. Run as root or with sudo for system-wide install, or as user for single user install.

xdg-install Install launcher and icons for freedesktop systems. Run as root or with sudo for system-wide install, or as user for single user install.

Windows Installers

setup-exe Build a Windows installer from a pyinstaller freeze package using Inno Setup. This option automatically disables onefile.

setup-pyz Build a Windows installer from a zipapp package using Inno Setup.