Series & batches

Shot numbers and video file names

Each shot card gets a fixed number like 04, Duplicate gives 04-v2, files are named 04_Shot-title.mp4 in one save folder you choose, and Spider Hub never overwrites a video.

Once you have a few hundred videos, the file name decides whether you find the scene you need in ten seconds or ten minutes. Spider Hub names files by one simple rule: the shot number, then the card's short title. This article explains where shot numbers come from, how a duplicate is named, and where videos are saved.

One board, one save folder

Spider Shot has one shared board for every shot. Every new video is saved in one folder you choose:

  1. On Spider Shot's defaults bar, click Change video folder (the first time the button says Choose save folder) and pick a folder.
  2. Click Open to open that folder.

Until a folder is chosen, the app sends no shot and asks you to choose one first.

Shot numbers: given once, kept for good

Every card in Spider Shot gets a number when it is created: 01, 02, 03… A new card takes the highest number on the board + 1. The number:

  • never changes, even if you drag the card elsewhere or remove the cards next to it;
  • stays when you run it again: Run again or Edit and run is still the same shot, with the same number and file name;
  • shows on every screen: Spider Shot, Task Queue, Video Library.

Duplicate: another version of the same scene

Click Duplicate on a card and the app puts a draft card right next to it with the same prompt, images and settings, carrying the next version of that shot: 04 → 04-v2 → 04-v3. The draft sends nothing until you press Generate, so you can change the prompt first.

The file name

<shot number>[-v<version>]_<short title>.mp4
ExampleMeaning
04_Pirate on deck.mp4Shot 4, short title "Pirate on deck"
04-v2_Pirate on deck.mp4The second version of shot 4, made with Duplicate
123_Final scene.mp4From shot 100 on, the number has 3 digits

A few details:

  • The short title is the Short title (optional) box on the card. Leave it empty and the app takes the first few words of the prompt.
  • Accents are kept. The app only drops characters macOS and Windows don't allow in file names (<>:"/\|?*) and shortens a very long title; the shot number is never cut.
  • The file name is fixed when you press Generate: running it again or reopening the app gives the same name.
  • If the name is taken in the folder, the app adds (2), (3)… It never overwrites an existing file.
  • A saved video is never renamed. Videos made with earlier versions keep their old names.

Videos of a SPIDER POWERS series

Each series gets its own folder inside the save folder, named exactly as the series name you typed (a series name is required):

<save folder>/<Series name>/<Series name>_NN.mp4

NN is the video's place in the series. See SPIDER POWERS: a whole series from one script.

Changing the folder midway

Every shot remembers the folder from the moment you pressed Generate. Changing the folder later only applies to shots sent afterwards; running shots still save where they were going, and no file is moved.

Folders in iCloud, Google Drive, OneDrive, Dropbox or Box work, but the app warns you because a sync app can lock a file while the app is writing it.

When the folder you chose can't be written

If, at save time, the folder you chose can't be written (an external drive was unplugged, the folder was deleted, write permission was lost):

  • the video is saved in the app's own video folder;
  • the card says where the video was saved.

The app never recreates the folder you chose. An unplugged drive is never replaced by an empty folder of the same name on your computer.

Finding a video again

In the Video Library, type #04, 04 or 04-v2 into search to get exactly that shot or version. Searching by words from the prompt works too.

Example

You make ads for one shop and choose the folder ~/Movies/Shop A. The board has shots 01–10; you are not happy with shot 03, so you click Duplicate twice and change the prompt of each version. The folder looks like this:

Shop A/
  01_Opening the shop.mp4 … 10_Closing logo.mp4
  03-v2_Making coffee.mp4
  03-v3_Making coffee.mp4

Summary

  • One shared board, one save folder you choose with Change video folder.
  • Shot numbers are given once (highest on the board + 1), never change, and running again keeps the number.
  • Duplicate makes a draft with the next version: 04 → 04-v2 → 04-v3.
  • File name = <NN>[-v<version>]_<short title>.mp4, accents kept, (2) on a clash, never overwritten.
  • SPIDER POWERS series are saved as <Series name>/<Series name>_NN.mp4.
  • If the folder can't be written, the video goes to the app's folder and the card says so.