Register

FileSmith

An Add-on Module by Bakshi’s Bazaar

Publisher: Bakshi’s Bazaar Purchase: Publisher Foundry Versions 14+ (Verified 14.370) Last Updated 7 hours, 33 minutes ago

FileSmith

A premium Bakshi’s Bazaar module for Foundry VTT.

FileSmith version 14.4.1 Foundry VTT v14 Requires libWrapper Patreon: Bazaar Patron Discord: Bakshi’s Bazaar

Select a squad’s gear, move it between character sheets, or organize a folder of encounters in one pass.

Preview · Quick Start · Features · Installation · Changelog · Compatibility · API · Free Modules · Roadmap · Community · AI Use · License


Feature Index

Feature What it does
Folder Appearance Give factions, locations, and adventure chapters their own colors and shading.
Multi-Selection Select a handful of entries or a whole range and organize them together.
Gear & Spells on Actor Sheets Check gear or spells on a character or token, move gear between inventories, and review group edits or deletion.
Sheet, Journal & Compendium Drops Equip an actor from the sidebar, insert a list of journal links, or import a selection from a pack.
Folder Drag-and-Drop Move a complete folder tree while keeping everything nested inside it, much like moving folders in Windows.
Clipboard & Organization Copy, cut, paste, duplicate, and tidy up through familiar right-click menus.
Move Undo Put the last FileSmith move back where it started.

GMs organize world directories and packs. Players can select documents they can read and use them on sheets and journal pages they can edit.


Preview

Boris confirms deletion of four checked items, then receives nine selected entries from the Items sidebar

Select four items on Boris’s sheet for deletion, then drag nine entries from the Items sidebar onto his inventory.


Quick Start

  1. Enable FileSmith and libWrapper in your world, then reload.
  2. In a world directory, Ctrl/Cmd-click individual rows or Shift-click a range. Right-click a highlighted row to see how many entries each action affects.
  3. On a standard D&D 5e, Tidy 5e, or PF2e actor sheet, open Inventory, click Select items, and check two pieces of gear. Drag either checked row onto another owned sheet to review the transfer.
  4. To put sidebar entries at the top level, copy or cut them, right-click the blank space below the last row of that directory, and choose Paste to Root.
  5. To reverse a directory move, choose Undo Last Move in the matching directory or press Ctrl/Cmd+Z there.

GMs select with one click and open with a double-click by default. Each world directory has its own opening preference. Players open documents with a normal click.


Features

Folder Appearance

Start with Foundry's folder color, then add a soft wash or mist to document rows. Carry a theme through nested folders and their documents, fade lighter or darker with depth, or blend toward a second color. Folder headers and document rows have independent shading patterns.

Applying colors and shading to folders


Multi-Selection

Ctrl/Cmd-click to pick individual entries, or Shift-click to select a range across folders in the same directory. Players can select documents they can read in a world directory or an open pack. Each GM can choose single-click or double-click opening for their own sidebar.

Right-click a highlighted world document to act on the group. In the example below, Duplicate ×3 makes a copy of each Item in its current folder, Delete ×3 opens one confirmation, and Cut ×3 puts the three originals on the clipboard.

Three highlighted Items in Raider Armory with counted Move to Root, Delete, Duplicate, Copy and Cut actions

Gear & Spells on Actor Sheets

On stock D&D 5e and PF2e character or token sheets, click Select items in the inventory, or Select spells on the spellcasting tab. On Tidy 5e character and NPC sheets, look just below the search and filters on Inventory or Spells. Check individual rows or Shift-click a checkbox for a range. You can switch tabs with the selection active. Item names, rolls, and Cast buttons keep their usual behavior.

Gnoll Features sheet with Spear and Longbow checked and the two-item action bar visible

Give gear to another actor. Drag any checked gear row or the grip onto another owned sheet. The gear goes into the recipient’s inventory even when their Spells tab is open. Drop directly on a bag to put it there. The review names both actors, shows Move or Copy, and lets you choose how much of each stack to transfer. A selected bag carries its contents once.

For example, check Hide Armor and Shield on the SRD Gnoll’s Tidy sheet. Drag the checked Shield onto a standard Minotaur sheet with Spells open. The Minotaur receives both items in Inventory as light armor and a shield. Copy leaves both on the Gnoll. Move removes the quantities you confirmed.

Move gear to Minotaur review, showing one Longbow and one Spear from the Gnoll

Set the transfer rule. Under Configure Settings → FileSmith → World Inventory Rules, choose Automatic, Move, or Copy. An explicit Move or Copy takes priority over Traffick. Automatic normally moves gear. On D&D 5e it follows Traffick’s actor-sheet drag preference when Traffick is active and uses its copy default for open container sheets. When Traffick handles quantities for all drags, FileSmith lets you choose the stacks and Traffick asks for their quantities.

Work in the current inventory. Use Move… to pack or unpack gear, including gear in an open character-owned D&D 5e bag. Choose Actions → Edit… to review quantity and equipment changes. GMs can switch the edit dialog from This inventory to Selected tokens. Linked tokens sharing an actor count once, and the preview lists missing or ambiguous matches.

Duplicate, delete, or link a selection. On D&D 5e, right-click a checked gear or spell row for Duplicate ×2 or Delete ×2 when two items are checked. Both systems also offer Actions → Delete… with a review of names and quantities. Unselected bag contents survive deletion. PF2e shows affected grants and clears prepared slots that reference a deleted spell. D&D items with advancement choices use their individual sheet action. Use Copy links or drag the grip into a journal to link the actor’s own gear or spells.

See the D&D 5e menu for two checked weapons
Gnoll Features sheet with Spear and Longbow selected and Duplicate ×2 and Delete ×2 in the row menu

Finish selecting. Click Done, press Escape, or click blank space or outside the sheet. You can turn off click-away in Selection & Shortcuts. Closing the sheet always clears its selection.


Sheet, Journal & Compendium Drops


Folder Drag-and-Drop

Drop a folder onto another folder to nest it there, onto a document to use that document's folder, or onto the directory background to move it to root. Selected child entries stay inside their selected parent folders during bulk moves.

FileSmith checks for missing entries, incompatible directory types, circular moves, and Foundry's nesting limit before applying a move.

Moving folders while keeping their contents together


Clipboard & Organization

Copy or cut a folder, a document, or a selected group in a world directory. Right-click a destination folder and choose Paste Here. To paste at the top level, right-click the blank space below the last row and choose Paste to Root. This also works in a directory popout. The clipboard accepts the same document type, so copied Items appear as a paste option in the Items directory.

Blank space below the Items directory entries opens a menu with Paste to Root, Create Item and Create Folder

Duplicate Folder copies a complete folder tree with its contents and explicit appearance settings.

You can also Merge Contents Into Parent, which moves a folder's direct contents up one level and removes the emptied folder, while keeping its child folders intact. Move Folder To Root brings a nested folder back to the top.

On supported D&D 5e Item containers, copying a bag also copies its nested contents and preserves their relationships.


Move Undo

Choose FileSmith: Undo Last Move, or press Ctrl+Z / Cmd+Z while the matching directory is focused. FileSmith checks that the entries are still where that move left them before restoring their earlier locations.

Undo remembers one successful FileSmith move across the client. A newer move replaces it, and reloading clears it. Copies and permanent deletion cannot be undone.


More Details

Folder appearance options
  • Document shading: Off, Soft Wash, Mist from Bottom, Mist from Top, Mist from Left, Mist from Right, or Center Mist.
  • Apply appearance to: This folder only, Entire nested tree, or Exclude inherited tree.
  • Nested folder colors: Same color, Fade lighter by depth, Fade darker by depth, or Blend toward another color.
  • Folder shading: Solid Color or one of the wash/mist patterns, independently of document shading.
  • Branch control: an explicit folder appearance or exclusion stops the inherited theme for that branch; a deeper tree theme can start a new one.
  • Shared appearance: only GMs configure it; users see the result on folders already visible to them.
  • Automatic inheritance: colors are calculated when the directory renders, without overwriting descendants' saved folder colors.
Selection & shortcuts
Gesture What it does
Click Select one row in a directory with double-click mode enabled.
Double-click Open a document or expand/collapse a folder in double-click mode.
Ctrl-click / Cmd-click Toggle individual rows in the selection.
Shift-click Select a visible range.
Escape Clear the selection.
Drag a selected row Use the group on a compatible sheet, journal editor, or directory.
Drag an unselected row Use the normal single-row behavior.
Ctrl+Z / Cmd+Z Undo the latest FileSmith move while its matching directory is focused.
Delete / Backspace Open the selected-delete confirmation, when enabled in settings.

Ctrl/Cmd-click and Shift-click selection also work when a directory's double-click setting is off. Search fields, buttons, and other native controls retain their own interaction behavior. Watch the Ctrl/Cmd selection demo or the Shift range demo.

Clipboard & context menus

Right-click a highlighted world document to act on the selection. Right-click an unselected document for its ordinary single-document actions.

  • Folders: Duplicate Folder, Copy this folder, Cut this folder, Merge Contents Into Parent, and Move Folder To Root.
  • Documents: Copy this document and Cut this document.
  • Selected documents: With three documents selected, Duplicate ×3 makes a copy of each in its current folder. Delete ×3 opens one confirmation. Move to Root ×3 appears when at least one selected entry is in a folder. Copy ×3 and Cut ×3 put the group on the clipboard.
  • Folder selections: Use the folder menu to copy, cut, move or delete the selected entries together. A copied folder carries its contents.
  • Destinations: Right-click the blank space below the last row and choose Paste to Root. On a document row, Paste Here uses that document's current folder.
  • History: Undo Last Move when a matching FileSmith move is available.

Clipboard operations use the context menu. The clipboard belongs to the current client session, clears on reload, and pastes only within the same document type. For example, Actors can be pasted into Actor folders, and Items into Item folders.

Deletion, recovery & limits

Deleting a selected group asks for confirmation, defaults to No, and shows the recursive folder and document counts. Deleting a selected folder also deletes its contents. With supported dnd5e containers, the count includes nested Items.

Confirmed deletion is permanent and cannot be undone.

FileSmith verifies operation results and reports blocked or incomplete changes. If part of a bulk operation fails, it attempts to recover changes where safe and reports anything that needs inspection. Recovery is best-effort and undo only covers the last move, so keep world backups.

FileSmith organizes world directories, unlocked world-owned packs, and the Compendium Packs sidebar. Uploaded files stay in Foundry's FilePicker.

Settings

Open Configure Settings → FileSmith. World Inventory Rules apply to players throughout a D&D 5e or PF2e world. The remaining preferences are saved for the current browser or client.

Under Open entries with, choose Single-click, Double-click, or Custom…. Custom lets GMs enable double-click independently for each available directory. Existing mixed preferences open in Custom automatically. Ctrl/Cmd-click and Shift-click selection work in every mode.

Setting Default
Double-click to open, independently for each supported directory On
Enable bulk inventory moves (D&D 5e and PF2e) On
Player bulk gear transfers (world) Pack, unpack, and give between owned inventories
Between-inventory drag behavior (world) Automatic
Player bulk deletion on sheets (world) Owners of editable inventories
Clear selection when clicking away On
Select entries on right-click Off
Show selection count notifications Off
Enable Delete / Backspace shortcut Off
Enable debug logging Off

Right-click selection replaces the current selection when you right-click an unselected entry, and preserves the group when you right-click an already selected entry. The Delete / Backspace shortcut opens a confirmation; it never deletes immediately.

Choose Pack and unpack only to let players organize their own bags, or Off to disable player bulk gear transfers. Players can switch off moves for their own client, and keep selecting and linking items. Choose GMs only to reserve FileSmith’s bulk sheet deletion for GMs.

Automatic moves selected gear between actors by default. With Traffick active on D&D 5e, it follows Move items when dragged for actor-sheet drags and uses Traffick’s copy default for drags from an open container sheet. Choose Move or Copy to set an explicit rule for FileSmith selections. Packing and unpacking within the same inventory always moves the gear.

Folder appearance is saved with the folder and shared with users who can see it; it is separate from these client preferences. Debug logging remains available to all users under Troubleshooting.

Troubleshooting

Confirm that libWrapper and FileSmith are enabled, then reload the client. If drag-and-drop enhancements are unavailable, check that libWrapper loaded successfully.

For more detail, enable FileSmith → Enable debug logging and inspect the browser console for messages prefixed with [FileSmith]. Warnings and errors are logged even with debug logging off.

If another module replaces directory rendering, drag-and-drop, or context menus, reproduce the issue with only FileSmith and libWrapper enabled in a test world.


Installation

  1. Join Bazaar Patron.
  2. Link your Patreon account to your Foundry VTT account.
  3. Install FileSmith through Foundry Premium Content.
  4. Install libWrapper through Add-on Modules → Install Module if it is not already installed.
  5. Open your world, enable both modules in Manage Modules, and reload connected clients.

Your Bazaar Patron membership includes:

Updates install from Foundry's Add-on Modules screen like any other module. Release notes are in the changelog. Updates are also announced in the Bakshi’s Bazaar Discord.

For a manual installation, extract the package so its manifest is at Data/modules/filesmith/module.json, then restart Foundry before enabling the module.

Requirement Version
Foundry VTT v14 only; verified on 14.370
libWrapper Required; tested with 1.13.5.1

Compatibility

Foundry VTT: v14 only; verified on 14.370.

Game systems: folder and document organization works in any system. Container-aware copy and deletion are tested with dnd5e 5.3.3 and 6.0.6 only.

Actor sheets: On Foundry 14.370, gear transfers were tested between standard D&D 5e 6.1.1 and Tidy 5e Sheets 15.0.1 character and NPC sheets, including with Traffick 14.2.1. On standard PF2e 8.6.1 sheets, tests covered dragging several world Items onto characters and NPCs. Other sheets depend on compatible native Item-drop handlers.

Directories: Actors, Items, Journal Entries, Scenes, Roll Tables, and Playlists. Cards and Macros are included when their world collections exist and support folders.

Permissions: players may select readable documents, copy links, drop onto editable sheets and journals, and import document types they can create. GMs manage directory moves, deletion, and folder appearance.

Playlists, compendia & other sidebar modules
  • Playlists: FileSmith organizes playlist folders and Playlist entries. Nested PlaylistSound rows keep their native clicks, context menus, playback controls, and drag-and-drop behavior.
  • Compendia: use one open pack at a time for multi-selection. Folder appearance and the cut/paste clipboard are world-directory tools.
  • Physical assets: image, audio, and other files in the FilePicker are outside FileSmith's scope.
  • Other sidebar modules: modules that replace directory rendering, drag-and-drop, or context menus may bypass FileSmith.

Developer API

FileSmith currently provides its tools through Foundry's native directories, context menus, and Edit Folder form. It does not expose a public game.filesmith API or a supported macro interface.

For integration requests, describe the workflow you want to support in the filesmith channel under behind the counter - patron only on Discord.


Free Modules

I also make free modules. Install them from Foundry's Add-on Modules browser.

Module What it adds
5e Item Importer Turns D&D 5e stat blocks or YAML into Items.
Show of Hands Middle-mouse targeting, marquee selection, and custom shared cursors.
Squad Combat Initiative Runs big dnd5e fights as squads with group initiative, captains, and morale.
The Sound of Silence Internal loops, crossfades, silence gaps, and soundscapes for Foundry playlists.

Roadmap

Planned compendium work. I want to bring counted duplication and deletion, plus Paste to Root, to entries inside a compendium. The first pass will focus on one unlocked, world-owned pack at a time. I will test copying and moving before adding deletion, including what happens if another GM locks the pack or changes which entries would be affected during review.

Future priorities will be shaped by real campaign workflows and reported issues along with any that I feel would be appropriate but Share a feature request on the Discord! with an example of what you are organizing and where the current tools get in your way.


Community

Support is handled through the Bakshi’s Bazaar Discord. Patrons receive priority support, without guaranteed response or resolution times.


AI-Assisted Development

This module is developed and maintained with the help of AI-assisted tools for coding, debugging, and testing.

I care about the quality, behavior, performance, security, and long-term maintainability of this module, and I take full responsibility for what ships. AI assistance does not replace review, testing, debugging, or security and design judgment.

AI is used here as a tool under my direction to make Foundry better and allow for long term mod support while still having a life outside of building and maintaining my free and premium modules.

If you are uncomfortable using software developed with AI-assisted tools, this module is not for you.


⚖️ License & Permissions

Premium License

FileSmith is a paid, premium module. Refer to the license terms supplied with your purchase for usage and redistribution permissions.

Commercial Licensing

For bundling, commercial integrations, or custom feature development, contact me to discuss licensing and permission.

Contact

For licensing inquiries or permission slips:


Author: GnollStack · Compatibility: Foundry VTT v14

⬆ Back to Top

Categories

Available Versions

  1. Version 14.4.1

    7 hours, 33 minutes ago
    Foundry Version 14 - 14 (Verified 14.370) Manifest URL
  2. Version 14.4.0

    10 hours, 37 minutes ago
    Foundry Version 14 - 14 (Verified 14.369) Manifest URL
  3. Version 14.3.6

    2 weeks, 6 days ago
    Foundry Version 14 - 14 (Verified 14.369) Manifest URL
  4. Version 14.3.5

    1 month, 1 week ago
    Foundry Version 14 - 14 (Verified 14.367) Manifest URL
  5. Version 14.3.4

    2 months ago
    Foundry Version 14+ (Verified 14.367) Manifest URL