Collaboration
Working as a Team
Invite your team to a project and everyone works on the same budget, schedule, script, and breakdown. Edits appear on each other's computers in real time, straight over your network. Nothing is stored on a server, so your production data stays between your computers.
Team sharing is in Beta. Keep your own backup of shared projects.
How Collaboration Works
FilmBase syncs peer-to-peer over your local network. Changes go directly from one computer to another without passing through a server, which suits a closed set. Everyone collaborating is online on the same team network; edits to the budget, schedule, script, stripboard, and breakdown land on your teammates' computers the moment you make them.
Team Networks
First, put everyone on the same FilmBase network. That happens on the Team > Network page.
- One person clicks Create a network, names it, and optionally sets a password. They're now hosting it.
- Everyone else on the same network sees it listed under the networks found on your network. They click to join, entering the password if there is one.
- Once they've joined, their computer is connected to yours, and any project they are invited to reaches them.
The network and the project data stay on your local network. When two computers connect, each one proves which FilmBase account it is signed in with, using a pass it received when it signed in. A computer that cannot prove its account is not connected, and a project is sent only to computers signed in with an email that was invited to it.
- Same version: both computers must run the same version of FilmBase. If they don't, FilmBase says so; update FilmBase on both.
- Sign-in ran out: if FilmBase says a computer's sign-in has run out, connect that computer to the internet and sign in to FilmBase on it.
- Wrong date or time: if FilmBase says the date and time are wrong, set the clock on both computers and try again.
What Your Network Needs
Collaboration works over the network you are already on, with no setup on the router in most cases. What it needs:
- Every computer on the same Wi-Fi or LAN. Guest Wi-Fi and some hotel or venue networks isolate devices from each other, which stops teammates from finding one another. A phone hotspot or a small travel router avoids that.
- TCP port 42902 for the sync connection, and UDP port 42900 for discovery. If a computer hosts a network and nobody can join, a firewall is usually blocking inbound connections on 42902. Allow FilmBase through it.
- Local network access. The first time FilmBase looks for teammates, macOS asks whether it may find devices on your local network. Allow it, or the networks list stays empty. If it was dismissed, turn it back on in System Settings > Privacy & Security > Local Network.
Discovery uses multicast, so teammates appear on their own. If a network does not forward multicast, you can still join by entering the host's address shown next to their network.
All sync traffic stays on your local network and goes straight between computers. Nothing is uploaded to a server, which is also why every computer has to be reachable on the same network at the time you are working together.
Enabling Collaboration on a Project
Collaboration is switched on per project, starting in the Project Hub:
- Join or create a team network on the Team > Network page (see above).
- In the Project Hub, click the ⋯ menu on the project you want to share and choose Share with team.
- Enter the email your teammate signs in to FilmBase with, choose their role and, under Access, how long their access lasts. Click Invite.
- Your teammate opens FilmBase signed in with that email, on the same team network. The project appears in their Project Hub to join, and it syncs to them over the network.
If the panel says you are not on a team network, create or join one on the Network page. The people you invited keep their invitation, and the project reaches them once the computers are connected. With the project open, the same options are under Team > Members > Invite teammate.
Inviting Teammates
A team member is a FilmBase account email. Inviting someone means adding their email with a role, from the Project Hub (⋯ menu > Share with team) or, with the project open, from Team > Members. There is no code to send. You can invite someone before they are on the network: the panel lists them as Invited, not connected yet, and the project reaches them when their computer connects.
The network password lets a computer onto the team network, and the invited email decides who receives the project. Both computers need the same network, the same network password if it has one, and the same version of FilmBase.
- A new computer: a member who moves to another computer signs in to FilmBase there with the same email and joins the team network. Nothing has to be invited again.
- Without a plan: a teammate without a FilmBase plan can still join. The project opens read-only for them, so they can view it.
Roles & Permissions
From Team > Members, an admin controls what each member can see and do: the budget, schedule, script, rate cards, or the ability to manage other members. A member only sees the sections they have permission for, so you can bring on an accountant for the budget or a 1st AD for scheduling without exposing everything else.
A role belongs to the person's FilmBase account email, not to the name they show on screen, so renaming yourself does not change what you can do. Every copy of the project checks a change against the sender's role before it accepts it:
- Someone without a role in the project can't change anything in it.
- Only members who can manage roles change roles, and nobody can raise their own role.
- The project's creator is set once and can't be changed by a teammate.
When you invite someone, Access sets how long their access lasts: no end date, 1 day, 1 week, 2 weeks, 1 month or 3 months. To change it later, right-click them on Team > Members and choose Access. Their access ends at that moment in every time zone, and after that the Project Hub no longer offers them sharing or role management for the project.
Removing Someone
In Team > Members, right-click the person and choose Remove from project. The removal takes effect at once. Their role is deleted, and that change reaches every teammate's copy, so each one drops them from its member list and stops sending them the project key. FilmBase then rotates the project key, and the new key goes only to people who still have a role. Teammates who are online get it straight away; anyone offline gets it when they reconnect.
Remove in the Share with team panel does the same thing. Both work while the person is offline: your teammates stop syncing with them and the new key never reaches them, so they get no new changes. What is already on their computer stays there. Only role managers and the project's creator can remove people or rotate the key.
Project Passwords in a Shared Project
A project password stays on the computer where it was set. It is not sent to teammates with the project's changes, and nothing a teammate sends can set, change or remove it.
How Sync Works
Sync is automatic. If two people change the same field of the same item, the later change wins, even when one computer's clock is wrong. Changes to different fields of one item are both kept. Attached files sync too, like expense invoices and storyboard images; they transfer directly between computers. The Team > Network page shows who's connected and the live status.
Project Chat
Each project has its own chat under Team > Chat. Keep notes and decisions next to the work. Your own messages are styled distinctly, Enter sends, and every message is timestamped.
Collaborating across the internet? Put the computers on the same virtual network with an overlay service like ZeroTier. It bridges them onto one virtual LAN, so FilmBase discovers and syncs between them exactly as if they were in the same room, keeping the privacy and speed of direct sync with no cloud storage involved.
Change History & Rollback
FilmBase keeps a history of edits to the budget, schedule, script, and breakdown, with the before and after of each one. A teammate's change shows up under their name, not yours, so you can always see who did what and when. It's a safety net: if something got changed or deleted that shouldn't have, you can find it and put it back.
Viewing History
Open the Team section and choose History (an admin tool, available to members who can manage roles). The feed lists changes newest-first; use the search and the person/date filters to narrow it down. The most recent week loads by default. Use Load older to go further back.
Reverting Changes
- Find the entry, or select several with the checkboxes.
- Choose Revert.
- FilmBase restores the prior values. For multiple entries it computes the net result, landing on the state before your selection rather than replaying each one.
Reverts are conflict-aware: if a teammate has since changed the same thing, FilmBase warns you instead of quietly overwriting their work. A scene edit (merging, deleting, or inserting one) shows up as a few related entries: the scene, its paragraphs, its strip. Select them together to roll the whole thing back. The routine renumbering that follows is hidden so it doesn't bury the rest.
History Settings
Turn history on or off with Record changes, and set how long it's kept, in Settings > General (a per-user preference). Changes made by a connected AI app are marked AI in the feed, and Undo AI change takes back the whole step. See Undoing AI Changes.
For quick fixes while you're editing, the standard Ctrl/Cmd+Z undo in the script editor and budget is faster than the history feed. Change History is for reviewing and rolling back edits after the fact, including a teammate's.