Auto-Wall is a powerful tool for processing battle maps for virtual tabletop games. It automatically detects walls, obstacles, and lights in your maps and converts them into VTT-compatible wall data.
Watch the video:
- Switched to UVTT format: Full compatibility with FoundryVTT, Roll20, Arkenforge, Fantasy Grounds, and more.
- Edit Walls Mode: Added a new mode for editing walls, doors, and lights.
- Doors: Doors can now be manually drawn in the wall editing mode.
- Lights: Lights have their own detection settings and can be added to your maps.
- Improved UI: Button names have been updated for clarity.
- Drawing Improvements: Hold
Controlwhile drawing walls or doors to create a continuous line.
- FoundryVTT: Use the Universal Battlemap Importer by Moo Man.
- Roll20: Use the UniversalVTTImporter by The Aaron.
- Arkenforge & Fantasy Grounds: Both platforms support UVTT files natively—simply import your exported file.
- Edge Detection: Automatically finds walls using edge detection algorithms
- Color-Based Detection: Extract walls based on specific colors
- Adjustable Detection Parameters: Fine-tune detection sensitivity and results
- High-Resolution Processing: Option to process at full resolution for more accurate results
- Light Detection: Dedicated settings for detecting lights (currently not saved in presets)
- Door Drawing: Manually add doors in edit mode
- Interactive Deletion: Click to remove unwanted walls
- Color Picking: Extract colors directly from the map for better detection
- Mask Editing: Draw or erase walls manually with various drawing tools
- Wall Thinning: Automatically reduce wall thickness for cleaner results
- Contour Merging: Connect and simplify wall segments
- Edit Walls Mode: Draw, erase, and modify walls, doors, and lights
- Save as UVTT: Export maps and wall data in the Universal VTT (UVTT) format, compatible with many virtual tabletops.
- Workflow: Export your map as UVTT from Auto-Wall, then follow the instructions for your VTT of choice to import walls, doors, lights, and map images.
- Download the latest release from autowallvtt.com or the Releases page
- Run
Auto-Wall.exe
-
Clone the repository:
git clone https://github.com/ThreeHats/auto-wall.git -
Install dependencies:
cd auto-wall pip install -r requirements.txt -
Run the application:
python auto_wall.py
- Open an image: Click "Open Image" or "Load from URL" to import your battle map
- Navigate the view: Use scroll wheel to zoom, right-click and drag to pan
- Pick detection mode:
- For maps with clear lines, use edge detection (default)
- For maps with distinct colors for the walls or background, enable "Color Detection" and select colors
- Fine-tune results: Use the sliders to adjust detection sensitivity
- Clean up walls: Switch to "Edit Walls" mode to delete, draw, or modify walls, doors, and lights
- Manual drawing: Click "Start Drawing", and use the drawing tools to make any final adjustments
- Generate walls: Click "Generate Walls", adjust your settings, and click "Ok"
- Clean up walls: After generating walls, you can delete, draw, or modify walls, doors, and lights
- Export to UVTT: Click "Save File" to save your newly walled and lit map to a .uvtt file
Best for maps with clear wall lines:
- Edge Sensitivity & Edge Threshold: Controls edge detection precision - higher sensitivity finds more edges, higher threshold filters out noise
- Min Area: Filter out small artifacts
- Smoothing: Reduce noise (higher values = more smoothing)
- Edge Margin: Exclude detection near image edges
Best for maps with distinct colors for the walls or background:
- Enable "Color Detection"
- Add colors by:
- Clicking "Add Color" and selecting from color picker
- Using "Color Pick" mode to select colors directly from the image
- Adjust threshold for each color to control matching sensitivity
- Adjust light detection settings to automatically find light sources on your map (settings not yet saved in presets).
- Draw, erase, and modify walls, doors, and lights
- Hold
Controlwhile drawing to create continuous lines
- Click on walls to remove them
- Drag to select and delete multiple walls
Edit the "baked" mask layer:
- Draw/Erase: Toggle between adding and removing walls
- Brush Size: Control the size of your editing tool
- Tools: Choose between brush, line, rectangle, circle, ellipse, or fill tool
Reduces wall thickness:
- Select thick walls to thin them
- Adjust target width and iteration count for desired results
-
Click "Export to UVTT"
-
Configure export settings:
- Simplification Tolerance: Controls how much wall details are simplified (0 = full detail)
- Maximum Wall Segment Length: Limits how long each wall segment can be
- Maximum Number of Generation Points: Caps the total number of generated points for performance
- Point Merge Distance: Connects nearby wall endpoints to fix gaps and lessen the number of walls
- Angle Tolerance: Determines when walls at different angles should merge
- Maximum Straight Gap to Connect: Maximum distance to bridge between straight nearby walls
- Grid Snapping: Optional alignment to a grid for precise positioning
-
Preview the results
-
Save or copy the UVTT file
To create an executable:
- Ensure PyInstaller is installed:
pip install pyinstaller - Run the build script:
build.py - Find the executable in the
distfolder
Contributions are welcome! Please feel free to:
- Report bugs and request features using the issue tracker
- Submit pull requests with fixes and improvements
- Suggest new detection algorithms or optimizations
Auto-Wall is licensed under the MIT License. See LICENSE for details.
- Uses OpenCV for image processing
- Uses scikit-learn for color clustering
- Uses PyQt6 for the user interface
Made with ❤️ for the TTRPG community
- Light detection settings will be saved in presets in the next release.
- The UI is being redesigned for better usability.
- Dedicated executables for MacOS and Linux are planned.
