mtx-context - Man Page

ConTeXt Process Management


mtxrun --script context [ OPTIONS ... ] [ FILENAMES ]


ConTeXt Process Management

Options: Basic


process (one or more) files (default action)


create context formats


use ctx file (process management specification)


ignore ctx directives and flags


use specified user interface (default: en)


close pdf file in viewer and start pdf viewer afterwards


purge files either or not after a run (--pattern=...)


purge all files either or not after a run (--pattern=...)


load the given module or style, normally part of the distribution


load the given environment file first (document styles)


enable given the modes (conditional processing in styles)


also consult the given paths when files are looked for


set variables that can be consulted during a run (key/value pairs)


set the randomseed


rename the resulting output to the given name


set tracker variables (show list with --showtrackers)


set directive variables (show list with --showdirectives)


disable logcatgories (show list with --showlogcategories)


strip Lua code (only meant for production where no errors are expected)


show errors at the end of a run, quit when in list (also when --silent)


generate html error page instead (optional: =scite)


disable logging to the console (logfile only)


don't create a dummy file (can confuse pdf viewers that keep file in view)


purge result file before run


force xml stub


force cld (context lua document) stub


force lua stub (like texlua)


force mp stub


run extra imposition pass, given that the style sets up imposition


ignore imposition specifications in the style


report pagenumbers of names pages and list references (--page=... or --page=...)


use luajittex with jit turned off (only use the faster virtual machine)


use luajittex with jit turned on (in most cases not faster, even slower)


only run once (no multipass data file is produced)


process at most this many times


process this many times (permits for optimization trial runs)


run without stopping and do not show messages on the console


run without stopping


never initializes synctex (for production runs)


run with synctex enabled (better use setupsynctex[state=start])


omit runtime dates in pdf file (optional value: a number (this 1970 offset time) or string "YYYY-MM-DD HH:MM")


forcefully turns off compression in the backend


alternative trailer id (or constant one)


generate file database etc. (as luatools does)


do not descend to .. and ../..


report installed context version


assume given file present elsewhere


use dummy file as jobname

Options: Expert


update context version number (also provide --expert, optionally provide --basepath)


omit runtime statistics at the end of the run


profile job (use: mtxrun --script profile --analyze)


generate timing and statistics overview


keep previous tuc files (jobname-tuc-[run].tmp)


keep previous pdf files (jobname-pdf-keep.tmp)


keep previous log files (jobname-log-[run].tmp)


force lmtx mode (when available)


enable csname overload checking


process extra (mtx-context-... in distribution)


show extras


encrypt the (pdf) file using this master password


use an additional password for opening the document


list of: print, modify, extract, add, fillin, assemble, quality

Options: Special


process file with texexec using pdftex


process file with texexec using xetex


process file with texexec


do not check for file and enter scroll mode (--dummyfile=whatever.tmp)


process file in a limited environment


prepend the (found) binarypath to runners


More information about ConTeXt and the tools that come with it can be found at:

maillist: /

webpage: /


Referenced By

The man page context(1) is an alias of mtx-context(1).

01-01-2023 version 1.04 ConTeXt Process Management