Clone wiki

terbium / Home

Terbium Logo

Terbium is a small Python application that turns a directory structure of image and media files into a web-browseable gallery. It generates .html files in a self-contained hierarchy, which makes it a good candidate for browseable CD/DVDs of images and media files, or for online hosted galleries that do not need fancy validation, authentication or access patterns.

The default templates and stylesheet are intended to be lightweight but usable. They make use of some Javascript, but should run on even a low-end graphical browser.

The current released version is 0.5.

Key Features

  • generates static HTML files. No PHP/Python/Perl/CGI or binary executables needed beyond a web browser and (for hosted galleries) a web server capable of serving static files.
  • performs the minimal set of necessary rebuilding; when run against an already-existing output directory, it determines what has changed and only updates the appropriate files.
  • quick regeneration of HTML files, with low (and linear) memory requirements.
  • minimal external dependencies.
  • flexible templating mechanism using Jinja2.
  • Application is pure Python (some optional shell scripts exist).

Using Terbium

There's a Quick Start page for the minimal usage case, as well as more detailed documentation for more complicated usage.

There's also a FAQ.

There's a sample gallery showing off some of the key features.

Installable .egg files and tarballs are at Downloads.

Discussion and Support

Discussion and announcements occur on the Terbium mailing lists. The terbium-users list is also available for support questions, but check the FAQ first!


see backstory.

Future Goals

see Roadmap.


Terbium is made available under the terms of the GNU General Public License v3 See the license for details.


For now, please report bugs or issues to the terbium-users mailing list (see #20).

Source Code

See Source