FVTT Journal Exporter (Module)

A companion module for Foundry Virtual Tabletop that exports Journals (single or folders) into a structured ZIP format compatible with the FVTT Journal → PDF Desktop App. This allows Game Masters to convert their in-game lore, handouts, and campaign notes into polished, printable PDFs with a clickable table of contents, bookmarks, and preserved formatting.

✨ Features

• 📦 One-click Journal Export

  • Export a single Journal Entry or an entire Journal Folder.

• 🗂 Structured ZIP Output

  • Automatically generates the correct manifest and journal JSON files expected by the desktop converter.

• 🖼 Image Support

  • Preserves embedded images (PNG, WebP, SVG, etc.).

• 📑 Hierarchy Preservation

  • Maintains page structure and headings for proper Table of Contents generation in the PDF app.

• ⚡ Fast & System-Agnostic

  • Works with any Foundry system (5e, PF2e, homebrew, etc.).

• 🎯 Simple GM Workflow

  • Designed for minimal clicks and zero configuration.

🧩 Compatibility

• Foundry VTT: v13+
• Systems: Any (system-agnostic)
• Requires: No external Foundry dependencies

📥 Installation

Method 1 — Manifest URL (Recommended)

1. Open Foundry VTT.
2. Go to Add-on Modules.
3. Click Install Module.
4. Paste the module manifest URL.
5. Click Install.
6. Enable the module in your World.

Method 2 — Manual Install

1. Download the module ZIP.
2. Extract into your Foundry Data/modules/ directory.
3. Restart Foundry.
4. Enable the module in your World.

🚀 How to Use

Export a Single Journal

1. Open the Journal Tab.
2. Open the Journal.
3. Select In the upper right corner of the journal window.
4. A .zip file will be created and automatically downloaded to your downloads folder.

Export a Folder of Journals

1. CLick the button in the top of the journals tab.

2. Select Export Folder for PDF App.

3. Click Export. Download will start automatically and the downloaded ZIP will be in your downloads folder.

4. The module generates a structured ZIP containing:

   • manifest.json
   • /journals/ directory with journal data

🖥 Using With the Desktop App

Get the App HERE

1. Launch the FVTT Journal → PDF desktop application.
2. Select the exported ZIP file.
3. Configure options if desired.
4. Click Generate PDF.

That’s it — your Foundry journals become a fully formatted PDF.

📁 Output Structure

Single Journal Export:

journal.zip
└── journal.json

Folder Export:

journals.zip
├── manifest.json
└── journals/
    ├── journal1.json
    ├── journal2.json
    └── ...

🔒 Permissions

• Only Game Masters can export journals.
• Players are unaffected by this module.

🧠 Design Goals

• Zero setup required
• Reliable exports
• Future-proof structure
• Compatibility with large campaigns

🐞 Troubleshooting

Export option not appearing?

• Ensure the module is enabled in the world.
• Confirm you are logged in as GM.
• Refresh the browser (Ctrl+F5).

Desktop app won’t load the ZIP?

• Make sure you exported using this module (not manually zipped).
• Re-export and try again.

🔮 Roadmap

Planned or possible future enhancements:

• Batch export multiple folders at once
• Automatic PDF launch after export
• Export presets
• Foundry compendium export support

❤️ Credits

Created for the Foundry VTT community to bridge the gap between in-game content and printable campaign materials.

📜 License

This project is licensed under the Apache License 2.0 — see the LICENSE file for details.

☕ Support

If you find this useful, consider supporting development or sharing feedback with the community!