Feature Index

FileSmith helps you organize Actors, Items, Journal Entries, Playlists, and other world content directly in Foundry's sidebar. Uploaded image and audio files stay in Foundry's FilePicker. GMs organize the content; players see folder styling on folders they already have permission to view.

Preview

Features

Folder Appearance

Make a busy sidebar easier to read at a glance.

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

Organize a whole encounter's worth of entries in one pass.

FileSmith lets you move or delete several folders and documents at once.

Select folders and documents together with familiar click, Ctrl/Cmd-click, and Shift-click gestures. Drag an already-selected row to move the group, or use Copy Selected, Cut Selected, and Move Selected To Root from its context menu.

Selection is GM-only and stays within one directory at a time, including entries in different folders. Each directory has its own double-click setting, so you can keep click-to-select where you want it and restore Foundry's normal one-click behavior elsewhere if needed.

Folder Drag-and-Drop

Move the folder and keep its contents together.

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

Keep the useful parts of a file manager in your right-click menu.

Copy or cut a folder, document, or selected group, then paste into another folder of the same document type. Duplicate Folder copies a complete folder tree, including 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.

With dnd5e 5.3.3, copying an Item container also copies its nested contents and preserves their relationships in the new copy.

Move Undo

Recover from the last misplaced drag or folder move.

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.

Installation

1. FileSmith uses Foundry's premium content system through my Patreon: Bazaar Patron. I'm still finalizing the access setup and will add the exact activation and installation steps here once it's ready.
2. Install libWrapper through Foundry's Add-on Modules → Install Module screen if it is not already installed.
3. Once FileSmith is installed, open your world, enable both modules in Manage Modules, and reload connected clients.

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

Compatibility

Foundry VTT: v14 required; verified on 14.367.

Recorded testing: FileSmith 14.3.3 was tested with libWrapper 1.13.5.1 and dnd5e 5.3.3.

Game systems: normal world-folder and document organization is system-agnostic. Content-aware Item-container copy and deletion are verified with dnd5e 5.3.3; that does not establish container support for every system.

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

Permissions: selection, organization actions, and appearance configuration are GM-only. Players retain Foundry's normal interactions and see static appearance on folders they already have permission to view.

Roadmap

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

• 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 — watch the repo 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 GnollStack to discuss licensing and permission.

Contact

For licensing inquiries or permission slips:

• Discord: GnollStack (Preferred)
• Email: [email protected]
• Please use Discord or email for commercial licensing discussions rather than GitHub Issues.