New on CTAN: runtexshebang
## What is a TeX-style shebang (`%#!`) ? In short, a TeX-style shebang (`%#!`) is a special kind of TeX comment that you include in your TeX/LaTeX document file to tell the operating system's shell how to run the file for the rest of the file: ``` latex %#!lualatex foo.tex \documentclass{article} \begin{document} Hello, {\LaTeX} World! Happy {\TeX}ing. \end{document} ``` You can run the sample file as below: ``` shell runtexshebang foo.tex ``` Then, it will run `lualatex foo.tex`.
The package’s Catalogue entry can be viewed at https://ctan.org/pkg/runtexshebang The package’s files themselves can be inspected at https://mirrors.ctan.org/support/runtexshebang/
Thanks for the upload. For the CTAN Team Petra Rübe-Pugliese
CTAN is run entirely by volunteers and supported by TeX user groups. Please join a user group or donate to one, see https://ctan.org/lugs
RunTeXshebang – A Lua script running LaTeX document files with TeX-style shebang
In short, a TeX-style shebang (%#!) is a special kind of TeX comment that you include in your TeX/LaTeX document file to tell the operating system’s shell how to run the file for the rest of the file:
%#!lualatex foo.tex
\documentclass{article}
\begin{document}
Hello, {\LaTeX} World!
Happy {\TeX}ing.
\end{document}
If you are using a TeX-style shebang, it must appear on the line that matched 20 lines or less in your LaTeX document, and it has to start with a TeX comment symbol (%) followed by a hash sign (#) and an exclamation mark (!), colloquially known as the bang, hence the name shebang for TeX/LaTeX.
runtexshebang executes the %#! line through the system shell, so only use it on documents you trust. It is a build tool invoked by the user and must not be added to shell_escape_commands.
| Package | RunTeXshebang |
| Version | 1.1 2026-10-21 |
| Copyright | 2021–2026 Munehiro Yamamoto |
| Maintainer | Munehiro Yamamoto |