Mass Import

Mass Import streamlines your world-building process in Foundry VTT. It allows you to select a local folder containing images, videos, or PDFs and automatically converts them into Foundry entities such as Scenes, Journals, or Card Decks.

Stop dragging and dropping files one by one—import entire collections in seconds.

🚀 Key Features

🗺️ Scene Importer

Turn a folder of map images into configured Scenes instantly.

• Bulk Creation: Creates one Scene for each image in the folder.
• Configuration: Set grid type, size, background color, and token vision settings once, and apply them to all imported scenes.

🃏 Deck Importer

Perfect for custom tarot decks, playing cards, or item cards.

• Automatic Decks: Reads a folder of images and creates a fully populated Card Deck.
• Custom Backs: Select a specific image to serve as the card back for the entire deck.

📖 Journal Importer

The most versatile tool for lore, handouts, and assets. Now features Smart Persistence (remembers your last settings) and Strict File Filtering (only imports the correct file type for the selected mode).

• Image Handling:
  • Images as image page in one journal: Creates a single journal with one image entry per page.
  • Image to page image in one journal: Creates a separate Journal Entry for each image file.
  • Image to one text page in one journal: Embeds images vertically into standard text pages.
  • All images in one text page: Stacks all images in a single text page.
  • All images in one text page side by side: Creates a responsive, grid-based gallery of all images on a single line/page (Flex Layout).
• PDF Support:
  • PDFs: convert to journal pages: Bulk import PDFs as individual journal pages.
• Video Support:
  • One video to one video page in one journal: Import videos as native video pages with autoplay/loop options.
  • All videos to one text page in one journal: Embeds all videos into a single text gallery.

📦 Installation

1. Open Foundry VTT and go to the Add-on Modules tab.
2. Click Install Module.
3. Paste the Manifest URL:

   https://raw.githubusercontent.com/brunocalado/mass-import/main/module.json

4. Click Install.

🛠️ How to Use

1. Using the Launcher (Recommended)

This module includes a Macros - Mass Import compendium with ready-to-use macros.

Alternatively, create a script macro with this simple command to open the launcher menu:

MassImport.showImporters();

2. Using the API

You can also call the importers directly via the browser console or your own scripts using the global MassImport object:

MassImport.scene(); // Opens Scene Importer 

MassImport.journal(); // Opens Journal Importer

 MassImport.deck(); // Opens Deck Importer

🧰 Included Macros

Check the Macros - Mass Import compendium for these additional utilities:

• Regenerate Thumbnails: Allows you to quickly regenerate thumbnails for imported scenes.
• Universal Scene Rescaler: Batch updates the Grid Distance, Grid Units, Light radius, and Sound radius for the current scene in a single click.

🤝 Community & Support

• Suggestions: Have an idea to improve this module? Share it here!
• Bug Reports: Found an issue? Report it here!

📜 License

This module is licensed under the MIT License.