Skip to content

GCD SQLite Setup

The Grand Comics Database (GCD) publishes a full SQLite dump of its data. Download it once, point CLU at the file, and you have a fast, offline metadata source for bulk-tagging your collection.

1. Download the SQLite dump

You'll need a free account at the Grand Comics Database (comics.org).

Once you're registered and logged in, visit https://www.comics.org/download/ and:

  • Select Private Use
  • Download the SQLite version of the dump

It's a large file

The GCD dump is large (roughly 6 GB). CLU reads it directly from disk — it is never uploaded — so put it somewhere with room to spare.

2. Place the file where CLU can reach it

Extract the download and move the .db file to a location that is mapped into your CLU container. For example, if you map /config in your Docker setup, drop the file at /config/gcd.db.

3. Configure the provider

In Settings → Metadata Providers, find the Grand Comics Database card and enter the full path to the file in the Database Path field (e.g. /config/gcd.db).

Click Save , then Test . On success you'll see a green Connected badge, and the card footer shows live counts from the database (series, issues, stories, publishers, creators).

Docker / headless alternative

Instead of entering the path in the UI, you can set the GCD_DATABASE_PATH environment variable on your CLU container. Saved credentials take priority; the environment variable is the fallback.

Missing tables

If the dump is missing tables, the provider footer warns you — credits and characters may be incomplete, or (for core tables) series/issue lookups may fail entirely. Re-download from comics.org if you see this.

Metadata Languages (optional)

The GCD contains entries in many languages. Use the Metadata Languages field on the provider card to restrict lookups to the languages you want, as a comma-separated list of codes (e.g. en,es,fr). The default is en. Click Save next to the field after changing it.

4. Enable it for your libraries

Enable the GCD provider for the libraries where you want to use it, and set its priority relative to your other providers.

For usage while browsing, see File Management → Adding Metadata.