Skip to content

Frequently Asked Questions

1. Where Can I Get Other Tarot Decks?

Arcana Land provides a small number of free tarot decks (as of 2026, four) in our Reference Deck Collection. They are all available for download directly in the Tarot Canvas app.

Because there are only a handful of tarot decks in existence that are verifiably free from copyright claim, we are only able to provide a small sample of decks that are permissively licensed. For other decks, you can create your own by following the next section.

2. How Do I Make My Own Deck?

Creating a Tarot deck consists of putting your card images into a certain folder structure with a TOML file at the top.

This section will walk-through creating a tarot deck step-by-step using KDE Plasma.

Open Dolphin and navigate to ~/.var/app/land.arcana.TarotCanvas/data/tarot/decks. Create a directory called my-tarot-deck (or name it whatever).

Then create a new TOML file called deck.toml and fill it out:

[deck]
schema_version = "2.0"
name = "My Tarot Deck"
author = "Jane Doe"
version = "1.0"
identifier = "com.example/deck/my-tarot-deck"

deck1

For this example, I will be using images from Kathryn Isabelle Lawrence's ascii-tarot.

Place major arcana images in a folder called major_arcana and name them as a two-digit number. For example, The Fool:

00

Place it in major_arcana/00.webp.

deck2

Another example of The World:

21

Place it in major_arcana/21.webp.

deck3

For the minor arcana, create a folder named minor_arcana with subfolders wands, cups, swords, and pentacles. For example:

deck4

Follow the example of minor_arcana/cups/ace.webp and minor_arcana/swords/three.webp for the rest of the cards.

canvas

You should now be able use the canvas view with "My Custom Tarot" selected in the Card Explorer's dropdown. Summoning random cards will then draw from your personal deck.

Tip

Refer to the full Tarot Deck Specification (PDF) for more details about the file and directory format.

Note

I personally scan my decks using an app that I am developing called deckle. It is a command-line tool that handles the scanning, physical jig creation, image cropping, deskeweing and cataloging. It is pre-alpha, but if you are technical and adventurous, it may be of interest.

3. How Do I Add My Own Esoterica?

You can add your own esoterica by manually adding a file with the following format:

[meta]
name = "My Custom Esoterica"
author = "Jane Doe"
identifier = "com.example/esoterica/my-custom-esoterica"

[card."major_arcana.00".passages]
text = "These are my permanent notes for The Fool."

# ... the rest of the Major Arcana ...

[card."major_arcana.21".passages]
text = "These are my permanent notes for The World."

# ... now the Minor Arcana ...

[card."minor_arcana.wands.ace".passages]
text = "These are my permanent notes for the Ace of Wands."

# ...

[card."minor_arcana.cups.ten".passages]
text = "These are my permanent notes for the Ten of Cups."

Save it as a .toml file in the folder at ~/.var/app/land.arcana.TarotCanvas/data/tarot/esoterica/.

Screenshot_20261008_174224-1

Note

See the official Esoterica Specification for the supported fields.