`extractbb-lua` =============== A reimplementation of [`extractbb`](https://texdoc.org/serve/extractbb/0), written in Lua. Variants -------- There are two variants of `extractbb-lua`: - **`wrapper`**: A wrapper script around the original `xdvipdmfx`-based `extractbb` that is used to fix a security vulernability in `xdvipdfmx`. - **`scratch`**: A standalone implementation of `extractbb`, written in Lua from scratch, with no dependencies on `xdvipdfmx`. Currently, the script `extractbb` defaults to the `wrapper` variant, but you can manually select any specific variant by setting the `TEXLIVE_EXTRACTBB` environment variable to either `wrapper` or `scratch`. > [!WARNING] > The `scratch` variant is still in development and may be buggy or > insecure. ### Secret Developer Options If you set `TEXLIVE_EXTRACTBB` to the full path of an executable, it will run that directly. And if you set `TEXLIVE_EXTRACTBB_UNSAFE=unsafe`, then it will ignore some of the security checks. Support ------- If you have any problems with this tool, please report it (in order of preference): 1. By [opening a new issue on GitHub](https://github.com/gucci-on-fleek/extractbb/issues/new). 2. Via email to the public [`tex-live@tug.org` mailing list](https://tug.org/mailman/listinfo/tex-live). 3. By contacting the author directly at `tex@maxchernoff.ca`. Building -------- Please see the file [`documentation/BUILDING.md`](https://github.com/gucci-on-fleek/extractbb/blob/master/documentation/BUILDING.md) on GitHub. Licence ------- `extractbb-lua` is licensed under the [_Mozilla Public License_, version 2.0](https://www.mozilla.org/en-US/MPL/2.0/) or greater. The documentation is additionally licensed under [CC-BY-SA, version 4.0](https://creativecommons.org/licenses/by-sa/4.0/legalcode) or greater. The test files have various licences, please see the file [`tests/LICENCE.md`](tests/LICENCE.md) for more information. (Since these files are not distributed with the package, neither is this licence file.) --- _v1.0.5 (2024-11-21)_