FileSmith
A premium Bakshi’s Bazaar module for Foundry VTT.
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
Select four items on Boris’s sheet for deletion, then drag nine entries from the Items sidebar onto his inventory.
Quick Start
- Enable FileSmith and libWrapper in your world, then reload.
- 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.
- 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.
- 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.
- 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.
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.
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.
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.
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.
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
- Equip an actor from the sidebar. Select individual Items and drag a selected row onto an editable actor sheet. The drag shows the count. The receiving sheet handles each Item using its usual rules for equipment, containers, and spells. On PF2e, Ctrl/Cmd-click gear in the world Items directory, then drag any highlighted row onto the actor. The whole selection goes into the inventory even when Spellcasting is open. Drop directly onto a backpack to put the items inside. The originals stay in the world directory.
- Build a journal list. Drop selected documents into a rich-text journal page in edit mode for one linked bullet per document, in sidebar order. One editor Undo removes the list. FileSmith: Copy as Links also puts one labeled UUID link per line on the clipboard.
- Import from a pack. Select individual documents in a readable compendium, then use FileSmith: Import Selected or drag them into the matching world directory. Choose a destination folder. Existing visible copies with the same source are skipped unless you choose Create additional copies. Importing requires permission to create that document type.
- Organize packs. GMs can move entries and folder trees inside an unlocked, world-owned pack. In the Compendium Packs sidebar, dragging packs and folders changes their placement and preserves each pack’s lock. Use Undo Last Move in the matching directory.
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.
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.
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
- Join Bazaar Patron.
- Link your Patreon account to your Foundry VTT account.
- Install FileSmith through Foundry Premium Content.
- Install libWrapper through Add-on Modules → Install Module if it is not already installed.
- Open your world, enable both modules in Manage Modules, and reload connected clients.
Your Bazaar Patron membership includes:
- Every Bakshi’s Bazaar premium module while your membership is active, including ongoing updates and new modules as they’re added.
- Patron-only channels in the Bakshi’s Bazaar Discord.
- Priority module support.
- A direct place to share feedback and feature suggestions. Suggestions are welcome and taken seriously, but development priorities remain at my discretion.
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.
- Report bugs — Report on Discord in filesmith, under behind the counter - patron only. Include your Foundry version, FileSmith version, game system and version, steps to reproduce, console logs, and screenshots or short clips when useful.
- Request features — tell me what you were trying to organize and what you wish the module could do.
- Follow updates — check the Bakshi’s Bazaar Discord for changes and compatibility notes.
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:
- Discord:
GnollStack(Preferred) - Email:
Somedudeed@gmail.com - Please use Discord or email for commercial licensing discussions rather than GitHub Issues.
Author: GnollStack · Compatibility: Foundry VTT v14






