# Moloch <a href="https://moloch.ink"><img src="https://github.com/jolars/moloch/raw/main/assets/moloch-logo.svg" align="right" width="140" /></a>

[![CTAN](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fctan.org%2Fjson%2F2.0%2Fpkg%2Fmoloch&query=%24.version.number&logo=latex&label=CTAN)](https://ctan.org/pkg/moloch)
[![Build-and-Test](https://github.com/jolars/moloch/actions/workflows/build-and-test.yml/badge.svg)](https://github.com/jolars/moloch/actions/workflows/build-and-test.yml)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.17203438.svg)](https://doi.org/10.5281/zenodo.17203438)

Moloch is a minimalist, feature-rich Beamer theme. It combines a clean, modern
design with extensive customization options to tailor your slides to your needs.

Moloch is a fork of the [Metropolis Theme](https://github.com/matze/mtheme) and
was created for the following reasons:

- To fix some outstanding issues that had not been addressed for a long time.
- To remove some of the more opinionated design choices, such as special
  handling of the Fira family of fonts.
- To strip away some features that added complexity to the code base without
  achieving valuable functionality for the majority of users.

Please check out [the documentation](https://moloch.ink) for more information on
how to use the theme. If you're interested, there is also [a blog
post](https://jolars.co/blog/2024-05-30-moloch/) in which I introduce the theme
and write in more detail about the changes with respect to Metropolis. Finally,
please join us on [Matrix](https://matrix.to/#/#texlive-pkg-moloch:matrix.org)
if you have any questions or want to discuss the theme.

Do not expect this theme to be backwards compatible with the Metropolis theme.

![Screenshot](https://raw.githubusercontent.com/jolars/moloch/main/docs/images/example-demo.png)

## Installation

Moloch is on [CTAN](https://ctan.org/pkg/moloch), so you can install it using
your favorite LaTeX package manager. For example, with `tlmgr`:

```bash
tlmgr install moloch
```

You can also install the theme from source, in which case you need a working
LaTeX installation with `l3build` installed. Then just follow these steps:

```bash
git clone https://github.com/jolars/moloch.git
cd moloch
l3build install
```

## Usage

The following code shows a minimal example of a Beamer presentation using
Moloch.

```latex
\documentclass{beamer}

\usetheme{moloch}

\title{A minimal example}
\author{Johan Larsson}
\institute{Centre for Modern Beamer Themes}
\date{\today}

\begin{document}
  \maketitle

  \section{First Section}

  \begin{frame}{First Frame}
    Hello, world!
  \end{frame}
\end{document}
```

## License

The theme itself is licensed under a [Creative Commons Attribution-ShareAlike
4.0 International License](http://creativecommons.org/licenses/by-sa/4.0/). This
means that if you change the theme and re-distribute it, you *must* retain the
copyright notice header and license it under the same CC-BY-SA license. This
does not affect the presentation that you create with the theme.

## Contributing

Contributions are welcome, but we are generally not interested in changes that
can be easily added through the standard Beamer interface.

Also, when writing commit messages, please use the [conventional commits
format](https://www.conventionalcommits.org/en/v1.0.0/).

## Versioning

The project uses [semantic versioning](https://semver.org).

## Citation

In the off chance that you want to cite Moloch in an academic publication,
please use the following BibTeX entry:

```bibtex
@article{larsson2026,
  title         = {Moloch: A Minimalist, Feature-Rich {{Beamer}} Theme},
  author        = {Larsson, Johan and {samcarter}},
  volume        = {47},
  number        = {145},
  pages         = {67--74},
  doi           = {10.47397/tb/47-1/tb145larsson-moloch},
  issn          = {0896-3207},
  url           = {https://tug.org/TUGboat/tb47-1/tb145larsson-moloch.pdf},
  date          = {2026},
  journaltitle  = {TUGboat}
}
```

## Acknowledgments

Much of **Moloch** is the result of [Mathias
Vogelgesang's](https://github.com/matze) hard work on the **Metropolis theme**
(of which **Moloch** is a fork).

Thanks to [samcarter](https://github.com/samcarter) for the logo!