Frequently Asked Questions¶
Overview¶
This section contains answers to frequently asked questions about AIMMS.
General Questions¶
What is AIMMS?¶
AIMMS (Artificial Intelligent Movie Making Systems) is a professional storyboard management application designed for AI filmmakers. It provides comprehensive tools for organizing and managing shots, images, videos, and assets in a structured, efficient way.
What platforms does AIMMS support?¶
AIMMS supports Windows 10, Linux, and macOS. It's distributed as a standalone application that requires no installation.
Is AIMMS free to use?¶
AIMMS requires a license for full functionality. Note: A license provides perpetual access to all versions 1.x, but future versions 2.x onward will be paid upgrades.
Installation and Setup¶
How do I install AIMMS?¶
AIMMS is distributed as a standalone application that requires no installation. Simply download the appropriate version for your platform, extract the files, and run the executable.
What are the system requirements?¶
- Operating System: Windows 10, Linux (Ubuntu 18.04+), macOS 10.14+
- Processor: 2 GHz dual-core processor
- RAM: 4GB minimum, 8GB recommended
- Storage: 1GB free space
- Graphics: OpenGL 3.3+ compatible graphics card (GPU not required.
ffmpegandffprobeare bundled with Windows version, Linux and OSX require them installed seperately)
I'm having trouble installing AIMMS. What should I do?¶
Please refer to our Installation Guide for detailed installation instructions and troubleshooting tips.
Using AIMMS¶
How do I create a new project?¶
- Launch AIMMS
- Click File → New Project (or press
Ctrl+N) - Enter a project name and location
- Click Create
For detailed instructions, see our First Steps Guide.
How do I add shots to my project?¶
- Navigate to the Shots page (Ctrl+1)
- Click Add New Shot
- Fill in shot details (shot name, description, prompts, etc...)
- Click Save
Can I import existing shot lists?¶
Yes, AIMMS supports CSV import for shots.
- Navigate to the Shots page (Ctrl+1)
- Click Import CSV
- Locate a valid csv containing required columns
- Click Validate and then Import
How do I add images and videos to existing shots?¶
- Navigate to Images (Ctrl+2) or Videos (Ctrl+3) page
- Select your shot
- Click on View Media to open the Takes popup modal
- Click Add Take to add more empty placeholders
- Click Replace to replace empty placeholders with valid media
- Browse and select your media file
Technical Questions¶
What file formats are supported?¶
Images: PNG
Videos: MP4, MKV
Assets: Image or 3D Model formats including PNG, GLB, FBX
How does AIMMS organize project files?¶
AIMMS automatically organizes files in a structured folder system:
project_root/
├── data/ # Database and backup data files
├── media/ # Shot media files
├── logs/ # Project and application logs
└── project_config.json
Can I work on multiple projects?¶
Yes, you can create and switch between multiple projects. Use File → Open Project to change projects. This will require a restart of the application.
How do I backup my project?¶
AIMMS provides several backup options under the File menu:
- Archive Project: Archive a complete project folder to a time-stamped
.zipfile (For large projects this might be best done manually with the AIMMS application closed) - Backup Database: Run File → Backup Database at regular intervals to provide roll-back options. These will be automatically stored in the
project\data\backupfolder as time-stamped.dbfiles and can be used to manually replace a corruptproject\data\shots.db. Manually remove old ones as you see fit. - CSV export: Use File → Export CSV at regular intervals. This will make time-stamped csv entries under
project\data\csvfor each of theshots.dbtables. Manually remove these as you see fit. - Routing relationships: Use File → Save to create regular saves of the routing relationship between the
shots.dband theproject\mediafiles. This will be useful in case of complete loss ofshots.dbto rebuild the database. The information is saved to theproject\savefolder as.aimmsin JSON format. This can also be used to renameproject\media\{shot_id}folders to{shot_name}for migration of media for use in alternative applications.
Troubleshooting¶
For detailed instructions, see the Troubleshooting Guide.
Advanced Features¶
Can I integrate AIMMS with other tools?¶
Version 1.0 is a passive storyboard management system but future versions will integrate with tools such as ComfyUI and LLMs via API.
The project\data\shots.db is SQLite3 and can be accessed using python code. However, to avoid corruption be certain to keep regular backups and only access the database as read-only.
.aimms file is provided in the \project\data\saves folder and updated using File → Save. This is a JSON format file which can be used to rename the media\{shot_id} folders for migration out of AIMMS project structure. This file is provided to keep a record of the relationships structure between media folders (named using shot_id) and shot_names.
An inbound migration tool is on github for importing media into AIMMS from other platform. It provides the current version project folder structure and database schema, and is open to the public for code development to enable further integration.
How do I use the starred system?¶
The starred system helps you mark favorite takes:
- Click the star icon in any shot in the image, or video storyboard popup take modal
- Only one item per shot can be starred and it will appear in the preview card for that shot
- Use stars to prioritize your best takes
What is the routing matrix?¶
The routing matrix is for checking at a glance the health of media and database relationships. A green tick shows both are present. A red X means either the database or the media folder is missing an entry or has corrupted data.
Fixing orphan issues in either direction is done through further analysis in the Unused page to assess what the problem is and tidy up orphan entries.
Getting Help¶
Where can I find more help?¶
- Getting Started - Comprehensive documentation on use
- Troubleshooting Guide - Problem-solving help
Licensing¶
How do I activate my license?¶
- Launch AIMMS
- Enter your license key and email when prompted
What if my license doesnt work?¶
Check the Troubleshooting Guide
If that does not resolve your issue then contact point of sale with your details of purchase.
You will always be to access your projects manually.
Is there a community or forum?¶
Check the website for future community forums, and additional resources.
- Official Website: Visit for latest downloads and news
- Documentation: Comprehensive user guides
- Video Tutorials: Step-by-step video guides
- Community Forum: User discussions and support (planned)