Beat 2.4.0
The Beat Guide.
The tools in Beat, where to find them and how they work. Look up the one you need, or read it through once to see what is there.
Getting started
Find itbeatforfree.com · macOS 10.15 or later
Beat is a free Mac app. It needs macOS 10.15 or later.
The first time it opens, Beat asks where your projects should live. Use default keeps them in ~/Documents/Beat Projects. Pick a folder… chooses another place.
Each project is a folder on your Mac. You can back it up, copy it or move it like any other folder.
Put the library folder in iCloud Drive and two Macs can open the same projects. Open a project on one Mac at a time, because two at once makes iCloud pick a winner.
A new, empty board shows five cards under Start here: Write your first beat, Start from a template, Drop something real, Start from a script and Open a project.
Several projects can be open at once, each in its own tab under the top bar. ⌘1 to ⌘9 jump to a tab and ⌘W closes the one you are in.
The Projects window
Find itFile > Projects… · ⌘P · the Projects button at the top right
- + New project asks for a name and a starting point. Then press Create project, or Enter.
- The starting points are Blank canvas, Three-act structure, Hero's journey, Fifteen beats, Pixar story spine, Dan Harmon's story circle, Treatment (sections), Production timeline and Reference board. A template you saved yourself carries a Saved badge.
- The arrow beside + New project offers From a template…, for a
.beattemplatefile. - New folder makes a folder. Drag project cards onto it to file them.
- The search box looks at project names. Type three characters or more and it also searches inside every project.
- Each project card has buttons to rename it and duplicate it.
- The ⋯ menu holds Open project…, Import a project…, Settings…, the switch between light and dark, Change library folder…, Export all…, Open the sample project and Show me around.
- Along the bottom: Link to Claude and Get in touch.
The sample project
Find itProjects > ⋯ > Open the sample project
The Last Roll is a short film planned in Beat. It is there so you can see the tools at work before you start your own.
It has three acts, a Locations section, a Cast and props section, a sequence, an alternative ending, a set plan and a shot list whose rows are linked to the beats.
Each time you open it, Beat makes a fresh copy, so take it apart as much as you like. An empty library offers Open sample project too.
Saving and history
Find itSave in the top bar · ⌘S · ⋯ > Version history
- Beat saves as you type. Save also refreshes the project's cover picture.
- Every three minutes, if the project changed, Beat keeps a snapshot of it. It keeps the newest twenty.
- Version history lists them. Click one for a quick look, or Preview on canvas to open it on the real board and choose there whether to restore it.
- ⌘Z undoes and ⇧⌘Z redoes. While you are typing in a field, ⌘Z undoes the typing only. Edit > Undo and Redo in the menu bar do the same.
The window
Find itEverything below is visible with a project open
The top bar, the tabs, the left rail and the board.
- Top bar. The project's name, then Search beats, the Runtime, the focus timer, Save, Project info, Outline, Write, Circle, On set and Export. At the right: Projects, Filter view, Inspector, News from Beat and the ⋯ menu.
- Runtime adds up the durations of the beats that are connected, leaving out alternatives. It shows once a connected beat has a duration.
- Left rail. The + button, Sections, Clean cards, Audio timeline, Vault and Elements. Below them, Recenter and the minimap.
- Customise sidebar…, at the foot of the + menu, pins any kind of card to the rail as its own button.
- The ⋯ menu holds Version history, Locations map, Present, Show me around, Keyboard shortcuts, Settings, the switch between light and dark, Change library folder…, Beat Guide, Buy me a coffee…, Undo and Redo.
Adding cards
Find it+ in the left rail · double-click · right-click · Tab
- The + button at the top of the left rail holds every kind of card, in five rows: Story, People & places, Visual, Production and Attach. Hover a row and its cards slide out.
- Double-click empty canvas to drop a beat there.
- Right-click empty canvas to open the add menu at that spot.
- Press Tab over the canvas for a list of card kinds under the pointer: beat, character, location, prop, note, gallery, sketch, shot list and set plan. Type a kind and press Enter, and the new card's title is ready for typing. Tab again closes the list.
- Drag from a ring on a card and let go over empty canvas. The add menu opens there, and the card you pick arrives connected.
- Paste a picture, a link or some text and Beat makes a reference image, a link card, a video card or a note.
- Drag files in from Finder. A picture becomes a reference image, a video opens the video importer, a sound file loads the audio timeline, and a
.fountainor.fdxscript becomes a board. Any other file becomes a document card. - Drop a picture on a beat, gallery, thought, character, location or prop to add it to that card. Drop a document on a beat to attach it to the beat.
A script becomes a board
Drop a .fountain or .fdx screenplay on the canvas, or use + > Attach > Import script…. Each section becomes a group, each scene a beat with its heading and action, and the beats are connected in order. The characters land in a Cast section, and every place the scene headings name gets a card in a Locations section, linked to its scenes.
Every kind of card
Find it+ in the left rail, under Story, People & places, Visual, Production and Attach
- Beat
- One moment of your story. See The beat card.
- Title
- A big heading with a small line above it. A title starts a section.
- Note
- A block of plain text, for asides.
- Thought
- A light note in the margin, with a title, text, pictures and its own connections.
- Character, Location, Prop
- A name, a description and a picture. Mention one in a beat with @. A location card opens the Location Scout. A prop carries a Needed or Acquired mark and a quantity.
- Gallery
- A title, a caption and a grid of pictures.
- Sketch
- A drawing. Click it to draw with the pen, lines, arrows, shapes, text and stamps, which are ready-made drawings of framings, people, day and night, interior and exterior, cameras and arrows.
- Reference image
- A picture loose on the board. Right-click it for View larger, Edit image… and Make palette from this image.
- Colour palette
- A row of colour swatches with their hex values.
- Shot list
- A table of shots in scenes. See Shot lists.
- Set Plan
- A top-down plan of the set. See Set Plan.
- Checklist
- Items to tick, with a count of what is done. Enter adds the next item.
- Document
- A PDF, a Word file, a spreadsheet or another file. Open shows it in a viewer, Download saves a copy.
- Link card
- A web link with its title.
- Video link
- A video from a web link, with its thumbnail. Watch opens it in your browser. Extract brings it into the video importer.
- Group
- A box that makes a section. See Sections.
The beat card
Find it+ > Story > Beat · double-click empty canvas
A beat holds a title, a scene heading such as INT. LOCATION - TIME, tones, the main text, Beat's focus, Shot type and Duration.
- The main text takes Markdown: bold, italic, lists and more. Click the text to edit it, and click away to see it formatted.
- Type @ and a name to mention a character, location or prop. The mention becomes a chip, and clicking it jumps to that card.
- Tones are coloured tags. Ten come with Beat, Tension, Comedy, Reveal, Quiet, Romance, Action, Tragedy, Mystery, Hope and Dread, and + Tone… takes your own.
- Duration is screen time. It reads
45s,1:30for a minute and a half,2 minor1 h, and a plain number is seconds. - Type a scene heading that names a location card and the beat links to that card when you press Enter, leave the field or pause. You can also pick the card from the list under the heading.
- + Field… adds a field to this card only. Fields for every beat live in Project info > Custom fields.
- + Shot adds a shot. See Shots on a beat.
- + Image… adds pictures. Click a picture to see it large.
- A document dropped on the beat shows as a chip. Click the chip to open it.
- The chevron in the card's head folds the card and opens it again.
- The number on a beat follows the order of the Write document. Project info > Beat numbering sets it to Auto, Manual or None, on the cards and in every export.
- Project info > Customise Beat Nodes picks which fields show on beat cards. A hidden field keeps its text and still prints.
- Clean cards, in the left rail, hides empty fields and buttons until you hover a card.
Connections
Find itthe rings on a card's edges
- The rings on a card's edges are its connections. Drag from a ring to another card to connect the two.
- A connection is solid, dashed or dotted. A plain one continues the story, an alternative is dashed and a reference is dotted.
- Right-click a connection to edit it: its style, its colour, a label, a condition such as if Olivia trusts Marco, cable ties, or Remove connection.
- Click a connection and press Delete to remove it.
- Hover the end of a connection for a handle, and drag the handle to another card.
- Drag a ring from a card and drop it on a connection, and that card goes in between, so A then B becomes A, the card, then B. Only a plain connection with no label or condition splits this way. Between two beats only a beat that is not an alternative can go in, and a character, location or prop never goes into the story line.
- Delete a card in the middle of the story line and its neighbours stay connected to each other.
- Alt-click a connection (Alt is the Option key) to add a cable tie. Drag the tie to route the wire, and Alt-click the tie to remove it.
- A character, location or prop with more than nine connections on one side shows eight and a +N pill for the rest. Click the pill to see them all, or set Settings > Canvas > Connection points on a busy card to All.
Alternatives and sequences
Find itthe buttons at the foot of a beat card
- Mark as alternative makes a beat another version of a beat. It gets an Alt badge and stays off the main path.
- On an alternative, Make main path swaps it with the main beat. The old main beat becomes the alternative.
- Start sequence makes a beat the start of a sequence or an episode. The numbers restart there and carry the first letter of each word in the sequence's name, so a sequence called Night reads N·1, N·2.
Sections
Find itShift-drag, then A · + > Group · Sections in the left rail
- Groups and Title cards are your sections. They name the chapters of your exports.
- To make a group, Shift-drag a box on empty canvas and press A while you drag. The box becomes a group that size. + > Group adds one too.
- Drag a group by its head and everything inside moves with it, groups inside it included.
- A card belongs to a section when its centre sits inside the box. Each card in a section carries a strip in the section's colour down its left edge, so you can see what moves when you drag. A dashed strip marks a card that is listed in a section but sits outside its box.
- Right-click a group for Role, Rename…, Hide group, Exclude from exports and Delete group. Deleting a group keeps its cards.
- Give a section the role character, location or prop, and the cards of that kind you make from a beat land in it.
- Sections, in the left rail, lists every section and flies you to the one you pick.
- In Write, the grip beside a section's heading reorders sections. See Write.
Picking several cards
Find itShift-click · Shift-drag
- Shift-click cards to pick them one by one, or Shift-drag a box around them.
- With more than one card picked, a bar at the bottom offers Link, Duplicate, Copy, Align, To shot list, Lock, Delete and Clear. Link makes the cards move together.
- The Inspector becomes a bulk editor for them: colour, tone, group, or delete them all at once.
- ⌘C copies, ⌘V pastes and ⌘D duplicates. Delete removes what is picked and Esc lets it go.
Zoom and pan
Find itthe trackpad · Settings > Canvas · View menu
- A two-finger swipe pans the board. Pinch, or hold Control and turn the wheel, to zoom.
- Dragging empty canvas pans too. Settings > Canvas > Pan the canvas with can move panning to a middle button or Control drag, so a plain drag on empty canvas draws a selection box.
- ⌘0 fits the whole board in view, and so does Recenter in the left rail. View > Zoom In (⌘=) and Zoom Out (⌘−) step the zoom.
- The zoom runs from 8 percent to 190 percent.
- The minimap, at the bottom right, shows the whole board. Its button is at the foot of the left rail, and Settings > Canvas > Show the minimap keeps it on.
The Mouse wheel setting
Settings > Canvas > Mouse wheel picks what the wheel does: Pans the board or Zooms in and out. When it zooms, Shift and the wheel scroll up and down, and ⌘ and the wheel scroll sideways. A trackpad pinch zooms either way. A two-finger swipe on a trackpad counts as the wheel, so when the wheel zooms, a swipe zooms too, on the board and on a Set Plan floor.
Scrolling a list 2.4.0
A two-finger swipe that starts over something that can still scroll, such as the Vault, the Elements panel, a menu, a shot list wider than its card, or a card's text that runs past its box, scrolls that and leaves the board where it is. A swipe that starts on the empty board keeps moving the board, even when cards pass under the pointer.
Finding things
Find itSearch beats · ⌘F · ⌘K · I
- Search beats, in the top bar, highlights the beats that match. ⌘F puts the cursor there, Enter or the arrow keys move from match to match, and Esc clears it.
- ⌘K opens the command palette. Type to jump to a card by name or to run a command. ⌘Space opens it too, when macOS leaves that key free.
- Filter view, at the top right, fades every card except the ones of the colour, type, tone or group you pick.
- Inspector: press I, or the Inspector button at the top right, for everything about the selected card in a side panel. Pin keeps it open when you click empty canvas.
- Elements, in the left rail, lists every character, location and prop. Click one to fly to its card and open its profile: its photos, its description, the beats that mention it in story order, what it is connected to and any Set Plan it stands in.
Write
Find itWrite in the top bar · ⇧⌘W
- Write opens your board as a document beside the canvas: the same beats in the same order. Type in the document and the card changes. Edit a card and the document follows.
- Click a beat's number in the document to find its card.
- New entry… takes lines you type or paste and makes each one a beat. Mark a line as Shot, Prop, Note and more with a click or ⌘1 to ⌘9. Indented lines fold into the beat above. The gear edits the list of categories.
- Drag a paragraph by its handle to move it, into another section too. Hover between paragraphs for + to add one. Enter at the end of a title starts the next beat.
- The grip beside a section's heading reorders the sections, and the Outline and the exports follow.
- Drag the divider to share the screen between the document and the canvas. Its arrows snap to the whole document or back to the canvas.
- Focus dims everything except the block you are writing in. The paper button sets the page to match the app, or to light or dark.
Outline
Find itOutline in the top bar
- The Outline lists every beat and section on the board, top to bottom.
- Auto reads the board in columns: left to right across the board, then top to bottom inside each column. Switch to Custom to drag rows into the order you want. That order carries into your exports.
- Click a row to select its card, or use its arrow to fly there. The checkbox leaves a beat out of exports without deleting it.
Script Circle
Find itCircle in the top bar · View > Script Circle
- The Script Circle sets every beat around one circle, clockwise from the top, in the order of the Write document. Each section is an arc sized by its share of the beats.
- The inner ring holds a story structure to hold your story against: Fifteen beats, Hero's journey, Dan Harmon's story circle, or None. Hover a point on the ring to read what it means.
- Add up to twelve keywords. Beats that share a word are joined by a line in that word's colour, and the swatch beside a keyword changes its colour.
- Click a beat to find it on the board.
- Export image saves the circle as an A3 landscape PNG at 300 pixels per inch, on a light page for print or a dark page for screens.
- It is built from the Story Structure Visualizer that Andrés Aguiló wrote.
Shots on a beat
Find it+ Shot on a beat · right-click > Add shot · Inspector > Shots
- A beat can hold its own shots. Press + Shot on the card, pick Add shot from its right-click menu, or use the Shots section of the Inspector.
- Each shot is a row on the card, numbered from its beat: 4A, 4B.
- Pick its Shot, Lens and Move from the lists the shot list uses, and type a description.
- The time field is shooting time, how long the shot takes on the day. A number alone is minutes, and
1:30is an hour and a half. The beat's own Duration stays screen time. - Drop a picture on a shot's row to give it to that shot. Under the shot, small chips show what is set for its shot list rows, such as Location, Set Plan or linked cards.
- To shot list, on the card's Shots strip, gives each shot its own row on a shot list. A shot that is already on the list is not added twice.
Shot lists
Find it+ > Production > Shot list · To shot list
- A shot list is a table of shots on the board, in scenes. Each scene has its own coloured band and heading.
- To shot list sends beats to a list, one scene per group, and a beat with shots adds a row for each shot. It is on a beat's Shots strip, in its right-click menu, in the Inspector, and on the bar when several beats are picked.
- With no shot list on the board, To shot list makes one beside the beats. With several, it asks which one.
- The columns are Shot #, Image, Location, Camera Shot, Camera Lens, Camera Move, Est., Character/Object, Description, From Script, Linked to beat and Elements, which shows the characters, locations and props the shot's beat names. Take and Observations are there for the shoot day, hidden until you show them.
- Est. is shooting time. A plain number is minutes and
1:30is an hour and a half, so the totals add up for each scene and for the whole list. - Camera Shot, Camera Lens and Camera Move are lists with presets, and you can add your own. The shot sizes run from EWS to ECU, the moves from Static to Dutch Angle, and the lenses from 14mm to 135mm.
- The # button in the card's head switches the numbering between 1, 2, 3 and scene letters, 1A, 1B.
- Sequence ▾ loads a sequence of beats into the list, one linked shot per beat.
- The card's Export ▾ menu holds On set mode, Export PDF, Export CSV, Import CSV…, Stats…, Columns… and shot list templates. Columns… shows, hides and reorders columns, and adds your own, including read-only ones that pull a field from each shot's beat.
- + Shot adds a shot to a scene and + Scene, at the bottom, adds a scene. Drag a scene to reorder it.
Set Plan
Find it+ > Production > Set Plan… · right-click a beat or a location > Add Set Plan
A Set Plan is a top-down plan of a set, drawn to real scale, for cameras, lights, people and props.
- Add one from the + menu, or from a beat's or a location's right-click menu, where it arrives linked to that card. A location card has an Add Set Plan button too.
- Double-click the plan on its card, or press Edit plan, to open the editor.
- Drag things from the palette on the left onto the floor. Its groups are Lights, Camera, Subject, Helpers, Structure, Basic shapes, Furniture, Set & grip, Transport, Exterior, Objects, Custom and Annotate. Filter elements… finds one by name.
- The lights are Softbox, Fresnel, LED panel, Kino/tube, China ball, Practical and Top. The helpers are Bounce, Flag / Cut and Diffusion.
- Select something to edit it in the panel on the right. A camera has a Body, a Format, a Squeeze for anamorphic lenses and a lens from 12mm to 200mm, and its cone is drawn from that sensor.
- Right-click anything on the floor to duplicate it, lock it, start a movement path, or move it in front of or behind what it overlaps.
- The bar on top: Scale sets the room's scale, Scale bar shows a reference bar on the floor, Grid and Snap, Underlay loads a reference floor plan, Rays shows light rays, and Dark darkens the floor, which is easier to read over an underlay. The room size is typed in metres.
- A two-finger drag pans the floor. Pinch, or hold Control and scroll, to zoom. Drag the floor's bottom-right corner to resize the room.
- Shift-drag the floor to select a box of elements. The arrow keys nudge (hold Shift for a bigger step), ⌘D duplicates, ⌘C and ⌘V copy and paste, ⌘A selects everything and Delete removes.
- + Symbol…, under Custom, adds a symbol of your own.
- Export image saves a PNG at Standard size, at least 2400 pixels on the long side, or Large, at least 4800.
- Save keeps your changes. Close asks before it lets go of unsaved ones.
Locations, the map and the sun
Find itLocation Scout on a location card · ⋯ > Locations map · View > Locations Map
- A location card's Location Scout button opens a map.
- Search an address, or click the map to drop a pin, and drag the pin to fine-tune the spot. Switch between Map and Satellite at the top right of the map.
- A photo shot on a phone usually knows where it was taken. Then its thumbnail, on a card or on the board, shows a small pin. Click the pin and the place goes on a location card.
- Street view opens imagery at the pin in a panel beside the map. Walk around in it and the pin follows. The Capture button stages 3:2 stills, and Save location writes them to the card.
- Sun path shows sunrise, sunset, golden hour and blue hour at the pin, for any day of the year. Drag the day slider, then stamp the times onto the card for the crew.
- Drag the sun along its path to pick a time, and the map draws the sun's direction and a shadow to scale over the street.
- Sun-plan a beat…, on a pinned location card, plans a beat's time of day at that place. The beat then shows a chip with the place, the time and the light, and a small sun disc that opens the plan again.
- A planned beat prints one line in the document exports, such as
Planned 16:42 · golden hour · sun 247° · Rooftop. - The Locations map shows every pinned location on one map.
- The maps load from the internet.
On set
Find itOn set in the top bar · a shot list's Export ▾ > On set mode
- On set runs a shot list as a shoot day, full screen.
- With one shot list on the board, On set opens it. With several, pick the day. With none, it offers to make one.
- Every shot list in the project is a day. The rail on the left lists the days, and under them the day's scenes with their progress.
- Start day starts the day clock.
- The shot you are on opens in the list with its pictures, its linked cards, its details and the chosen take. Observations save as you type.
- Keys: Space counts a new take, 1 to 9 marks the chosen take, D marks the shot done, S skips it, and the arrow keys move between shots.
- Order switches between Story, the order on the card, and Shooting, an order you drag. Unlock the padlock to rearrange, and lock it again when the day is set.
- A− and A+ size the whole screen. The collapse button folds every shot to one slim line for rearranging the day.
- Wrap day sums up the day: shots done, skipped and left, the estimate against the time they took, and how long the day ran. It carries the open shots to another day or a new one, then saves the day sheet as a PDF.
- Takes and observations come back to the shot list as columns, and print in its PDF.
- Esc leaves On set. There is nothing to save.
The Vault and media
Find itVault in the left rail · ⌘B · View > Toggle Vault
- The Vault keeps a project's stills, GIFs, links, video cards and even whole cards for later.
- Its + button adds pictures or a video from your Mac.
- Drag a card, a picture, a link or a video card onto the open Vault to put it away. Drag a tile onto the board to place it there. It stays in the Vault until you drag it out or remove it.
- Filter by type, sort by Newest, Oldest or By type, and drag the slider to resize the thumbnails. Shift-click picks several tiles, and dragging one brings them all.
- A still or a GIF in the Vault can be saved out as a file.
- Click any picture to see it large. The arrow keys step through the pictures and Esc closes.
The video importer
- It opens from + > Attach > Import video…, from a video file you drop on the board, or from Extract on a video card.
- Play the video, drag the timeline, or step frame by frame with the arrow keys. Capture frame saves the frame you are on as a still.
- Mark Start and End around a moment, pick a frame rate and a size, and Make GIF.
- Done puts everything you captured into the Vault. The video itself is not kept, only what you capture.
Audio, Present and the timer
Find itAudio timeline in the left rail · ⋯ > Present · the timer beside Save
Audio timeline
- The audio timeline lays your story against a track. Load a song with its button, or drop a sound file anywhere on the board.
- Double-click the waveform to drop a marker. Drag a marker to move it, and double-click its flag to name it.
- Select a marker and press + Beat for a beat that carries that timecode. The timecode badge on the beat takes the playhead back there.
Present
- Present shows your story full screen: a cover, then a slide for each section, title and beat, pictures included.
- The right arrow, Space or a click on the right half moves on. The left arrow or the left half goes back. Home and End jump to the first and last slide, and Esc leaves.
- The slides follow the order of the Outline and the exports, and cards left out of exports stay off them.
The focus timer
The timer beside Save runs a focus session. Click it to start or pause, and right-click it to reset it or change its length.
Exports
Find itExport in the top bar · the File menu
Export opens the Export center: the formats on the left, a live preview in the middle and the format's options on the right.
- Documents
- Project overview (PDF), Treatment (PDF), Canvas to PDF (print layout), Storyboard (PDF), Pitch deck (PDF, 16:9), Word, clean (.docx) and Word, annotated (.docx).
- Production
- Shot list (PDF), Shot list (CSV), Breakdown sheets (PDF) and Gear summary (PDF).
- Handoff
- Screenplay scaffold (.fountain), For AI chat development (.md) and Export all media (.zip).
- Exports follow the board's reading order, the one the Outline shows.
- The options depend on the format: what to include, photos, a brand frame, A4 or Letter paper.
- Each PDF format has Pages: Light, the default, or Dark for reading on a screen. Canvas to PDF is the one without it.
- Canvas to PDF opens a designer. Page frames sit over the board, one per section or wherever you put them, and you arrange the cards inside each frame.
- Word, annotated keeps the comments, the alternative beats and the working notes in, marked as such.
- For AI chat development writes a Markdown file with the whole project, a reading guide for the assistant and the tasks you tick.
- PDFs print Chinese, Japanese, Korean, Russian, Greek, and Latin letters from outside Western Europe, such as Polish or Czech, as real text.
- Your name and credit line print on export covers. Set them in Settings > Your name on exports, and turn them off for one project in Project info.
- The File menu has Export Beat Overview (PDF), Export Storyboard (PDF), Export DOCX Chapters and Export for AI chat development (.md).
Where exports go
Find itSettings > Exports > Save exports to
- Downloads is the default. Ask each time opens the Save panel in the last folder you saved to. A folder you choose takes the folder you pick with Choose folder….
- In Downloads or your own folder, a file already there is never replaced. The new one is saved as
name (1),name (2). - If the chosen folder cannot be used, the file goes to Downloads and the message says Export folder not available.
- After each export a message names the folder and the file, and Show in Finder selects the file.
- Every export follows this setting. Saving media out of the Vault and saving a template keep their own Save panel.
Link to Claude
Find itProjects window > Link to Claude, at the bottom
- Link to Claude lets you sit in a Claude chat and have it read your Beat projects and help build them: look at a board, suggest beats, fill blanks, draft a sequence. Your projects stay as files on your Mac.
- It works from a Claude app on this Mac, Claude Desktop or Claude Code, not from the website. Beat sets up both.
- To set it up: turn on Enable Link to Claude, press Link now, quit and reopen your Claude app, then press Test the connection. It answers with how many tools it found when the link works.
- Claude can add and edit, but not delete, and every change is snapshotted, so Version history can roll it back.
- With the project open in Beat, Claude's edits appear on the board in a second or two.
- Linking keeps a copy of your existing Claude configuration before it writes to it.
- No Claude app? Export > For AI chat development makes a file you can paste into any Claude chat.
Settings
Find itBeat > Settings… · ⌘, · ⋯ > Settings
Settings holds what is the same in every project. What belongs to one project lives in Project info.
- Library: the folder that holds your projects, with Show in Finder and Change library folder…. When you change it, Beat asks whether to move your projects to the new folder, copy them there, or just look in the new folder.
- Appearance: Light, Dark or Match system. See Dark mode.
- Your name on exports: name, role, email, website and a credit line for export covers.
- Exports: where files go. See Where exports go.
- Canvas: Pan the canvas with, Mouse wheel, Show the minimap, and Connection points on a busy card.
- Walkthroughs: Play them all again replays every guided tour.
- Updates: when a new version is out, Beat can tell you and let you decide, start the download, or say nothing. Check now looks at once. Beat checks one small file on its own site, and nothing about you or your projects is sent anywhere.
- Appearance and Library act at once. For the rest, Save keeps your changes and Cancel drops them.
Dark mode
Find itSettings > Appearance · ⇧⌘L · View > Toggle Dark Theme
- Settings > Appearance sets the whole app, the Projects screen and new projects included, to Light, Dark or Match system. Match system follows your Mac as it changes.
- ⇧⌘L switches between light and dark from anywhere, even while you type.
- View > Toggle Dark Theme and the switch in the ⋯ menu do the same.
- A project can keep its own theme. In Project info > Theme, Default follows the app, and Light or Dark keeps that project in that theme. On Default, the project's colour tints it while the app is light.
- Write has its own paper: matching the app, light or dark.
- PDFs and the Script Circle image stay light unless you ask for a dark page.
Project info
Find itProject info in the top bar · ⌘I
- Project name and About this story, a few lines of context the AI export carries with it.
- Exports: show your author credit on this project's covers, or not.
- Project identity: a logo, a company and a contact on this project's export covers.
- Theme, and the Colour palette of tags for the cards, with Extract from image….
- Beat numbering, Customise Beat Nodes, Custom fields and Snap to grid.
- Custom fields are your own fields on every beat card, such as Emotion or Budget. Give one presets and it becomes a list to pick from. Their values show in Write and in exports, and can become shot list columns.
- Project actions: reset the board to its template, Save as starter template, Save as template…, Version history and Delete project.
Keyboard shortcuts
Find it? · ⋯ > Keyboard shortcuts · Help > Keyboard Shortcuts
Projects and files
| ⌘T | New Project…, opens the Projects window to start one |
|---|---|
| ⌘O | Open Project…, a Beat folder anywhere on your Mac |
| ⌘P | Projects… |
| ⌘S | Save |
| ⌘W | Close Tab |
| ⌘1 to ⌘9 | Go to that tab |
| ⇧⌘R | Reveal Project in Finder |
| ⇧⌘S | Share… |
| ⌘, | Settings… |
Editing
| ⌘Z | Undo |
|---|---|
| ⇧⌘Z or ⌘Y | Redo |
| ⌘C ⌘V | Copy and paste the picked cards |
| ⌘D | Duplicate the picked cards |
| Delete | Delete the picked cards, or the picked connection |
| Esc | Close a panel or let go of what is picked |
The board
| Double-click empty canvas | A new beat there |
|---|---|
| Right-click empty canvas | The add menu there |
| Tab | A new card at the pointer |
| Shift-click | Add a card to what is picked, or take it out |
| Shift-drag, then A | Draw a group that size |
| Alt-click a connection | Add a cable tie. Alt-click a tie removes it |
| Pinch, or Control and the wheel | Zoom |
| ⌘0 | Fit the whole board |
| ⌘= ⌘− | Zoom In, Zoom Out |
| Shift and the wheel, ⌘ and the wheel | Scroll up and down, scroll sideways, when the wheel is set to zoom |
Views and tools
| ⌘K or ⌘Space | Command palette |
|---|---|
| ⌘F | Search beats |
| I | Inspector |
| ⌘I | Project info |
| ⌘B | Vault |
| ⇧⌘W | Write |
| ⇧⌘L | Light or dark |
| ? | Keyboard shortcuts |
Write
| ⌘1 to ⌘9 in New entry | Mark the line as Shot, Prop, Note and the rest |
|---|---|
| ⌘Enter in New entry | Add to story |
On set
| Space | A new take |
|---|---|
| 1 to 9 | The chosen take |
| D | Done |
| S | Skip |
| ↑ ↓ | The shot before or after |
| Esc | Leave On set |
Set Plan
| Arrow keys, Shift for a bigger step | Nudge what is selected |
|---|---|
| ⌘D | Duplicate |
| ⌘C ⌘V | Copy and paste |
| ⌘A | Select everything |
| Delete | Remove |
| ⌘Z ⇧⌘Z | Undo, Redo |
| Esc | Close, asking first if there are changes |
Pictures, video and Present
| ← → | The picture before or after, in the large view |
|---|---|
| ← →, Shift for ten | Step a frame in the video importer |
| Space | Play or pause in the video importer |
| → or Space, ← | Next or previous slide in Present |
| Home End | First or last slide in Present |
Help
Find itHelp > Beat Guide · ⋯ > Show me around · Projects window > Get in touch
- Show me around, in the ⋯ menu, lists every walkthrough so you can play it again. Most tools also have a small ? button that replays their own.
- Beat Guide, in the Help menu and the ⋯ menu, opens this page.
- ? shows every keyboard shortcut.
- The bell at the top right brings news from Beat.
- Get in touch, at the bottom of the Projects window, or write to beat@joaolutz.com. Tell me what is missing from this guide too.
macOS 10.15 or later.