The -well tools · Spoolwell · User Guide
Spoolwell icon

Spoolwell™ User Guide

Video Finishing Toolbox

The guide that comes with Spoolwell 1.17.8, the current version

New to Spoolwell? Watch the 98-second introduction.

Contents
  1. What Spoolwell is
  2. Quick start
  3. Check videos for problems
  4. Merge tape captures by day
  5. Trim the blue screen
  6. Split a video at break points
  7. Add or fix a title
  8. Cover a ragged edge with black bars
  9. Raise the sound and reduce tape hiss
  10. Set a video's date
  11. Convert the sound to AAC
  12. Make videos smaller
  13. Convert a DVD
  14. Make a video details inventory
  15. Find the camcorder's date stamps
  16. Work from Lightroom Classic
  17. Settings
  18. The dashboard
  19. The browser dashboard
  20. Where your files go
  21. GPU acceleration
  22. Command line
  23. Troubleshooting
  24. Install
  25. License and free trial
  26. Updates
  27. Help
  28. Appendix: What's new
  29. Appendix: What's in the folder
  30. Appendix: License and credits

What Spoolwell is

Spoolwell finishes home movies and tape transfers. It can:

  • Check videos for corruption and sound that drifts out of sync.
  • Merge a tape's clips into one dated video per recording day.
  • Trim the VCR blue screen, or split a tape into separate videos.
  • Title a video in your studio branding and fix it later, or re-date a video given the wrong date.
  • Convert the sound to AAC, and list every video and its details in an inventory.
  • Make videos smaller: much smaller files that look and sound the same, each checked against its original.

It works losslessly where it can and keeps sound in sync. Originals are replaced only if you ask, and every tool has a Preview only box that lists what would be made without making it.

It comes three ways, with one license for all:

  • The dashboard on Windows: Start menu > Spoolwell Video Toolbox.
  • The browser dashboard: the same tools in your browser, on a Mac or Windows.
  • The Lightroom Classic plug-in: select videos, then Library > Plug-in Extras.

Quick start

  1. Install: on Windows run ThePictureOrg-Spoolwell-Setup-<version>.exe; on a Mac unzip ThePictureOrg-Spoolwell-Mac-<version>.zip and open Install Spoolwell Video Toolbox (see Install).
  2. Open Spoolwell Video Toolbox from the Start menu, or from Applications > ThePictureOrg on a Mac (it opens in your browser).
  3. What to do: click a task in the list on the left. To check videos, click Check videos.
  4. Target Media: click Folder... or File..., or type or paste a path. For the tools that make videos, leave Output Folder blank to put them in a folder next to the originals. A name on its own, with no drive, makes that folder inside the folder you're working on.
  5. Click Execute Task and watch the progress bar and the console log, which opens by itself when the job starts.
  6. When it finishes, click Open CSV Report.

In Lightroom Classic

Select videos in the Library and choose Library > Plug-in Extras > Check Videos for Problems. The result is in the Spoolwell fields of the Metadata panel; new videos from the other commands are added to your catalog.

Print the one-page Cheat Sheet (also Media-Toolbox-Cheat-Sheet.pdf in the docs folder) and keep it by the capture station.

Next: Check videos for problems, Merge tape captures by day, Trim the blue screen, Split a video at break points, Add or fix a title, Set a video's date, Convert the sound to AAC.

Check videos for problems

Use it on new captures, on a client's finished videos before they go out, or on an old drive to see what has decayed. Every frame is decoded, so a file that passes plays through to the end.

  1. What to do: Check videos.
  2. Target Media: a folder (tick Recursive Scan to include sub-folders) or one file.
  3. Tick Deep Analysis to also look for frozen or black picture, silence, clipped sound and sync drift (slower).
  4. Click Execute Task, then Open CSV Report: one row per file, PASS, WARN or FAIL.

Auto-Move Corrupted Files to '_On Hold' is ticked the first time you open the dashboard: each FAIL file is moved into an _On Hold folder next to it (see Quarantine). Untick it to leave files where they are.

Tips:

  • A WARN is a prompt to look at the file, not proof it's bad. Screen recordings, for example, can have no sound or long still frames.
  • Deep Analysis makes a scan noticeably slower on large files.
  • Files named ._something.mp4 (small files macOS leaves on FAT and exFAT drives) are skipped.

What the check looks for

Standard scan (always on). ffmpeg decodes the entire file to a null output. A file FAILS if ffmpeg exits with an error or logs any warning-or-higher message. It stops at the first error ("fail-fast") to save time. Because every frame is decoded, scan time is roughly proportional to the file's length.

Deep Analysis (optional). Adds checks that produce warnings rather than failures:

Check Flags Default sensitivity
Missing audio Video with no audio stream (NO_AUDIO) n/a
Sync drift Picture and sound start or end at different times (SYNC_DRIFT) more than one frame + 50 ms
Video freeze Frozen picture 3 s or longer
Black frames Black picture 2 s or longer
Silence Audio below -50 dB 1.5 s or longer
Clipping Audio stuck at peak level (CLIPPING) see Tuning the check

How findings are shown. Each finding is logged as one readable line with start, end and length, for example:

[ANOMALY] BLACK 00:02:15 - 00:02:58 (43.0s)
[ANOMALY] FREEZE 00:02:27 - 00:02:30 (3.2s)
[ANOMALY] SILENCE 00:10:04 - 00:10:09 (5.1s)

The same text goes into the CSV, so the report matches the console. A frozen picture inside a black stretch is reported as both, since a black screen is also still.

Title cards aren't problems. A title card at the start of a video is meant to be a still picture with no sound, so Deep Analysis leaves it out: the log says Title card at the start (4 s) and no freeze, black or silence is counted for those seconds. Spoolwell knows the card's length from the title it stores inside each video it makes; for a video from elsewhere it looks for a card's fade in from black, still hold and fade out to black. A freeze or silence that runs on past the card is still reported, from the card's end, when it is long enough to count on its own.

Result statuses

  • PASS: decoded cleanly, nothing flagged.
  • WARN: decoded cleanly, but Deep Analysis flagged something worth a look.
  • FAIL: decode errors or a non-zero ffmpeg exit code.

Supported containers: .mp4, .mov, .mkv, .avi, .m4v.

Quarantine

With Auto-Move enabled, each FAIL file is moved to an _On Hold folder next to it, or to -QuarantinePath on the command line. The name stands out in a folder list, so someone goes to look. Videos in a failed folder are skipped too. The move is a rename within the same folder, so nothing is copied. Name collisions get a numeric suffix (clip_1.mp4), so nothing is overwritten. The QuarantineAction column records the destination. On later runs, files already inside the quarantine folder are skipped. In a folder that can't be written to (a read-only folder, or a locked studio project), nothing is moved: the log and the QuarantineAction column say where each file would have gone.

Audit CSV columns: FileName, Status, FilePath, FileSizeMB, DurationSec (scan time, not video length), ErrorMessage, QuarantineAction, DetectedDate. For a FAIL, ErrorMessage holds the first ffmpeg error followed by any anomalies found before it stopped; for a WARN it lists the anomalies. Long lists are cut at 25 entries with "(+N more)". Rows are written as each file finishes, so a partial report survives a cancel or crash.

Tuning the check

  • Clipping too sensitive or not sensitive enough: adjust -ClipFlatFactor (higher = fewer, more severe hits) and -ClipMinFrames. The defaults are a starting point. Test on a file you know is clean and one you know is clipped. This detects hard digital clipping, not distortion from limiting.
  • A harmless ffmpeg warning causes false FAILs: add part of the message to the $benignPatterns list near the top of Test-Mp4Integrity.ps1.

From the command line

# Scan a folder recursively, write a CSV
.\Test-Mp4Integrity.ps1 -Path "D:\Videos" -Recurse -CsvLog "D:\report.csv"

# Deep analysis, and move failures to a chosen folder
.\Test-Mp4Integrity.ps1 -Path "D:\Videos" -Recurse -DeepAnalysis -Quarantine -QuarantinePath "D:\Bad"

# One file
.\Test-Mp4Integrity.ps1 -Path "D:\Videos\clip.mp4"
Parameter Description
-Path File or folder (required)
-Recurse Include sub-folders
-CsvLog Write the CSV report here
-Quarantine Move failed files
-QuarantinePath Destination folder for quarantine (default: _On Hold beside each file)
-DeepAnalysis Enable the extra detectors
-ClipFlatFactor Clipping threshold in dB (default 10)
-ClipMinFrames Frames over the threshold needed to flag clipping (default 3)

Merge tape captures by day

Groups capture files by the day they were recorded and makes one MP4 per day, with the clips in recording order. A day with a single clip is simply converted. Each MP4 is named and dated from its first clip, e.g. Masek_2001-12-01 17.08.25.mp4, both inside the file (creation time) and as the file's Windows dates. The originals are never changed.

Dashboard: click Merge by day in the task list. The check's options are replaced by the merge fields (all but the title are under More options; see The dashboard):

Field What it does
File Prefix Text before the date in each file name, e.g. Masek_. Optional. Left blank, it comes from the family name (below).
Output Folder Where the MP4s go. Blank = a Merged folder inside the target folder.
Deinterlace On by default. Smooth 50 fps (PAL) or 59.94 fps (NTSC) motion. Off keeps the original interlaced frames.
Use file date if no recorded date Falls back to each file's Date modified. Off by default, so undated files are listed and left out instead of guessed.
Replace existing MP4s Otherwise days that already have an MP4 are skipped, so a stopped run can be restarted.
Preview only Off when Spoolwell opens. Tick it to list the day groups, clips and output names without converting anything.
Title No title (default), Title card or Overlay text, see Add or fix a title. The title is the day's date, e.g. August 1, 2004.
Family name Optional, e.g. The Smith Family, shown above the date on the title card. With File Prefix blank it also names the files: "The", words such as Family, Archives or Collection, and possessives are dropped, so The Smith Family Archives gives Smith_, The Smith-Jones Family gives Smith-Jones_, and The Smith and Jones Families gives Smith-Jones_. The log shows the prefix it chose.
Studio Branding In Settings (Menu > Settings...): your studio's name, card color and logo, shared with the blue screen tool. See Studio branding.

Titles. A title card adds 4 seconds before each day's video; an overlay writes the date over its first 4 seconds. See Add or fix a title.

Target Media must be a folder. Recursive Scan treats each sub-folder as its own tape: its days are merged separately (never mixed with another folder's clips), and its MP4s go into a Merged folder inside that sub-folder. With an Output Folder set, each tape gets a matching sub-folder there instead. To pool all sub-folders into one set of days, use -CombineFolders on the command line. When it finishes, Open Merge Report opens a CSV with one row per day (status, clips, date source, size, durations, and Time: how long the day took, start to finish). Each day's log also ends with that time, and the summary shows the total.

NTSC and PAL. Each file's size, frame rate and shape are read, so either kind works with no settings: NTSC 4:3 becomes 640×480, PAL 4:3 768×576, widescreen 854×480 or 1024×576. The pixels are made square, so nothing looks stretched. If one day mixes the two, the day takes the first clip's format.

Where the date comes from, first found wins: the date stored in the file, then exiftool (if present), then the file name (Scenalyzer's scene'20011201 17.08.25.avi and similar), then, only if allowed, the file's Date modified.

Problems it handles.

  • A clip ffprobe can't read, or one with no picture that can be decoded, is left out of its day with a warning (check it with the validator). The day is still made, named and dated from its first good clip, and marked WARN in the report. A day with no readable clips is marked FAIL.
  • Tape dropouts the DV decoder patches over are counted and reported as one note per day instead of hundreds of lines.
  • A clip with no aspect-ratio flag is treated as 4:3.
  • Each output is checked against the total length of its clips (within 0.25 s + 0.05 s per clip), and its picture and sound lengths are compared (a WARN when they differ by more than one frame + 50 ms).
  • Unlocked DV sound. On some camcorders the sound runs a touch faster or slower than the picture, so a long clip's sound ends a little before or after it. When a clip's PCM sound is off by more than half a frame but less than 2 %, it is gently stretched to the picture's length, so the two stay together to the end; a [SYNC] line in the log says by how much (in ppm). -NoAudioStretch turns this off.
  • Picture quality. Each clip is scaled once with a high-quality (Lanczos) filter, and the output carries color tags (PAL, NTSC or HD) so players show the colors as captured.

Speed. With Use GPU when available on (the default), each day is encoded on the graphics card when one is found, and on the CPU if that fails. DV has no GPU decoder, so decoding always uses the CPU. See GPU acceleration.

From the command line

.\Merge-VideosByDate.ps1 -SourcePath "D:\Smith\Captures" -Prefix "Smith_" -WhatIf
.\Merge-VideosByDate.ps1 -SourcePath "D:\Smith\Captures" -Prefix "Smith_" -CsvLog "D:\Smith\merge.csv"
.\Merge-VideosByDate.ps1 -SourcePath "D:\Smith\Captures" -Title Card -FamilyName "The Smith Family"

Other parameters: -Title (None, Card or Overlay), -TitleSeconds (default 4), -FamilyName, -TitleText, -OutputPath, -Recurse, -CombineFolders, -AllowFileDate, -NoDeinterlace, -Overwrite, -Encoder (Auto, CPU, NVENC, QSV, AMF or VideoToolbox; default Auto), -NoHwDecode (decode on the CPU), -Crf (quality, default 16), -Preset (default slow), -AudioBitrate (default 256k), -Extensions (default .avi, .dv), -SourceTimeIsUtc, -NoAudioStretch (don't stretch unlocked DV sound to the picture).

Trim the blue screen

When a VCR has no signal it shows a solid blue screen, so analog captures often start and end with blue, and sometimes have blue in the middle where the tape was blank. This tool finds those sections and makes a copy of each file without them. The originals are never changed.

Dashboard: click Trim blue screen in the task list (the trim choices are under More options). Target Media can be one file or a folder (Recursive Scan includes sub-folders).

Field What it does
Cut Method Smart cut (recommended): re-encodes only the second or so around each cut and copies everything else untouched, so almost the whole tape stays bit-for-bit original. Full re-encode: re-encodes the whole file; slowest, use it if smart cut reports a problem. Smart cut re-encodes the whole file by itself when the capture's frame rate varies (dropped frames), because cutting it in place would move the sound; the log and report say smart cut not used: and why. Copy only: no re-encoding at all, but cuts move to the nearest keyframe (a little blue may remain) and there are no fades.
File Prefix Optional text put before each finished file's name: Shanahan gives Shanahan_1995-03-26.mp4 (an underscore is added after a letter or digit; end it with a space, _ or - to choose your own separator). Blank = taken from the family name if one is entered (The Shanahan Family gives Shanahan_), otherwise the original name. The title card still comes from the original name.
Output Folder Blank = a Trimmed folder next to each file.
Fade at mid-tape cuts On by default. A quick 0.3 s fade out and in where blue is removed from the middle. Cuts at the very start and end never fade.
Blue must be silent On by default. Blue with sound under it is kept and listed as [KEEP], because it may be a real recording with a lost picture. Blue that runs to the end of the tape is cut anyway: that is the tape after the recording stopped, and its sound is usually hiss. Untick to cut all blue.
Cut silent black at the start and end On by default. Many tapes also start and end on black. Black at the very start or end, where the sound is silent, is cut along with any blue next to it and listed as [BLACK]. Black in the middle of a tape is never cut, because fades between scenes are black, and black with sound under it is kept.
Replace existing MP4s Otherwise files that already have a trimmed copy are skipped.
Preview only Off when Spoolwell opens. Tick it to list the blue sections found in each file without writing anything.
Split into separate videos at the blue screens Off by default. Instead of one trimmed video, each stretch of picture between the blue screens becomes its own video. See Split at the blue screens.
Use GPU when available See GPU acceleration. Smart cut re-encodes so little that it always uses the CPU encoder, matched to the original's settings, so the joins are seamless.
Title No title (default), Title card or Overlay text. See Add or fix a title.
Family name Optional, e.g. The Smith Family. Shown only on a title card; with File Prefix blank it also gives the prefix (Smith_).
Studio Branding In Settings (Menu > Settings...): your studio's name, the title card color, and a logo (Logo...). See Studio branding.

What counts as blue. The picture must be strongly blue and almost flat (no detail), for at least 0.3 seconds (so the half-second blue flash some camcorders leave between recordings is cut too; shorter blue is listed as KEEP in the log and left in). Blue within a fraction of a second of the start or end is treated as the start or end. A file with no blue is listed as "No blue found" and not copied, unless its name starts with a date (see below).

Vertical lines and static. When the camera was stopped, a tape often shows vertical lines or static (snow) before the blue screen or at the very end. These are cut too, with no setting to turn on: at the very start and end of the file, whatever the sound there, and right before or after a blue screen that is cut. They are listed in the log as [STATIC]. Lines or static in the middle of a recording, away from any blue, are left in. Lines count when the picture is almost all vertical stripes with no color; static counts when no point of the picture looks like its neighbors or like the moment before. To keep them, add -KeepStatic on the command line.

The result keeps the original's name, recording date (inside the file and as the file's dates) and quality. If the file name starts with a date, such as 1998-10-25 Halloween.mp4 (also 1998_10_25, 1998.10.25 or 19981025), that date is used instead, both inside the file (creation_time, which Mylio, Lightroom, Photos and Windows read) and as its Date created and Date modified. A time right after the date (2001-12-01 14.23.10) is used too; a date on its own gets 12:00 noon, so no time zone can move it to the day before. Files whose names don't start with a date keep the original's dates. A file with no blue screen is normally left alone, but if its name starts with a date it gets an untouched copy (no re-encode) in the Trimmed folder with that date: an MP4, or a MOV for DV AVIs, whose DV picture and PCM sound don't fit in MP4. To turn this off from PowerShell, add -NoFileNameDate. Smart cut checks its own work (length and a test decode across every join) and falls back to a full re-encode if anything is off, so you never get a broken file. Open Trim Report opens a CSV with one row per file: status, method, the blue sections cut, the length before and after, Time (start to finish) and StepTimes, how long each step took (scan, keyframes, copy untouched, re-encode at cuts, sound, join, check, copy to output). The step times show where the time goes, for example how much a network share costs compared with a local drive.

If blue isn't detected, or real footage is cut, run with -WhatIf and look at the listed sections. Lower -MinBlueU (for example 150) if a pale blue screen is missed; lower -MaxSpread if a mostly blue real scene is caught. Blue under sound is never cut unless Blue must be silent is off, or the blue runs to the end of the tape. Black at the ends counts as black when the whole picture is dark (average luma 32 or less, on a 16 = black scale) with no color; for a lighter black, raise -MaxBlackY (for example 40). The command-line switch is -TrimBlack.

Split at the blue screens

Tick Split into separate videos at the blue screens (or add -Split on the command line) and each stretch of picture between the blue screens becomes its own video, named after the tape: 1998-10-25 Halloween - Part 01.mp4, - Part 02 and so on, in a Split folder next to the file (or the Output Folder). The blue itself is left out, exactly as when trimming.

  • Same quality and sync as a trim. Each part is cut the way a join is: with Smart cut only the frames from the cut to the next keyframe are re-encoded, the rest is copied untouched, each edge lands on the exact frame and the sound is cut at the same point, so it stays in sync. There are no fades at the edges.
  • Short slivers are left out. A moment of picture shorter than 2 seconds between two blue screens is listed in the log and not made into a video (-MinPartSeconds changes it).
  • Dates. Each part gets the tape's date plus the time its part starts (part 2 starting 14 minutes in is dated 12:14 on a noon-dated tape), so the parts sort in order in Mylio, Lightroom and Photos.
  • Titles. With a title card, each part gets one; the date line says which part it is ("October 25, 1998 · Part 2 of 5").
  • No blue found: the file is reported as "No blue found" and isn't split.
  • Preview only lists the parts that would be made, with their start, end and length.

Matching the original's settings

Smart cut reads the original's H.264 settings (reference frames, B-frames, entropy coding) and encodes the re-encoded pieces with the same ones, then checks the first piece. In the rare case some setting still differs, the method shows as smart (headers differ) and the report says which; most players don't mind. If a player refuses such a file, run it again with -StrictHeaders, which re-encodes the whole file instead in that case.

From the command line

.\Remove-BlueScreen.ps1 -Path "D:\Smith\Tapes" -WhatIf
.\Remove-BlueScreen.ps1 -Path "D:\Smith\Tapes\Tape 1.mp4" -CsvLog "D:\Smith\blue.csv"

Other parameters: -Prefix (text before each output file name), -Split (one video per part between the blue screens), -MinPartSeconds (default 2), -Title (None, Card or Overlay), -TitleSeconds (default 4), -FamilyName, -TitleText (your own title, for a single file), -OutputPath, -Recurse, -Mode (Smart, Reencode or Copy), -FadeSeconds (default 0.3; 0 = no fades), -IgnoreAudio, -MinBlueSeconds (default 0.3), -SilenceDb (default -50), -MinBlueU and -MaxSpread (detection thresholds; defaults 165 and 24), -SampleFps (default 5), -Encoder, -NoHwDecode, -Crf (default 16), -Preset (default slow), -AudioBitrate (default 256k), -Overwrite, -Extensions (default .mp4, .mov, .m4v, .mkv, .avi), -StrictHeaders (see Matching the original's settings), -KeepStatic (leave vertical lines and static in).

Split a video at break points

Splits one video into separate videos at the places you choose: for example a two-hour tape into Birthday party, Christmas morning and Lake trip. You scrub through the video in a player, add a break wherever a new video should start, optionally name each part, and leave out parts you don't want. The original is never changed.

How parts are made, skipped and joined

Read this first; everything else in this section builds on it.

1. Breaks cut the video into parts. Each break point is the first frame of a new part. A part runs from its break up to the next break, or to the end of the video. The part before the first break is the Start part. So 4 breaks always make 5 parts.

2. Every part is either kept or skipped. A part is kept unless you untick its Keep box (in the text, a name starting with skip means the same). A skipped part is removed completely, from its break up to the next break. Nothing else is removed.

3. Each kept part becomes its own file, named or not. A name only labels the file: ... - 02 Interview.mp4 instead of ... - Part 02.mp4. Parts are never merged because of their names. That includes suggested breaks you didn't name: each one still starts a new file.

4. To make two parts one, delete the break between them. The part then runs on to the next break. Remove Suggestions deletes all the suggested breaks you haven't named or moved in one go.

5. Join puts all the kept parts in one video. With Join the kept parts into one video ticked, the kept parts are joined in order into one file, ... - Edited.mp4, with a quick fade where a skipped part was removed. Kept parts that follow each other run on with no fade, so a break you left in by mistake doesn't show. Without it, you get one file per kept part.

6. Nothing is made until you run it. Ticking, naming and adding breaks only change the plan. The files are made when you click Execute Task. The Result line under the list in the player says what you'll get, before you run it.

Worked example: a newscast. A family member appears in a news segment before and after a commercial break. You want both segments and nothing else.

 Start         Break 1           Break 2         Break 3           Break 4
 |  news before  | Interview pt 1  | commercial  | Interview pt 2  | rest of tape  |
 0:00          12:04             15:30           18:12             21:45          end
   skip           Keep              skip           Keep               skip
Part Runs Keep Name Without Join With Join
Start 0:00 to 12:04 off removed removed
Break 1 12:04 to 15:30 on Interview part 1 News - 01 Interview part 1.mp4 first half of News - Edited.mp4
Break 2 15:30 to 18:12 off removed removed (a quick fade here)
Break 3 18:12 to 21:45 on Interview part 2 News - 02 Interview part 2.mp4 second half of News - Edited.mp4
Break 4 21:45 to the end off removed removed

If Find Scene Changes had also suggested a break at 13:30 and you left it in, Interview part 1 would come out as two files (01 Interview part 1 from 12:04 to 13:30, and Part 02 from 13:30 to 15:30), or as one video with Join ticked. Delete it, or use Remove Suggestions, to keep the segment in one piece.

Cutting out a short stretch, such as a half-second blue flash. A skipped part always runs to the next break, so a short stretch needs a break at each end: stop on the first blue frame and press M, step to the first good frame after it and press M again, then untick Keep on the little part between. The trim tool (see Trim the blue screen) also finds blue flashes of 0.3 s or more by itself.

Marking the breaks

Dashboard: click Split a video in the task list and pick the video with File....

  • Windows dashboard: click Find / Mark Breaks... next to the Break Points box. A player window opens.
  • Browser dashboard: the player opens below the options when you pick the file (or click Find / Mark Breaks...).

If the video has no break points yet, the player starts Find Scene Changes by itself, so the suggested breaks appear while you watch; you can mark your own at the same time. Use the button whether you want the breaks found for you, want to mark them yourself, or both.

In the player

Control What it does
Play / Pause (Space) Plays or stops.
‹ Frame / Frame › (Left / Right arrow) Steps one frame back or forward, so you can stop on the exact first frame of a new scene.
‹ 1s / 1s › (Shift + arrow), « 10s / 10s » Jumps 1 or 10 seconds (1 second is 30 frames on NTSC tape, 60 on 59.94p files). The slider (Windows) or the timeline bar (browser) jumps anywhere.
⇤ Start / End ⇥ (Home / End) Goes to the first or last frame of the video.
Keys while typing The keys above are left alone while you type a name or edit the text box. Press Esc (or click the picture or the slider) to give them back to the player. Ticking Keep doesn't take them away.
Add Break Here (M) A new video starts at the frame shown.
Break points list One line per break. The break the frame shown belongs to is highlighted, so after N, P or a click you can see which one you're on. Windows: two parts side by side. On the left, a list of the parts: a Start row for the part before the first break, then one row per break (yellow time = suggested). Each row has a Keep tickbox (untick it to leave that part out) and a name box (type a name, then press Enter or click elsewhere). Click a time to go to it; the part shown is highlighted. On the right, the same break points as text, which you can also edit directly: delete a line to remove a break. Then click Use These Break Points. Browser: a table; click a row to go to its break, type a name, untick Keep to leave a part out, Remove to delete a break.
Break markers A row of markers under the slider (Windows) or the timeline (browser), one per break: yellow for a suggestion, blue for yours, white for the break shown. Click one to go straight to that break; hover over it for its time and name. The browser's colored timeline also shows the parts, with left-out parts striped.
Find Scene Changes Looks through the whole video and suggests a break at each sudden change of scene. See Finding the scene changes for you below.
‹ Break / Break › (P / N) Jumps to the previous or next break and stops there, showing the first frame of the new part.
Move Nearest Break Here (H) Moves the break nearest the frame shown (within 10 seconds) to that frame. Use it when a break is a frame or two off.
Remove Suggestions Removes the suggested breaks you haven't named or moved.
Save Break Points (browser) Saves the list as <video name>.marks.txt in the Split folder, so you can come back to it. The player reloads it the next time you open that video, in either dashboard.

Finding the scene changes for you. This starts by itself when you open a video with no break points; click Find Scene Changes to run it again (for example with another setting). The toolbox reads the whole video once, looking for frames where the picture changes suddenly from one frame to the next: where the camcorder was stopped and started again, or one recording was taped over another. Each one is added as a break point marked suggested (a yellow marker under the timeline, and # suggested with a number after the time). The number is how sudden the change was, from 0 to 100: Fewer (the default) suggests changes of 12 and up, Normal 8 and up, More 5 and up, so low numbers are the ones most worth checking. A 2-hour tape takes several minutes; the progress shows next to the button, and you can keep marking by hand meanwhile.

The suggestions are a starting point, so check them before splitting:

  1. Press N (Break ›), or click a yellow marker. The player stops on the first frame of the new part. Press Left to see the last frame before it, Right to come back.
  2. If the break is right, name the part in its name box (or, in the Windows text box, after # suggested 23: it's moved in front of the note) or just press N for the next one. If it's a frame or two off, step to the right frame and press H (Move Nearest Break Here). If it isn't a real change, remove it (Remove in the browser; delete the line in Windows).
  3. Add any that were missed with M, as usual.
Setting What it does
Fewer (sharpest changes only) The default. Only clear-cut changes. Least to check; may miss a cut between two similar scenes.
Normal Also gentler changes (8 and up, against 12 for Fewer).
More (gentler changes too) Also changes between similar-looking scenes. More to check.

Changing the setting and clicking Find Scene Changes again is instant (the scan is kept in the temp folder for a week). A new search replaces the suggestions you haven't named or moved; the breaks you made, named or moved stay, and no suggestion is added within a second of one of them.

What it ignores: slow changes (fades, pans, zooms), a camera flash or a brief dropout in the middle of a scene (the picture after it is the same as before), and a run of static or noise between two recordings, which counts as one change with the break on the first clean frame after it. No suggested part is shorter than 5 seconds. It can miss a cut that fades through black into a dark scene, or a cut between two very similar shots; that's what the check is for. Suggestions are always on exact frames, and splitting works exactly as for breaks you mark yourself.

Then set the other fields and click Execute Task (Preview Split while Preview only is ticked lists the parts without making them):

Field What it does
Cut Method Smart cut (recommended), Full re-encode or Copy only; the same as for the blue-screen tool.
File Prefix Optional text put before each part's file name, as for the blue-screen tool: Shanahan_1998-10-25 Halloween - Part 01.mp4. Blank = taken from the family name if one is entered.
Output Folder Blank = a Split folder next to the video.
Title / Family name / Studio Branding A title card or overlay on each part. A part with a name gets its name as the title; one without gets the file's title and "Part 2 of 5".
Join the kept parts into one video Off: each kept part is its own file. On: the kept parts are joined, in order, into one video (<video name> - Edited.mp4 in the Split folder), with a quick (0.3 s) fade out and in at each place a part was left out, as the blue-screen tool does. The joins are cut exactly as the parts would be, so the sound stays in step.
Replace existing MP4s, Preview only, Use GPU when available As for the other tools.

The result. With Join ticked, one video, 1998-10-25 Halloween - Edited.mp4, of the kept parts in order. Otherwise each part kept becomes an MP4 named after the original: 1998-10-25 Halloween - Part 01.mp4, or 1998-10-25 Halloween - 02 Birthday party.mp4 when the part has a name. Parts are numbered in order, counting only the ones made. Each break lands on the exact frame; with Smart cut only the frames up to the next keyframe are re-encoded and the rest is copied untouched, and the sound is cut at the same point, so it stays in sync. Each part is dated like the parts of a blue-screen split (the original's date plus the part's start time). A copy of the break points used is saved next to the parts as <video name>.marks.txt. Open Split Report opens a CSV listing the break points and the files made.

Videos the player can't play. Windows' player and the browsers play H.264 MP4 and MOV files directly. For other formats (DV AVI captures, MPEG-2, some MKVs) the player offers Make a Preview Copy: ffmpeg makes a small 480-line copy, frame for frame the same as the original, in your temp folder (kept for a week, then deleted). You mark the break points on the copy; the original is what gets split. A 2-hour DV tape takes a few minutes to copy.

If the Windows player closes by itself. The player runs as a separate program, so only the player closes; the dashboard stays open, and the break points made so far are kept (they are saved as you go). The dashboard then offers to open the player again on a preview copy, which Windows plays more reliably. While the copy is being made, the picture area shows its progress and time left, and the break list, markers and Find Scene Changes already work. The event is noted in Logs\dashboard_trace.log and Logs\dashboard_error.log.

DV and other non-H.264 sources can't be smart cut, so their parts are re-encoded to H.264 (on the GPU when available), as the blue-screen tool does.

Break-point format

One line per break: the time, then an optional name for the part that starts there.

00:12:30.5   Birthday party
00:45:10     skip static
01:02:00     Christmas morning
  • Times can be 1:02:03.5, 62:03.5, 3723.5, or a timecode 01:02:03:15 where the last number counts frames. A comma works as the decimal mark.
  • A name starting with skip leaves that part out (here, the static from 45:10 to 1:02:00). A line at 0 names the first part, or skips it.
  • Lines starting with # are notes, as is anything after a # on a line (00:12:30.500 # suggested 23 is a suggested break with no name). Each time is moved to the nearest frame. A line that isn't a time, or is past the end, is listed as a warning and ignored.

From the command line

.\Split-VideoAtMarks.ps1 -Path "D:\Smith\1998-10-25 Halloween.mp4" -Marks "0:12:30.5 Birthday party; 0:45:10 skip; 1:02:00 Christmas" -WhatIf
.\Split-VideoAtMarks.ps1 -Path "D:\Smith\Tape 3.mp4" -MarksFile "D:\Smith\Tape 3 marks.txt"
.\Split-VideoAtMarks.ps1 -Path "D:\Smith\News 1996.mp4" -Marks "0 skip; 12:04.2 Interview; 15:30 skip; 18:12.4 Interview; 21:45 skip" -Join

Other parameters: -Join (join the kept parts into one video), -OutputPath, -Prefix, -Mode (Smart, Reencode or Copy), -Title, -TitleSeconds, -FamilyName, -Encoder, -NoHwDecode, -Crf, -Preset, -AudioBitrate, -FadeSeconds, -MinPartSeconds, -StrictHeaders (all passed on to the cutter, see Trim the blue screen), -NoFileNameDate, -Overwrite, -CsvLog. Remove-BlueScreen.ps1 does the cutting, so it must be in the same folder.

Suggested break points from the command line, to check and edit before splitting:

.\Find-SceneChanges.ps1 -Path "D:\Smith\Tape 3.mp4" -OutFile "D:\Smith\Split\Tape 3.marks.txt"

Saved as <video name>.marks.txt in the Split folder, as here, the dashboards' player loads them when you open the video. Parameters: -Sensitivity (Low = Fewer, the default; Normal; High = More), -MinGapSeconds (default 5), -Rescan (read the video again rather than reuse the saved scan). Nothing is split by this script.

Add or fix a title

The merge, blue-screen and split tools can put a title on each video they make: a title card before it, or a title over its first seconds. Title is No title unless you choose otherwise. A title can be fixed later without making the video again.

Title card or overlay

The title comes from the file name with its leading date taken off, along with endings such as -Final, -Edited or v2, and underscores turned into spaces. 1998-10-25 Halloween to Christmas-Final.mp4 gets the title Halloween to Christmas and the date October 25, 1998. A name with no date gets a title only.

  • Title card: a 4-second card before the tape, with the logo, the family name (if given), the title, the date and "Preserved by studio name". It fades in from black and out to black, and the tape fades in after it. The video gets 4 seconds longer, and the sound starts exactly 4 seconds later so it stays in sync.
  • Family name left blank: the card takes the family name from the folders the video is in: the project folder (the folder just under Projects, or under a year folder in ProjectArchives, however deep the video is inside it), or else the nearest folder with "family" in its name, such as The Ortiz Family. Underscores read as spaces. The log says which name it used. When none is found, the dashboard asks before it starts (also for Show Title Sample): type a family name and click Use this name (it goes into the Family name box), or click No family name to make the card without one (asked again only for another Target Media). A family name found in the folder names is used on the card only, not for the file prefix. On the command line, -NoFamilyName leaves it off on purpose.
  • Overlay text: the title and date at the lower left of the first 4 seconds of the picture, fading in and out on soft dark boxes. The length doesn't change. The family name isn't shown. A camcorder date stamp in the lower right usually stays clear, unless the title is very long.
  • Quality: only the first few seconds (up to the next keyframe) are re-encoded. The rest of the tape is still copied untouched with smart cut.
  • Blue-screen tool: files with no blue screen are processed too when a title is chosen, so every tape gets one.
  • A title can be fixed later (a spelling, a missed line) without making the video again: see Fix a title.
  • Modes: titles work with Smart cut and Full re-encode. Copy only can't add a title, because it never re-encodes; the log says so and the file is trimmed without one.
  • Merged days: the title is the day's date, e.g. August 1, 2004, with the family name (if given) above it on a card. A Title Text puts your own title above the date.
  • Split parts: a part with a name gets its name as the title; one without gets the file's title and "Part 2 of 5".

Type the title for a tape

Once Title is set to a card or an overlay, two boxes appear under it: Title Text (the big line) and Second Line (the smaller line under it, usually the date; tick None for no second line). Left blank, they keep the automatic text described above. What you type is used for every video the run makes, so they are meant for a single tape (or a single day when merging). With split parts, a typed title takes the place of the part names, and "Part 2 of 5" is still added. The boxes are cleared when you choose another Target Media. On the command line: -TitleText, -SubText and -NoSubText.

See the title before you start

Show Title Sample (next to Execute Task) draws the title of the first videos, up to three, exactly as the finished videos will show it, and opens them in a window. Use Previous and Next to look through them. A card is shown on its own; an overlay is shown over a frame of the video, so you can judge it against the real picture. Nothing is cut, merged or changed.

  • Where: Merge DV video files by day, Trim blue screen and Split a video, once Title is set to a card or an overlay, and Fix a title.
  • What it uses: the same file names, dates, part names, family name, Title Text, Second Line and Studio Branding the real run would use. Change any of them and click Show Title Sample again.
  • Every title in the run: under the pictures, the window lists the title of every video the job will make (each part when splitting, each day when merging), with its second line. Click a title or second line to change it, for example when a file name reads oddly as a title. Changed marks the ones you changed. Empty a title to go back to the one from the file name. Your changes are used when the job runs, and in the pictures when you click Show Title Sample again. They belong to that task and folder: choosing another clears them. When splitting at blue screens, each video has one row, and its title goes on every part, which still says which part it is.
  • For a single tape: when the sample is of one video (Trim blue screen) or one day (merging) and Title Text and Second Line are empty, the sample puts the text it drew into them, so you can correct a word and click Show Title Sample again.
  • Looks right: the sample window's green button closes it and starts the job (the same as the main button, so with Preview only ticked it previews).
  • Fix a title: the sample shows the new title, with your typed lines and the old ones you left blank, after the old title has been found in each video.
  • The pictures are kept in Reports\Title samples in your user data folder (the last five samples). On the command line, -TitleSample <folder> does the same.

Studio branding

For your studio, or another studio using the toolbox. The title card uses three settings, set in the Settings window (Menu > Settings... in either dashboard), saved in branding.json in your user data folder (see Where your files go) and shared by both dashboards and the tools (until you change something, the sample branding.json in the toolbox folder is used):

Setting What it does
Studio name Shown at the bottom of the card as "Preserved by name". Blank = no credit line.
Color The card's background. The text color is picked automatically (light on dark colors, dark on light ones).
Logo Shown at the top of the card, and at the top left of the dashboards (from their next start). PNG with a transparent background works best. It must be a real picture file (PNG, JPEG, GIF, BMP or ICO); any other file is ignored and the logo stays as it was. No logo = the text moves up to the middle of the card.

To use your own typeface, put Title-Bold.ttf and Title-Regular.ttf (or .otf) in assets\fonts. Otherwise the bundled Playfair Display is used. For exact text and accent colors, add "TextColor": "#RRGGBB" and "AccentColor": "#RRGGBB" to branding.json.

Fix a title

Fixes the title card or title overlay of a video the toolbox has already made, for example a spelling mistake in the title or the family name, or a line that was missed. Only the title changes: the rest of the picture and all of the sound are kept exactly as they were, and the video stays the same length.

Dashboard: click Fix a title in the task list, pick the video (File...) or a folder of them (Folder...; Recursive Scan includes sub-folders), type what should change, and click Show Title Sample to see the new title as it will look (see See the title before you start). Preview Titles lists, in the log, for each video, the title it has now and what it will become. Untick Preview only and run it again to make the change.

Field What it does
New Title The big line, spelled as it should be. Blank keeps the old one.
Second Line The smaller line under the title, usually the date. Blank keeps the old one; None removes it. When the old title was just the date (the merge tool's default) and you type a title, the date moves to this line, as it would have when the video was made.
Family Line Title cards only: the line above the title, e.g. The Smith Family. Blank keeps the old one; None removes it.
Old Overlay / old seconds Only when the log asks for them (see Videos made by version 1.11.6 or earlier below).
Output Folder Blank (usual) = each video is replaced where it is, and its original is moved into an Old titles folder next to it. With a folder here, the new videos go there and the originals stay where they are.
Preview only Off when Spoolwell opens. Tick it to list what would change, without changing anything.

How it works.

  • The title is redrawn with your current studio branding, at exactly the same length, so the video's length and the sound's timing don't change.
  • Only the first few seconds are re-encoded: the title and the picture up to the next keyframe, usually a second or two after the title. Everything after that is copied untouched, and the sound is copied untouched from start to finish.
  • A title card is simply drawn again.
  • An overlay is first taken off the picture: the dark box under the old text is lifted back out, and the old letters are filled in from the picture around them. Then the new text is drawn. Fixing a spelling leaves no visible trace. Where new text is much shorter than the old, a soft smudge can show where the old letters were, until the overlay would have faded out.
  • Before anything is replaced, the new video is checked against the original: the same number of frames, the sound the same length and starting at the same moment, the picture after the title identical frame for frame, and the join decodes cleanly. If any check fails, the original is left exactly as it was and the log says why.
  • The new video keeps the original's name, recording date and Date created / Date modified. When you are happy with the new videos, delete the Old titles folder (or keep it, if you have room).
  • If a family name was misspelled, the file name may carry it too (Smiht_2001-12-01.mp4). The tool doesn't rename files; rename it yourself if you need to.

Titled videos the toolbox makes remember their title inside the file (its kind, its length and each line), so the tool knows exactly what to take off and what to keep. Videos made by version 1.11.6 or earlier don't, so the tool works it out:

  • A title card is found from the picture (it fades in from black, holds still, then fades out to black), with its length. Its text isn't needed, because the whole card is redrawn; the new card starts from what the tool would have written (the title from the file name, or the date), so type the New Title and Family Line you want on it.
  • An overlay's old text must be known exactly before it can be taken off. The tool tries what the merge and blue-screen tools would have written from the file name (the date, or the title and the date) and only goes ahead when one of them sits exactly on the picture: every letter in place, and the box ending where it should. It also finds how long the overlay showed. If it can't, the video is marked FAIL, nothing is changed, and the log says what it needs: type the old text exactly in Old Overlay, with the title and second line separated by | (e.g. Hawaii Vacation|July 4, 1998), and, if the log asks, its length in old seconds (Title Seconds when it was made).

Good to know.

  • Works on the H.264 MP4 / MOV videos the toolbox makes. A video with no title is listed as FAIL and left alone.
  • Taking an overlay off needs the ordinary (yuv420p) picture format the toolbox makes; other videos are listed and left alone.
  • The few re-encoded seconds are made on the CPU at high quality (CRF 16, matched to the rest of the video). It takes seconds per video, plus the time to copy the file; on a NAS the network sets the pace.
  • Open Title Report lists each video with its old and new title, where the new one went, and why any failed.

Command line:

.\Replace-VideoTitle.ps1 -Path "D:\Smith\Merged\Smith_1998-10-25.mp4" -TitleText "Halloween 1998" -WhatIf
.\Replace-VideoTitle.ps1 -Path "D:\Smith\Merged" -FamilyName "The Smith Family" -CsvLog "D:\Smith\titles.csv"
.\Replace-VideoTitle.ps1 -Path "D:\Jones\Tape 3-Final.mp4" -OldText "Hawai Vacation|July 4, 1998" -TitleText "Hawaii Vacation"

Other parameters: -SubText, -NoSubText, -NoFamilyName, -Title (Auto, Card or Overlay: the kind already in the video; Auto finds it), -OldSeconds, -OutputPath, -Recurse, -NameSuffix (the Settings > File Names word, used only to read titles from file names), -Crf (default 16), -Preset (default slow), -Extensions (default .mp4, .m4v, .mov), -StrictHeaders (as for the blue-screen tool). A video whose frame rate varies is skipped with the reason in the log, because its title can't be replaced without moving the sound.

Cover a ragged edge with black bars

Old tapes often show a ragged or jittery edge along the bottom of the picture (where the tape heads switch), and sometimes along the top. Black Bars covers those lines with black. The picture is not stretched or zoomed, so the video keeps its size and shape; only the covered lines turn black. It is optional: blank boxes add no bars.

  • Where: Merge DV video files by day, Trim blue screen and Split a video, in both dashboards.
  • Top and Bottom: the number of picture lines to cover at each edge, from 0 to 200 (a standard tape has 480 or 576 lines; 6 to 12 at the bottom is typical).
  • Set Black Bars... opens a frame of the tape with two yellow lines. Drag the top line down and the bottom line up until the ragged edges are in the dark part. Click a line to pick it, then the Up and Down keys move it one line. Earlier frame and Later frame step through the tape, because the edge can change along it. No bars puts both lines back to the edges, and OK fills in the boxes. With a folder in Target Media, the frames come from its first video.
  • See it first: Show Sample (or Show Title Sample when a title is chosen) shows a frame with the bars, as the finished video will look, and nothing is made. Its Looks right button starts the job.
  • Re-encoding: every frame changes, so Trim blue screen and Split a video re-encode the whole video (Full re-encode) instead of the smart or copy cut; the log says so. Merging already re-encodes. The sound is untouched.
  • A title card is not covered: the bars are only on the tape's own picture.
  • The boxes are cleared when you choose another Target Media. On the command line: -MaskTop and -MaskBottom.

Raise the sound and reduce tape hiss

Many tapes were recorded quietly, and most carry some hiss. The Sound row raises the level and can take out the hiss. It is optional: As recorded and Off leave the sound as it is.

  • Where: Merge DV video files by day, Trim blue screen and Split a video, in both dashboards.
  • As recorded: the sound is left alone (the default).
  • Louder by __ dB: raises the sound by the amount you give, anywhere between 0.5 and 30 dB. 10 dB sounds about twice as loud. A limiter holds every peak just under clipping, so a loud moment (a door slam, a shout) can't distort.
  • As loud as possible: Spoolwell finds the loudest moment of each video and raises everything until that moment sits just under clipping (at most 30 dB). When merging, the loudest moment of the whole day is used, so the day stays even from clip to clip. Nothing is limited, so the sound keeps its own ups and downs.
  • Reduce hiss: Light or Strong takes out the steady hiss of the tape and trims the highest treble, where VHS sound has only hiss. It runs before the level is raised, so a louder copy doesn't get louder hiss. Start with Light: Strong removes more but can make voices sound a little watery.
  • Set Sound Level... opens a window that plays a few seconds of the tape with your settings. It shows the loudest moment of those seconds and how much room there is to raise it. Move the slider, choose a hiss setting, and press Play to hear it. Earlier part and Later part step through the tape: try a quiet part and a loud part, because the room shown is only for the part you hear. OK fills in Louder by, and As loud as possible chooses that instead. With a folder in Target Media, the sound comes from its first video.
  • Speed and picture: the picture is not touched by these settings. Smart cut stays a smart cut, because the sound is re-encoded anyway; Copy only becomes a smart cut, since it can't change the sound. Trim blue screen also processes a video with no blue screen, so its sound can be changed.
  • In sync: the sound stays exactly in step with the picture, and each video keeps its length.
  • The settings are not remembered between sessions. On the command line: -SoundGain 6, -SoundMax and -Hiss Light (or Strong).

Set a video's date

For a video that was given the wrong date, for example a merged tape whose clips had no recorded date, or a video made from a capture done on another day. You type the date it was really recorded and the tool writes it into the video. Nothing else changes: the picture and the sound are copied, not re-encoded.

Dashboard: click Set a video's date in the task list, pick the video (File...) or a folder of them (Folder...; Recursive Scan includes sub-folders), and type the New Date as year-month-day, for example 2004-08-01. Add a time if you know it: 2004-08-01 14:30. With no time, the video gets noon. Preview Dates lists each video and the date it would get. Untick Preview only and run it again to set the date.

What it changes.

  • MP4, MOV, M4V and MKV: the date stored inside the video (the one Lightroom, Apple Photos, Google Photos, Mylio and Windows sort by), and the file's Date created and Date modified. The video is copied with its new date, checked against the original (the same streams and length), and only then put in the original's place.
  • AVI: only Date created and Date modified, because an AVI has no place for a recorded date.
  • The date is local time on the computer you're using. Every video in a folder gets the same date, so pick one video when each needs its own.
  • The date can't be in the future or before 1950. A date the tool can't read is refused and nothing changes.
  • The file name is not changed. If the name carries the wrong date too, rename it yourself.
  • Open Date Report lists each video with its old and new date.

Command line:

.\Set-MergedVideoDate.ps1 -Path "D:\Smith\Merged\Smith_2001-12-01.mp4" -Date "2001-12-01 17:08" -WhatIf
.\Set-MergedVideoDate.ps1 -Path "D:\Smith\Merged" -Date "2001-12-01" -CsvLog "D:\Smith\dates.csv"

Other parameters: -Recurse, -SourceTimeIsUtc (the date you type is UTC, not local time), -KeepBackup (keeps the video as it was, as <name>.before-date.mp4), -FileList (a text file with one video path a line; only those are dated).

Lightroom Classic: select the videos and choose Library > Plug-in Extras > Set a Video's Date... (see Work from Lightroom Classic). It writes the date into the files the same way and sets Lightroom's Capture Time to match.

Convert the sound to AAC

Converts the sound in videos to AAC, the format phones, TVs, Mylio and photo apps all play, and leaves the picture exactly as it is. Useful for DV captures and edits with uncompressed (PCM) sound, which some players won't play and which takes a lot of space, and for camcorder files with AC-3 sound. Any sound format works: PCM, FLAC, AC-3, MP2, MP3, ALAC, Opus, DTS and others. Sound that is already AAC is copied as it is, and a file whose sound is all AAC is listed and left alone. Files are not renamed.

Dashboard: click Sound to AAC in the task list, and pick a folder (Recursive Scan includes sub-folders) or a file.

Field What it does
Output Folder Blank = an AAC folder next to each file. The new file has the same name.
Replace the originals Off by default, and not remembered between sessions. Each new file takes its original's place, with the same name, and the original is deleted, but only after the new file has passed every check below. The dashboard asks before it starts. The Output Folder isn't used.
Replace existing converted files Otherwise files already converted are skipped, so a stopped batch can be run again.
Preview only Off when Spoolwell opens. Tick it to list each file's sound tracks and what would be done, without converting anything.

What stays the same. The picture is copied packet for packet, never re-encoded. Every sound track is kept, in order, with its language and channels; tracks that aren't AAC are encoded at 256k per stereo pair (-AudioBitrate changes it). Chapters, the recording date inside the file and the Windows Date created and Date modified are kept.

The container. MP4, M4V and MOV files stay MP4, M4V and MOV, so their names don't change at all. Other videos have to change container, so their extension changes: AVI, MKV, MTS, MPG and VOB become MP4 when the picture fits in MP4 (H.264, HEVC, MPEG-2 ...) and MOV otherwise (DV captures, for example). MP4 and MOV store AAC's start-up delay, so players skip it and the sound stays exactly in step. Audio files (add -Extensions .wav and so on from PowerShell) become M4A. A file with subtitle tracks is left alone, because the new file couldn't keep them.

Every new file is checked before it goes anywhere:

  • Picture: identical to the original's. The SHA-256 of every video packet must match. Where the new container stores the same frames differently (H.264 from AVCHD .MTS into MP4), every decoded frame is compared instead.
  • Sound: every track decodes without errors, starts at the same moment relative to the picture (within one AAC frame, about 21 ms, which is AAC's start-up delay that players skip), and is as long as the original's. This is measured from the packets themselves, not from the file's header.
  • Copy: the file is made in your temp folder and then copied to its place once, so a NAS is read once and written once. The copy's SHA-256 must match the file that was checked.
  • If ffmpeg reports any problem reading the original, the file is not converted.

A file that fails any check is marked FAIL in the log and the report, the reason is given, and its original is left exactly as it was. Open AAC Report lists each file with its sound before and after, the picture and sync checks, the lengths, whether the original was replaced, and the time each step took.

Space and time. The temp folder (usually on C:) needs room for the largest file; a 2-hour DV tape is about 26 GB. Encoding the sound is quick; most of the time goes on reading the original, writing the new file and reading the copy back to check it, so on a NAS the network sets the pace. The report's step times show where it goes.

If a replace is interrupted (power cut, network drop), the original is never lost: during the swap it is renamed <name>.aac-original.<ext> for a moment. If you ever find one, rename it back (remove .aac-original) unless a file with the plain name is next to it, then run the tool again. A <name>.aac-partial.<ext> file is an unfinished copy and can be deleted.

Command line:

.\Convert-AudioToAac.ps1 -Path "D:\Jones\MiniDV" -Recurse -WhatIf
.\Convert-AudioToAac.ps1 -Path "\\PICTUREORG\Projects\Jones\Final\MiniDV" -Recurse -ReplaceOriginal -CsvLog "D:\Jones\aac.csv"

Other parameters: -OutputPath, -AudioBitrate (default 256k; 256k, 256 and 256000 all mean the same), -Overwrite, -Extensions (default .mp4, .mov, .m4v, .mkv, .avi, .mts, .m2ts, .mpg, .mpeg, .vob, .dv).

Make videos smaller

Re-encodes videos so they take much less room, while they look and sound the same unless you study them closely, frame by frame. Use it on large captures and finished videos you want to keep for good: a home-movie MP4 often comes out at half its size or less, and at a quarter or less with HEVC. Merge by day, Trim blue screen and Split a video can also send their new videos through it when they finish (see Make the new videos smaller below).

Dashboard: click Make videos smaller in the task list (key 0), and pick a folder (Recursive Scan includes sub-folders) or a file.

Field What it does
Format H.264 (the default) plays on every computer, TV and phone. HEVC makes the smallest files: in our tests 20% to 50% smaller than H.264 for the same look. It plays on Macs, iPhones, iPads, Android, smart TVs, VLC and in Lightroom; on Windows the Films & TV and Photos apps need Microsoft's HEVC Video Extensions.
Quality Standard (the default) looks the same. Smaller saves more; a close look at a paused frame can show a little softening in fine detail and tape noise. Best is the closest to the original and saves the least.
Check How much of each new file's picture is compared with its original (see Every new file is checked below). Quick (the default) compares one frame in ten, spread over the whole video: several times faster on Windows, where the comparison is the slow part. Full compares the most frames and takes about as long as playing the video. Off skips the picture comparison; the frame count, the sound's timing and any copy are still checked. With Replace the originals on, Off works as Quick, so an original is never deleted for a file whose picture wasn't compared.
Use the GPU Off by default. On, an NVIDIA, Intel or AMD graphics card (the Mac's own encoder on a Mac) encodes several times faster, but the files come out somewhat larger. The quality check is the same either way.
Output Folder Blank = a Smaller folder next to each file. The new file has the same name (plus your "-Final" ending, Settings > File Names).
Replace the originals Off by default, and not remembered between sessions. Each new file takes its original's place and the original is deleted, but only after the new file has passed every check below. The dashboard asks before it starts.
Replace existing smaller files Otherwise files already made are skipped, so a stopped batch can be run again.
Preview only Off when Spoolwell opens. Tick it to list each file and what would be done, without encoding anything.

What we measured (November 2026, three HD camcorder videos, Standard quality). Sizes are the new file as a share of the original:

Sample HEVC Standard H.264 Standard
Grainy, low light, 24 Mbit/s 25% 37%
Clean daylight, 5 Mbit/s 23% 51%
Already fairly small, 1.8 Mbit/s 13% 68%

What stays the same. The picture keeps its size, frame rate, every frame and its timing, and its color. A tape capture with interlaced fields (DV) is always made H.264, which keeps both fields; a 10-bit video (an iPhone's HDR) is always made HEVC, which keeps the 10 bits. Sound that is already compressed (AAC, MP3, AC-3, Opus) is copied bit for bit; uncompressed sound (PCM, as in DV captures) becomes AAC at 256k per stereo pair, which can't be told from the original. Chapters, the recording date inside the file and the Windows Date created and Date modified are kept. MP4, M4V and MOV keep their extension; AVI, MKV, MTS, MPG, VOB, DV and WMV become MP4.

Every new file is checked before it goes anywhere:

  • Picture: every frame is there, and the new file's frames are compared with the original's (one in ten with Check Quick, the most with Full, none with Off). On Windows the score for an HD video is VMAF, the measure streaming services use for "does it look the same" (100 is identical; 90 and up is very hard to tell apart). A DVD, a tape capture or any interlaced or standard-definition video is scored with SSIM instead, as VMAF is made for HD and scores those far too low (1.17.2). Where VMAF isn't available, or can't get the memory it needs on that computer, SSIM is used instead (an INFO line says so). An interlaced video (a DVD, a DV tape) is compared as whole pictures, both files made whole the same way a player shows them (1.17.1). A file below the floor (VMAF 90, SSIM 0.97) is a FAIL. If the new file has a different number of frames, the FAIL says so instead. When a score is low, the check also looks at whether the two files' frames were simply compared out of step (some FFmpeg versions hand them over a few frames apart); if one shift lines them up all the way through, they are compared again lined up and an INFO line says so (1.17.3). The score is in the log and the report.
  • Sound: every track decodes without errors, starts at the same moment relative to the picture, and is as long as the original's.
  • Worth it: the new file must be at least 15% smaller. A video that is already small (made with a strong setting before, for example) is marked SMALL and left as it is.
  • Copy: the file is made in your temp folder and copied to its place once. The copy's SHA-256 must match the file that was checked.

A file that fails any check is marked FAIL with the reason, and its original is left exactly as it was. What you see for each video. The log says what each video was and is: for example [DONE] ... (4.21 GB to 0.98 GB, 77% smaller; data rate 28.0 to 6.5 Mbit/s). The data rate is the whole file (picture and sound) per second, so the two numbers compare directly. Open Smaller Report lists each file with its size before and after, the percentage saved, both data rates, the quality score, the sync check, the encoder and the time each step took. The summary at the end of the log gives the total space saved and the average data rate before and after; in Lightroom, the message at the end gives the same two lines.

Time. Encoding is the slow part. On a 4-core computer's CPU, an HD video took one and a half to four times its own length; standard-definition tapes go several times faster, and a newer computer with more cores is faster again. The quality check adds a little more. Use the GPU for big batches when speed matters more than the last few percent of size.

If a replace is interrupted (power cut, network drop), the original is never lost: during the swap it is renamed <name>.smaller-original.<ext> for a moment. If you ever find one, rename it back (remove .smaller-original) unless a file with the plain name is next to it, then run the task again. A <name>.smaller-partial.<ext> file is an unfinished copy and can be deleted.

Command line:

.\Compress-Video.ps1 -Path "D:\Jones\Final" -Recurse -WhatIf
.\Compress-Video.ps1 -Path "\\PICTUREORG\Projects\Jones\Final" -Recurse -ReplaceOriginal -CsvLog "D:\Jones\smaller.csv"

Other parameters: -OutputPath, -Format H264|HEVC, -Quality Standard|Smaller|Best, -Encoder CPU|Auto, -MinSaving (default 15), -AudioBitrate (default 256k), -Overwrite, -NameSuffix, -NoHwDecode, -Extensions (default .mp4, .mov, .m4v, .mkv, .avi, .mts, .m2ts, .mpg, .mpeg, .vob, .dv, .wmv).

Make the new videos smaller

Merge by day, Trim blue screen and Split a video have a Make the new videos smaller box (under More options, and in their Lightroom windows). It is on by default and remembered. When the job is done, each video it just made goes through Make videos smaller with that task's own Format, Quality, Check and GPU choices, and is replaced by its smaller copy in the same place, with the same name and dates, but only once the copy has passed every check above. A video that wouldn't come out at least 15% smaller is left as it was. Your original clips and tapes are never touched. The log shows both jobs, and the smaller step's report is saved next to the task's own with _smaller at the end of its name. It adds time: about as long again as encoding the video once. Untick the box to keep the videos exactly as the task made them. Preview only and Show Title Sample make nothing smaller.

From the command line, add -MakeSmaller (with -SmallerFormat, -SmallerQuality, -SmallerCheck and -SmallerGpu if you want other choices) to Merge-VideosByDate.ps1, Remove-BlueScreen.ps1 or Split-VideoAtMarks.ps1.

Convert a DVD

Turns a DVD's video into MP4s with AAC sound, one MP4 for each title on the disc, so it plays on any computer, TV or phone and can go into Lightroom or a photo library. Copy the disc to a folder first (the VIDEO_TS folder with its VOB files is all it needs); the DVD's own files are never changed.

Dashboard: click Convert a DVD in the task list, under Make videos (key V), and pick the DVD's folder (the one that holds VIDEO_TS) or the VIDEO_TS folder itself. While Target Media is empty it says so in grey. With Recursive Scan, pick a folder of several copied DVDs and each one is converted.

Field What it does
Quality Standard (the default) looks the same as the DVD. Smaller saves more; a close look can show a little softening. Best is the closest to the DVD and makes the largest files.
Check How much of each MP4's picture is compared with the DVD, as in Make videos smaller: Quick (the default, one frame in ten), Full or Off (frame count and sound timing only).
Use the GPU Off by default. On is faster with files somewhat larger. An interlaced DVD picture always uses the CPU, which keeps its two fields.
Sound Under More options, as for Merge by day. As recorded (the default) keeps the DVD's level. Many DVDs are mixed quieter than phones and computers expect; Louder by 10 dB brings a typical DVD to about the level of a YouTube video, and As loud as possible raises it until the loudest moment is just under the top. Either way a limiter holds every peak at -1 dB, so nothing clips. Reduce hiss works as for tapes. (1.17.2)
Also make a smooth copy for phones and the web Off by default, and remembered. The main MP4 always keeps the DVD's interlaced fields exactly as they are, the best copy to keep. Ticked, each title also gets Name (smooth).mp4, deinterlaced to 60 frames a second (50 for a PAL DVD), which looks smoother in web browsers and on some phones that show comb-like lines on moving edges in an interlaced video.
Output Folder Blank = each DVD's own folder, next to VIDEO_TS.
Replace existing MP4s Otherwise titles already converted are skipped, so a stopped batch can be run again.
Preview only Lists each disc's titles and their lengths without converting anything.

What you get. A DVD keeps each title in pieces of at most 1 GB (VTS_01_1.VOB, VTS_01_2.VOB and so on); they are joined into one MP4. The MP4 is named after the DVD's folder, Smith DVD 1.mp4, or Smith DVD 1 - Title 2.mp4 when the disc has several titles (plus your "-Final" ending, Settings > File Names). Menus and titles shorter than 30 seconds (warnings, logos) are left out, and so are the DVD's subtitles. The picture becomes H.264 and keeps its size, its 4:3 or 16:9 shape, every frame and its timing; every sound track becomes AAC. The MP4 gets the DVD file's date.

Every MP4 is checked against the DVD as in Make videos smaller: every frame is there, the picture is compared frame by frame, and the sound decodes and stays in step. Open DVD Report lists each title with its size, quality score and sync check.

In Lightroom: import the VOB files (Lightroom shows them as videos), select any piece of a title and choose Library > Plug-in Extras > Convert DVD to MP4.... The whole title is converted, and the MP4s are added to the catalog and selected.

Command line:

.\Convert-Dvd.ps1 -Path "D:\Smith\DVD 1" -WhatIf
.\Convert-Dvd.ps1 -Path "D:\Smith\DVDs" -Recurse -ViewingCopy -CsvLog "D:\Smith\dvd.csv"

Other parameters: -OutputPath, -Quality Standard|Smaller|Best, -Check Quick|Full|Off, -Encoder CPU|Auto, -MinSeconds (default 30), -Overwrite, -NameSuffix, -NoHwDecode, -FileList.

Make a video details inventory

Shows what each video is made of, and builds an inventory of your media library: one CSV row per file with its technical details. Use it to find out a video's codecs. It only reads files; it never moves or changes anything. It is much faster than the validator because it doesn't decode the video.

Dashboard: click Video inventory in the task list, set the Target Media and Recursive Scan, then Execute Task. To look at one video, choose just that file as the Target Media. When it finishes, Open Manifest opens the CSV.

What you see for each video (in the console log, and in Lightroom's closing message for up to five videos):

      Video : H.264 High, 1920x1080 (16:9), 29.97 fps, progressive
      Sound : AAC stereo 48 kHz; Dolby Digital (AC-3) 5.1 48 kHz (fra)
      Length: 1:02:03, 2.10 GB, 4.6 Mbit/s, MP4 file
  • Video: the codec (H.264, HEVC (H.265), MPEG-2, DV and so on) and its profile, the picture size and the shape it is shown at, the frame rate, and whether it is progressive or interlaced (and which field comes first).
  • Sound: every sound track, with its codec, channels (mono, stereo, 5.1), sample rate and language when the file names one.
  • Length: how long it plays, the file size, the overall data rate and the kind of file.

Supported containers: .mp4, .mov, .mkv, .avi, .m4v, .wmv, .m2ts (the validator doesn't handle .wmv or .m2ts).

Inventory columns

Column Meaning
FileName, FilePath Where the file is
FileSizeMB Size on disk
Container File extension, for example MP4
VideoCodec, Resolution, FrameRate First real video stream (embedded cover art is ignored). Frame rate is the average rate.
AudioCodec, AudioChannels, SampleRate First audio stream. None / 0 means no audio.
BitrateKbps Overall bitrate. If the container doesn't report one (common in MKV), it's estimated from size and duration.
DurationSec Video length in seconds
DateModified, ScannedDate File's last-modified time and when it was scanned
VideoProfile The video codec's profile, for example High or Main (1.16.5)
ScanType progressive, interlaced (top field first) or interlaced (bottom field first); blank when the file doesn't say (1.16.5)
DisplayAspect The shape the picture is shown at, for example 16:9 or 4:3 (1.16.5)
SoundTracks Every sound track, as on screen, separated by ; (1.16.5)

N/A means ffprobe couldn't determine the value. The end-of-run summary shows total files, Probe Failures (files ffprobe couldn't read at all) and the total storage footprint in GB. As with the validator, rows are written as each file completes, so a partial manifest survives a cancel.

From the command line

.\Sync-MediaManifest.ps1 -Path "D:\Videos" -Recurse -ManifestLog "D:\manifest.csv"
Parameter Description
-Path File or folder (required)
-Recurse Include sub-folders
-ManifestLog Write the CSV manifest here

Find the camcorder's date stamps

Many camcorders burn the date into the picture, often only for the first few seconds after each press of Record. Stepping through a tape by hand rarely lands on those frames. Find date stamps finds them for you and shows them on one page, so you can read the first and last dates on a tape at a glance. It only reads the videos; nothing in them is changed.

Dashboard: click Find date stamps in the task list (under Check), choose the video or folder in Target Media (tick Recursive Scan for the folders inside it), then Execute Task. When it finishes, a page opens in your browser; Open Date Stamps opens it again. It is a task of its own: no other task runs it.

What the page shows, for each video:

  • First date: the first frame where the date is on the screen, as a close-up of the date and the whole frame below it, with the time into the video.
  • Last date: the last frame where the date is on the screen, the same way.
  • Every time the date shows (click to open): the first and last frame of each stretch where the date is on the screen, usually once for each time Record was pressed.
  • A video with no date on the screen says so.

How it finds the date. Spoolwell reads each video once, four small pictures a second, and looks for small sharp text that stays still in the same place while the picture behind it moves: the camcorder's date. It learns where on the screen that is (usually the bottom corner), then finds every stretch where it is there, to the exact frame. Still pictures, such as a title card at the start, are passed over, so their text is not taken for a date. A long shot from a tripod with sharp lettering in it (a sign) can show up as well; the close-ups make those easy to pass over. Nothing reads the digits: the page is for you to read them.

Where the page goes. With the Output Folder blank, the page is kept with your Reports (the newest 20 are kept, see Where your files go). With an Output Folder, it is saved there as Date stamps.html, with its pictures in a Date stamps files folder next to it.

How long it takes. About as long as the video takes to decode, plus a moment for each stretch with a date: in our tests, about 1 minute for each 10 minutes of tape. Use GPU when available lets a GPU decode the video.

From the command line

.\Find-DateStamps.ps1 -Path "D:\Smith\Tape 3.mp4" -Open
.\Find-DateStamps.ps1 -Path "D:\Smith" -Recurse -OutputPath "D:\Smith\Date stamps"
Parameter Description
-Path A video or a folder of videos (required)
-Recurse Include sub-folders
-OutputPath The folder for Date stamps.html (default: a Date stamps folder next to the videos)
-PageFile The page itself, instead of -OutputPath
-Open Open the page when done
-NoHwDecode Decode on the CPU only

Work from Lightroom Classic

If your clients' scanned photos are already in Lightroom Classic, their videos can be too: checked, merged and trimmed without leaving Lightroom. The plug-in is another way in to the same tools. Every check, merge and trim is done by the toolbox's own scripts and ffmpeg, with the command the browser dashboard would use and your dashboard settings, so a video made from Lightroom is the same, byte for byte, as one made in the dashboard. It needs the toolbox installed (Setup, the Standalone folder, or the Mac app) and Lightroom Classic 6 or later.

Using it. Select one or more videos in the Library, then choose a command from Library > Plug-in Extras (under tpo: Spoolwell™, the plug-in's listing name in Lightroom). Photos in the selection are left out and counted in the summary. A video whose file can't be found (a drive not connected) is skipped and named in the summary.

User Guide from Lightroom. Each command's window has a User Guide button at the bottom, as the Plug-in Manager does. It opens this guide on the website, or the copy that came with Spoolwell when you're offline.

One video selected in a folder. Lightroom works on the selected videos, not on the folder you clicked. When only one video is selected while a folder is chosen in the Folders panel, Spoolwell asks first, because you may have meant the whole folder: All N videos works on every video in that folder and the folders inside it, Just this one on the selected video only, and Cancel stops. Mark Breaks and Split works on one video, so it doesn't ask.

Command What it does What you get in Lightroom
Check Videos for Problems The check (Check videos for problems) on the selected videos, without moving anything to Quarantine. The Spoolwell set in the Metadata panel: Check (OK, Warning or Problem found), Details (what was found) and Checked (when). Videos with a problem or warning also get the keyword Picture Org > Problem found or Picture Org > Warning (every Picture Org plug-in keeps its keywords under the one Picture Org keyword); a later check that comes back OK takes it off, and moves a video tagged by an earlier version, under Spoolwell, over to the new keyword.
Merge Clips by Date... One MP4 per recording day from the selected clips (see Merge tape captures by day), one run per folder. With Make the new videos smaller on (the default), each new day is then made smaller with your Make Videos Smaller choices (see Make the new videos smaller); the same box is in Trim Blue Screen, Split at Blue Screens and Mark Breaks and Split. The new videos, added to the catalog in the Merged folder next to the clips (or your Output Folder), and selected.
Trim Blue Screen... The blue-screen tool (see Trim the blue screen). The trimmed videos, added from the Trimmed folder.
Split at Blue Screens... The blue-screen tool with Split into separate videos (see Trim the blue screen). Each part, added from the Split folder.
Convert Sound to AAC... The AAC tool (see Convert the sound to AAC). Videos whose sound is already AAC are left as they are. The converted copies, added from the AAC folder. The originals are never replaced from Lightroom.
Make Videos Smaller... The smaller-files task (see Make videos smaller), with its Format, Quality and GPU choices. The smaller copies, added from the Smaller folder. The originals are never replaced from Lightroom.
Convert DVD to MP4... Converts the DVD titles that the selected VOB files belong to (see Convert a DVD), with its Quality, Check, GPU and smooth-copy choices. The MP4s, added from the DVD's folder (next to VIDEO_TS), and selected. The DVD's files are unchanged.
Mark Breaks and Split... Windows: opens the Break Player on the first selected video (see Split a video at break points); close it to split. On a Mac, use the app's Split tool. The parts, added from the Split folder.
Make a Video Details Inventory... The video details inventory (see Make a video details inventory) of the selected videos' folders. The CSV, shown in Explorer or Finder.
Find Date Stamps... Finds the frames where the camcorder's date is on the screen in the selected videos (see Find the camcorder's date stamps). The page with the first and last dates opens in your browser; nothing is added to the catalog.
Set a Video's Date... Writes the date you type into each selected video (see Set a video's date). The window starts from the first video's Capture Time; every selected video gets the same date. Lightroom's Capture Time shows the new date. In a Lightroom version that doesn't let a plug-in set it, the videos are selected and the message says to choose Metadata > Read Metadata from Files.
Spoolwell: Create an error log The same error log as the dashboard's Settings button (see Help), on your Desktop. It is shown in Explorer or Finder, and you can send it to The Picture Org from the window that opens.

Each command with ... opens one short dialog with the choices that tool has in the dashboard (family name, title, cut mode, output folder, GPU and so on). It remembers your answers; the first time, it starts from the dashboard's saved settings. You can type or paste a path into the Output folder box, or click Choose.... Everything else comes from the dashboard: studio branding, the "-Final" ending (Settings > File Names) and where ffmpeg is, and the choices you last used there, such as the file prefix and Deep Analysis.

While a tool runs, Lightroom's progress bar (top left) shows the file it is on; Lightroom stays usable. The x on the progress bar first asks Spoolwell is still working: Keep working (the default) carries on, Stop now stops the tool and its ffmpeg; videos already finished are kept and added, and an unfinished one is deleted. When it ends, a summary says what was made and what was skipped and how long it took (for example Took 2 min 14 s), with Show the report. Nothing in the catalog is removed or replaced, and the originals stay where they are. Lightroom can't stack videos from different folders, so new videos are added in their own folders and selected for you; open those folders in the Folders panel to see them.

Plug-in Manager. File > Plug-in Manager > tpo: Spoolwell™ has, at the top, Spoolwell home page (Spoolwell's page on thepictureorg.com), User Guide (this guide on thepictureorg.com, or the copy that came with Spoolwell when you're offline) and Other -well tools (the Tools page). The Updates section is laid out like the other Picture Org plug-ins (see Updating from Lightroom); below its update rows it shows which toolbox the plug-in uses (its version and folder, and where ffmpeg is), with Show the toolbox folder. Last comes the License section: the trial or license status, Buy a license, a box for your key with Enter key below it, and Remove license from this computer. It is the same key and the same trial as the dashboard: entering or removing it in one does it for both.

Good to know.

  • The Spoolwell fields are text, so you can filter on them in Library Filter > Metadata (column Spoolwell check) or in a smart collection ("Spoolwell check is Problem found").
  • The keywords the plug-in adds are never exported with your photos and videos (Include on Export is off).
  • Raw DV captures (.avi) that Lightroom can't play can still be checked and merged: the plug-in works on the files on disk, not Lightroom's preview.
  • What the plug-in does is written to Logs/lightroom_run.log in your user data folder (see Where your files go), and goes into the error log.
  • If Lightroom says the toolbox could not be found, install it (or reinstall it), then restart Lightroom.

Settings

The Menu. At the top right of both dashboards, Menu has User Guide, Other -well tools, Check for updates, Settings..., License..., Create an error log, Open logs folder and Quit Spoolwell, as in the other -well apps. The keys still work without opening it (T Settings, L License, E error log, H or F1 the guide, Shift+Q quit).

Settings (Menu > Settings..., or T) opens the things you set once and rarely change: FFmpeg Binary (the path to ffmpeg.exe, with Browse...; ffprobe is found automatically, see How ffmpeg and ffprobe are found), Studio Branding (studio name, title card color and logo; see Studio branding), Updates (see Updates), File Names, the "-Final" ending of new videos (see File names), Create an error log (see Help), and Start Over, whose Reset to defaults button puts every choice in both dashboards back to how Spoolwell first starts (it asks first; your studio branding, recipes, license, Reports and Logs are kept, and Spoolwell opens again; 1.17.6). At the top it shows The Picture Org logo and the Spoolwell icon; the last entry, License, shows your free trial or license (see License and free trial) with Enter Key..., and once a key is in it says THANK YOU for supporting a small family business! Click Done or press Esc to go back. If a job can't find ffmpeg, the Settings window opens by itself.

Saved fields (the ffmpeg path, target, tool, options, File Prefix, Output Folder, title choices and whether the shortcut question has been asked) are saved automatically to toolbox_settings.json as you change them, when a job starts and when the window closes, so the next launch shows your latest values. With two windows open, each one saves only the fields you changed in it, so a window left open (or minimized to the tray) no longer puts its older values back when it closes. An ffmpeg path inside the dashboard's own folder is saved relative to it (for example bin\ffmpeg.exe), so the folder can be moved or copied to another machine without breaking the setting. A path outside the folder, such as C:\Tools\ffmpeg.exe, is saved as typed.

File names

New videos made by the toolbox end with a hyphen and a word, -Final unless you change it, so the finished copy is easy to tell from the captures it came from:

Tool Without the ending With it (the default)
Merge DV video files by day (see Merge tape captures by day) Smith_2001-12-01 17.08.25.mp4 Smith_2001-12-01 17.08.25-Final.mp4
Trim blue screen (see Trim the blue screen) Tape 3.mp4 Tape 3-Final.mp4
Split into parts (Split at the blue screens and Split a video at break points) Tape 3 - Part 01.mp4, Tape 3 - 02 Birthday party.mp4 Tape 3 - Part 01-Final.mp4, Tape 3 - 02 Birthday party-Final.mp4
Join the kept parts (see Split a video at break points) Tape 3 - Edited.mp4 Tape 3 - Edited-Final.mp4
Convert the sound to AAC (see Convert the sound to AAC) Tape 3.mov (in the AAC folder) Tape 3-Final.mov

To change it: Menu > Settings... > File Names. Untick Add to the end of each new video's name to name new videos without it, or type another word after the hyphen, for example Master or Edited. The line under it shows an example with your word. Each dashboard keeps its own choice (like its other settings, Where your files go).

Good to know:

  • Your originals are never renamed. The ending goes only on new files. With the AAC tool's Replace the originals ticked, the new file takes the original's place and name, so no ending is added. Sound-only files (M4A) don't get it either.
  • Never twice. A video whose name already ends with the word keeps one: trimming Tape 3-Final.mp4 gives Tape 3-Final.mp4 in the Trimmed folder, and joining its parts gives Tape 3 - Edited-Final.mp4, not Tape 3-Final - Edited-Final.mp4.
  • Earlier results still count. A video made before you turned the ending on (for example 2001-12-01 17.08.25.mp4) counts as already made, so running the tool again on the same folder skips it instead of making a second copy. Tick Replace existing MP4s to make it again with the new name (the earlier copy stays; delete it if you don't need it).
  • The word can't contain \ / : * ? " < > |. The tools say so before anything starts.
  • From PowerShell (see Command line): add -NameSuffix Final to Merge-VideosByDate.ps1, Remove-BlueScreen.ps1, Split-VideoAtMarks.ps1 or Convert-AudioToAac.ps1. Without it, the scripts add no ending.

The dashboard

The window opens no taller than your screen. Make it any size: when it is too short for all the options, scroll the window (mouse wheel or the bar at the right) to reach the ones below. The console log takes any extra height.

The task list

The tasks are listed on the left, in three groups. Click one and the panel on the right shows that task's name, what it does, and its options. Hold the pointer over a task to see the script it runs.

  • Check
    • Check videos (Test-Mp4Integrity.ps1): video validation.
    • Video inventory (Sync-MediaManifest.ps1): a spreadsheet of every video and its details (see Make a video details inventory). Auto-Move and Deep Analysis are grayed out for this tool.
    • Find date stamps (Find-DateStamps.ps1): the frames where the camcorder's date is on the screen, on a page (see Find the camcorder's date stamps).
  • Make videos
    • Merge by day (Merge-VideosByDate.ps1): one MP4 per recording day from tape captures (see Merge tape captures by day).
    • Trim blue screen (Remove-BlueScreen.ps1): trims blue screen from tape captures, or splits them at the blue screens (see Trim the blue screen).
    • Split a video (Split-VideoAtMarks.ps1): splits one video at break points you mark in a player (see Split a video at break points).
  • Fix finished videos
    • Fix a title (Replace-VideoTitle.ps1): fixes the title card or overlay of finished videos (see Fix a title).
    • Set a video's date (Set-MergedVideoDate.ps1): gives a video the date you type (see Set a video's date).
    • Sound to AAC (Convert-AudioToAac.ps1): converts the sound to AAC, picture untouched (see Convert the sound to AAC).
    • Make videos smaller (Compress-Video.ps1): much smaller files that look the same (see Make videos smaller).
    • Convert a DVD (Convert-Dvd.ps1): MP4s with AAC sound from a copied DVD's VIDEO_TS folder (see Convert a DVD).

Keys and Stream Deck

Every button in the dashboard has a key, in the Windows dashboard and the browser dashboard alike. Press ? to see the list, with each action's name. A key does nothing when its button is hidden or grayed out on the current task, or while you are typing in a box (F1 still opens the guide).

Key What it does
1 to 9, 0, V Pick a task, in the order of the list (1 Check videos, 2 Video inventory, 3 Find date stamps, 4 Merge by day, 5 Trim blue screen, 6 Split a video, 7 Fix a title, 8 Set a video's date, 9 Sound to AAC, 0 Make videos smaller, V Convert a DVD)
Shift+W / X Run the task (keys that make or change files need Shift) / Cancel
F / P / D Choose a folder / a file / the output folder
O Open the CSV report
B Find / Mark Breaks
S Show Title Sample
M More options
C Show or hide the log
T Settings
H or F1 User Guide
E Create an error log
L License
Shift+Q Close Spoolwell (asks first while a job runs)

A Stream Deck, macro pad or any program that can run a command can do the same by name: Spoolwell.exe --do write runs the task in the dashboard you used last, without opening another window. The names are task-check, task-inventory, task-stamps, task-merge, task-blue, task-split, task-title, task-date, task-aac, write, stop, folder, photos, output, open, breaks, sample, more, console, settings, guide, report, license, logs, updates, tools and quit. With lr: in front, the Lightroom plug-in runs one of its commands on the selected videos: lr:check, lr:merge, lr:blue, lr:split-blue, lr:aac, lr:marks, lr:inventory, lr:stamps and lr:report. Spoolwell.exe ends with 0 when the action was done and 1 when it wasn't (no dashboard open, or that button can't be used now). The actions only answer programs on this computer.

Your own keys in Lightroom. In Lightroom, click Keyboard shortcuts (in any Spoolwell window, next to User Guide, or in the Plug-in Manager with Spoolwell selected), choose a key for any of Spoolwell's commands (for example Ctrl+Alt+Shift+C, or an F key on its own) and click Save keys. Keys are shared by all Picture Org plug-ins, so one key runs one command, and the window tells you if another plug-in already has the key you picked or if Lightroom uses it itself. The keys don't click through the menu: they hand the command straight to the plug-in, so they keep working when you add, remove or rename other plug-ins. At the bottom of the window, the three Other plug-in's menu item rows give a key to a command of another company's plug-in, such as Negative Lab Pro: type the menu item's name as Lightroom shows it and pick a key (1.16.10). The -well Stream Deck plug-in's Lightroom menu item button does the same from a Stream Deck.

  • Windows: the keys work while Lightroom is the window in front, and every other program keeps them. A small helper that comes with Spoolwell (The Picture Org Lightroom keys) starts with Lightroom and stops a little after Lightroom closes; it never watches your typing. If another program already holds a key, the window says so: choose another.
  • Mac: your keys go into the Mac's own App Shortcuts for Lightroom Classic (System Settings > Keyboard > Keyboard Shortcuts > App Shortcuts) and work once you quit and reopen Lightroom. Any App Shortcuts you made yourself are kept.

Stream Deck buttons. Spoolwell comes with The Picture Org's Stream Deck plug-in. Press ? and click Add Stream Deck buttons (in either dashboard): the Stream Deck app (free from Elgato) offers to install it, with two ready-made profiles, one for the apps and one for Lightroom. You can also drag the App action or the Lightroom command action onto any key and choose what it does.

The merge, blue-screen, split, AAC, title and date tools replace Auto-Move and Deep Analysis with their own options. Merge, blue-screen and split have Use GPU when available (see GPU acceleration).

Always on show: Target Media (Folder... / File...), Output Folder, and for the tools that make videos the Title (with the family name, and the Title Text and Second Line once a title is chosen). Split also shows its Break Points; Fix a title and Set a video's date show the boxes you type into.

More options. Merge by day, Trim blue screen and Split a video keep the choices most jobs leave as they are (Recursive Scan, Cut Method, the tool's own options such as Fade or Deinterlace, Preview only, File Prefix, Black Bars and Sound) under a More options bar. The bar lists what is set, for example Smart cut · Fade at cuts · Black bars 8 / 4 · Louder 6 dB · Hiss: Light, so you can check them without opening it. Click it to open or close the rows; the dashboard remembers which. The other tasks have few options and show them all.

Recipes. A recipe is a named set of a task's choices, for example Client VHS for a blue-screen trim with a title card, black bars, louder sound and light hiss reduction. Set the choices once, click Save as Recipe... and give it a name; next time pick it in the Recipe box and the choices are filled in. Saving with the same name replaces that recipe; Delete removes the one chosen. Each task has its own recipes, and both dashboards (Windows and browser) share them. A recipe never holds your videos, Output Folder, family name or typed titles. Change a choice by hand and the box goes back to (none), because the screen no longer matches the recipe; your change is kept.

Options

  • Recursive Scan: include sub-folders.
  • Auto-Move Corrupted Files to '_On Hold': moves each FAIL file into an _On Hold folder next to it. It is ticked by default on first launch; after that the dashboard remembers your choice. See Quarantine.
  • Deep Analysis: adds freeze, black-frame, silence, sync-drift and audio-clipping checks. Slower. See What the check looks for.

Buttons

  • Execute Task / Cancel: Cancel stops the job and kills the ffmpeg process it started. It does not touch other ffmpeg processes on your machine.
  • Open CSV Report: becomes available when a run finishes. Orange means failures were found, green means a clean run, blue is a manifest.
  • Minimize (the window's own button, top right) sends the window to the taskbar, like any Windows app; jobs keep running. When a job finishes, a notice pops up by the clock; click it to open the dashboard.

Progress and status

  • The bar and label show files completed (for example "Processed 3 of 20 items (15%)") and the file currently being scanned.

  • The console log is folded to one bar until a job runs, and opens by itself when one starts. Click the bar to open or close it at any time.

  • Closing during a job asks first. If you close the window (the x, Alt+F4 or the tray's Exit) while a job runs, Spoolwell asks Spoolwell is still working: Keep working (the default, also Esc) leaves the job running, Quit anyway closes it. What is already done stays done. In the browser dashboard, Quit and closing the tab ask the same while a job runs. Minimizing never asks and never stops a job.

  • Open logs folder, at the right of the console log bar, opens the Logs folder in Explorer or Finder. The console log of each of the last 5 runs is kept there, so you can look back at a run that is no longer in the console log: dashboard_debug.1.log (web_debug.1.log in the browser dashboard) is the run before the latest, up to .4.log (see Where your files go).

  • The console log shows live output. During a file you'll see about one line a second, such as [FFmpeg] 00:12:40 / 01:20:05 (16%) | speed 4.2x. If nothing has been logged for 10 seconds you'll see still working....

  • The bottom status bar shows elapsed time and seconds since the last output.

  • Spoolwell.exe is what the Start menu and desktop icons start. It opens the dashboard with no console window, so the dashboard is the only window you see, and there is no PowerShell or Windows Terminal window to close by mistake. It does the same steps as Launch.bat, below.

  • Launch.bat does the same as Spoolwell.exe, as a batch file. It first runs Apply-Updates.cmd (it finishes a PowerShell update left by an older version, if there is one), then puts bin and runtime\pwsh first on PATH for that session, then starts the bundled pwsh.exe with the dashboard script. On Windows 11 a Windows Terminal window can stay open beside the dashboard while it runs, and closing it closes the dashboard, so use Spoolwell.exe when you can. Nothing needs to be installed on the machine.

  • User Guide: Menu > User Guide (or F1) opens this guide in your browser. It opens the guide on thepictureorg.com (thepictureorg.com/spoolwell-guide) when the site answers within a few seconds; otherwise, for example when you're offline, it opens the copy that came with Spoolwell: docs\Media-Toolbox-User-Guide.html next to the dashboard script, then the same file beside the script. If neither can be opened the status bar says so; copy the HTML guide into a docs folder to fix it. Menu > Other -well tools opens The Picture Org's Tools page with every -well tool.

  • How long it took: when a job finishes, the status bar says how long it took (for example Completed. Took 2 min 14 s.), and so do the last line of the output and the notification.

  • Version: the toolbox version appears in the dashboard's title bar, in the bottom-right corner of the window. Each script has its own version, shown in its Get-Help -Full notes and listed in CHANGELOG.txt. This guide states the version it describes at the top.

  • Logo (optional): put an image named logo.png in an assets folder next to the dashboard script. It appears at the top left of the window and becomes the window icon. PNG with a transparent background works best, at least 256 px tall (it is shown 64 px tall). A JPEG cannot be transparent, so a logo saved as JPEG shows a white box around it; save it as PNG with a transparent background. .jpg, .ico, .bmp and .gif also work; SVG does not. Without the file there is no logo. A logo chosen under Studio Branding (Studio branding) is used instead when it exists; with the toolbox installed for everyone (Program Files), choose your logo there rather than adding files to the toolbox folder.

  • Desktop shortcut: when installed with the Setup program, the shortcuts are already made and nothing is asked. Otherwise, the first time the dashboard opens it asks whether to create a desktop shortcut. Choosing Yes creates Spoolwell Video Toolbox.lnk on your desktop. It points to Spoolwell.exe (or to Launch.bat in a folder without it), so the bundled PowerShell and tools are used,, and uses assets\app-icon.ico as its icon if that file exists. The question is asked once; the answer is stored in toolbox_settings.json. To be asked again, delete that file (or the ShortcutPrompted line in it). If you move the folder, delete the old shortcut and ask again the same way. Icons made by an earlier version that start Launch.bat are changed to start Spoolwell.exe the next time the dashboard opens (icons shared by every account need an administrator; running Setup again also fixes them).

  • Launch-Debug.bat is for troubleshooting. It runs the same bundled PowerShell but leaves the console visible and open after the dashboard exits, so any startup error can be read or copied.

Running several jobs at once. Start the dashboard again (open it again from the Start menu, or double-click Spoolwell.exe or Launch-Web.bat once more) for each extra job; there's no need for a second copy of the folder. The second window is titled "(window 2)", and so on. Each window runs its own job, its Cancel stops only its own ffmpeg, and its reports carry its number (for example blue_report_..._w2.csv) and its log goes to Logs\dashboard_debug_2.log (Logs\web_debug_2.log for a second browser dashboard). Settings are shared: the last change made in any window is what the next new window starts with. Two jobs share the computer's CPU, GPU and disk, so each runs slower than it would alone, and two jobs on the same network share are limited by the network. Don't point two windows at the same folder with the same tool.

Closing the window or pressing Exit stops any running job and its ffmpeg process.

How ffmpeg and ffprobe are found

For ffmpeg, the dashboard looks in this order and uses the first that exists:

  1. The path saved from your last session.
  2. bin\ffmpeg.exe next to the dashboard script (the packaged layout).
  3. ffmpeg on your PATH.

If the saved path no longer exists (for example after the folder moved) the dashboard quietly switches to the bundled copy, shows the new path in the field, and notes it in the console log when you run a job. It only reports "FFmpeg binary could not be found" if none of the three exists.

ffprobe is looked up separately, in this order:

  1. ffprobe.exe in the same folder as the ffmpeg being used.
  2. bin\ffprobe.exe next to the dashboard script.
  3. ffprobe on your PATH.

It can therefore live in a different folder from ffmpeg. If none is found:

  • Video details inventory: the dashboard refuses to start and tells you where to put ffprobe, because that tool cannot work without it.
  • Integrity scan: it starts anyway and the console log shows a warning. Deep Analysis runs as a standard scan, and the progress percentage is not shown.

The browser dashboard

MediaToolboxWeb.ps1 does the same job as the Windows dashboard, but in your web browser, so it works on a Mac. It starts a small server that listens only on your own computer and opens the page in your default browser. You can use it alongside the Windows dashboard; the two keep separate settings but share their recipes.

What it looks like and does. The page has the same layout and controls as the Windows dashboard: the task list on the left, the task's name and Recipe box, target, More options, Output Folder, a Settings button for the ffmpeg path and studio branding, the three options (Auto-Move is ticked by default on first launch), Execute, Cancel and Open CSV Report, a progress bar that moves within a file, a color-coded console log, the logo, a User Guide button and the version at the bottom right. The scripts and reports are exactly the same.

Starting it

Computer How
Mac Open Spoolwell Video Toolbox from Applications (see Install). Or in Terminal: pwsh ./MediaToolboxWeb.ps1
Windows Double-click Launch-Web.bat. Or: pwsh .\MediaToolboxWeb.ps1

The terminal window shows an address like http://127.0.0.1:8765/?t=.... The browser opens it by itself; if not, copy that address into a browser. Keep the terminal window open while you work. To stop, click Menu > Quit Spoolwell in the page or press Ctrl+C in the terminal. Closing the browser tab does not stop it (except with the Mac app, which has no terminal window: it stops by itself 10 minutes after the last dashboard page was closed, unless a task is still running). Add -NoBrowser to skip the automatic opening, or -Port 9000 to choose a port.

Differences from the Windows dashboard

  • Pickers: the Browse, Folder and File buttons open the Mac's own chooser in front of the browser. The first time, macOS asks whether Terminal (or the app you started it from) may control System Events. Click OK; the chooser can't open without it. If you refused it, allow it under System Settings > Privacy & Security > Automation. If a system has no chooser, type or paste the path instead. In the Mac chooser, Cmd-Shift-G lets you type or paste a folder path too.
  • Tray and shortcut: there is no tray icon and no first-launch shortcut question. On a Mac, drag Spoolwell Video Toolbox from Applications > ThePictureOrg to the Dock, like any app.
  • Settings: Menu > Settings... holds FFmpeg Binary, Studio Branding, Updates and File Names (see File names), as in the Windows dashboard; click Done to save them. Everything else is saved as you change it, in toolbox_web_settings.json in your user data folder (see Where your files go), separate from toolbox_settings.json, because paths such as ffmpeg differ between Windows and macOS. The Settings window also shows your user data folder under Your Files, with an Open Folder button.
  • Cancel: stops the running scan and its ffmpeg, the same as in the Windows dashboard.
  • Player (split tool): the player is part of the page, below the options. Chrome, Edge and Safari play H.264 MP4 and MOV files as they are; for anything else (DV AVI, MPEG-2) the page offers a preview copy (see Split a video at break points).

Safety. The server accepts only connections from your own computer, and every request must carry a random token that appears only in the address printed in your terminal. Pages in other browser tabs cannot control it. Do not share that address.

Where your files go

In short: the toolbox's own folder holds only the program. Everything the toolbox writes for you, apart from your videos, goes in your user data folder, a folder in your own account:

Computer Your user data folder How to get there
Windows %LOCALAPPDATA%\PictureOrg\MediaToolbox (for example C:\Users\Anna\AppData\Local\PictureOrg\MediaToolbox) In the dashboard: Settings, then Open Folder next to Your Files. Or Start menu > Spoolwell Video Toolbox > My Reports and Logs. Or paste %LOCALAPPDATA%\PictureOrg\MediaToolbox into File Explorer's address bar.
Mac ~/Library/Application Support/PictureOrg/MediaToolbox Settings, then Open Folder. Or in Finder: Go > Go to Folder..., then paste that path.

Inside it:

  • Reports: the CSV report of every run (the Open CSV Report button opens the newest one). The newest 50 of each kind are kept; older ones are deleted when the toolbox opens. The pages from Find date stamps are kept here too (the newest 20, each with its pictures folder). Copy any you want to keep for longer to another folder.
  • Logs: the dashboards' logs, for troubleshooting. When the toolbox opens, a log longer than 2000 lines is cut back to its newest 2000, so none grows without end.
  • toolbox_settings.json and toolbox_web_settings.json: the two dashboards' saved settings.
  • branding.json: your studio branding, once you have changed it (until then the sample in the toolbox folder is used).
  • recipes.json: your recipes, shared by both dashboards (see The dashboard).

Why: a program installed for everyone lives in C:\Program Files, which Windows protects: only an administrator can change it, so the toolbox can't keep anything there. Keeping your files in your own account also means each person who uses the computer has their own settings and reports, and an update or reinstall never touches them. The standalone zip and the Mac app use the same folder, so it's the same whichever you use. Your license key is kept one level up, in PictureOrg (see License and free trial). Your videos are not affected: outputs go where you choose (usually next to the originals).

Coming from a much older version: versions 1.11.0 and older kept these files inside the toolbox folder. The first time a newer version opens, it copies them into your user data folder; the originals are left where they were, so nothing is lost. It does this once, and writes a note of what it copied (copied-from-older-version.txt) in the user data folder. After that the old copies aren't used, and you can delete them if you like.

File (in the user data folder) Contents
Reports\audit_mp4_report_YYYYMMDD_HHMMSS.csv One row per file (columns below). The other tools' reports (merge_report_, blue_report_, split_report_, aac_report_, retitle_report_, date_report_) are here too.
Reports\media_manifest_YYYYMMDD_HHMMSS.csv Output of the manifest tool (columns in Make a video details inventory)
toolbox_settings.json Saved dashboard settings
recipes.json Your recipes (named sets of a task's choices), used by both dashboards
Logs\dashboard_debug.log Full console output of the latest run. The four runs before it are kept as dashboard_debug.1.log (the run before) to dashboard_debug.4.log.
toolbox_web_settings.json, Logs\web_debug.log The browser dashboard's saved settings and latest-run output (see The browser dashboard); web_debug.1.log to web_debug.4.log are the four runs before
update_check.json The newer-version check: whether it is on, when it last ran, the newest version found and any version you skipped (see Updates)
Logs\dashboard_trace.log Timestamped record of dashboard start-ups, jobs started and finished, shutdowns, and any error that closed the window (the newest 2000 lines are kept; each line shows the window's process number). Send it if the window ever closes unexpectedly.
Logs\dashboard_error.log Dashboard errors (startup failures, unexpected window errors), with timestamps. Created only if something goes wrong. The newest 2000 lines are kept.
Logs/app_launcher.log, Logs/install.log, Logs/uninstall.log Mac only: what the app, the installer and the uninstaller did, each time (see The browser dashboard). The newest 2000 lines are kept.

Read-only folders and studio servers

On every computer: before any work starts, Spoolwell checks that it can write where the new videos go. If it can't (a read-only folder, a drive you don't have permission to change), the job stops at once and says so, instead of failing hours later when the video is saved. Choose an Output Folder somewhere you can write; videos in a read-only folder can still be read. Scans also never look inside snapshot or recycle folders (.zfs, #snapshot, #recycle, @eaDir and the like), which hold another copy of every file. And a name that differs from an existing one only in case (Tape 3-Final.mp4 next to Tape 3-final.mp4) counts as the same name, so Spoolwell never makes the second one.

On a studio ZFS server: Spoolwell recognizes a project kept on a ZFS server with snapshots (a .zfs\snapshot folder in the project or above it) and does two more things there, by itself. Nowhere else does anything change.

  • A job in progress. While a job runs, Spoolwell leaves a small hidden file named .pictureorg-busy-spoolwell-...json in the project folders it works in, and refreshes it every few minutes. Studio ZFS won't send or archive a project while it holds a fresh one. The file is deleted when the job ends, also after Cancel; one left behind by a crash stops counting after 15 minutes.
  • A record of each job. Spoolwell also keeps a short record of each job in the project's hidden .tpo\jobs folder: which task ran, on which computer, when it started and ended, and whether it finished, failed or was cancelled. No file names. Studio ZFS shows the newest one under Background tasks on its status page, and keeps the newest 60 per project.
  • Working files stay on your computer. Trimming and fixing a title make large working files. In a studio project they go only on this computer's own drive: the server's hourly snapshots would keep each deleted working file for weeks. When your drive is too full, that video stops with a message saying how much space it needs, so you can free some and run it again. (Anywhere else, Spoolwell works beside the output when your drive is too full, as it always has.)
  • A locked project (sent to the other studio or archived) is read-only, so the write test above stops a job aimed at it: "This project is locked (sent to the other studio or archived). Choose an Output Folder elsewhere."
  • Nothing directly beside the projects. The folders that hold the projects (such as Projects, ProjectArchives or a year folder) and each project's own folder are managed by the server. Spoolwell never makes, renames or deletes anything directly in a folder that holds projects: aim the Output Folder at a folder inside a project, where anything goes. If you choose the projects folder itself, the job stops at once and says so.

Two things to know on such a server:

  • Free space after deleting. Deleting files from a project doesn't free its space right away: the snapshots keep them until they age out. Free space shown right after a cleanup can look lower than you expect.
  • Getting an original back. Spoolwell's own safety copies (the Old titles folder, a .aac-original file) and the server's snapshots overlap. If a replaced video turns out wrong, right-click the project folder and choose Restore previous versions (or ask for a restore from the snapshots). That works even after Spoolwell has deleted its own copy.

GPU acceleration

The merge and blue-screen tools use your graphics card to encode when they can. It is on by default (Use GPU when available) and needs no setup.

  • Which GPU. Each run tries, in order, NVIDIA (NVENC), Intel (Quick Sync), AMD (AMF), and on a Mac Apple VideoToolbox, with a tiny test encode. The first that works is used and named in the log, e.g. [INFO] Video encoder: h264_nvenc (NVIDIA GPU). If none works, the CPU encoder (x264) is used.
  • Safety net. If the GPU encode fails part way, that file or day is redone on the CPU automatically.
  • Decoding. With Use GPU when available on, the blue-screen tool (scanning, finding the exact edges and re-encoding), the merge tool and Find Scene Changes in the split player also decode on the GPU, and redo the work on the CPU if that fails. The result is the same either way: we checked that every frame of the output is identical with and without GPU decoding. DV (MiniDV) gets no gain: graphics cards have no DV decoder, so DV is always decoded on the CPU, and only other formats (MP4, MOV, MPEG-2 and the like) can be faster. Untick Use GPU when available (or use -NoHwDecode on the command line) to decode on the CPU.
  • Quality and size. GPU encodes are set to their highest-quality modes, aimed at the same visual quality as the CPU setting. For the same quality, GPU files are usually somewhat larger than x264's. Untick Use GPU when available (or use -Encoder CPU) for the smallest files at the cost of time.
  • What stays on the CPU. The validator (Test-Mp4Integrity.ps1) always decodes on the CPU, because a GPU decoder can hide or report corruption differently and the validator's job is to be exact. The manifest only reads file details, so it needs no GPU.
  • Your ffmpeg must include the GPU encoders. The ffmpeg bundled in bin in the Windows package (the gyan.dev "essentials" build) already includes NVENC, Quick Sync and AMF, and the NVIDIA decoder; the Mac package's ffmpeg includes Apple VideoToolbox. Only if you swap in a different ffmpeg do you need to check this. Keep your graphics driver up to date; an old NVIDIA driver is the usual reason NVENC is not found.

Command line

Built-in help. Each script carries its own help text. From a PowerShell 7 window in the scripts' folder:

Get-Help .\Test-Mp4Integrity.ps1 -Full
Get-Help .\Sync-MediaManifest.ps1 -Examples
Get-Help .\MediaToolboxDashboard.ps1

-Full shows the description, every parameter and the examples; -Examples shows just the examples. The scripts are also commented throughout if you want to see how they work.

The validator and the manifest tool need ffmpeg and ffprobe on PATH when run from the command line; the other tools also look in the bin folder next to the scripts. The dashboard adds the folder of the ffmpeg you selected to PATH for the run.

Each tool's own section ends with its command-line examples and parameters.

Troubleshooting

Symptom Likely cause and fix
"Child script not found" The scripts aren't in the same folder. Move them together.
"The FFmpeg binary set in Settings could not be found" None of the saved path, bin\ffmpeg.exe or PATH has ffmpeg. The Settings window opens: fix the FFmpeg Binary path there, put ffmpeg in the bin folder, or add it to PATH.
Deep Analysis ran as a standard scan ffprobe wasn't found (see the console warning). Add it as described in How ffmpeg and ffprobe are found.
FFmpeg path changed by itself The saved path no longer existed, so the dashboard switched to the bundled bin\ffmpeg.exe. This is expected after moving the folder.
Settings don't save The status bar shows the reason. Settings are saved in your user data folder (see Where your files go), which is normally always writable; check that the disk isn't full and that security software isn't blocking AppData\Local\PictureOrg.
Can't find my reports or logs after updating from a much older version They are in your user data folder (see Where your files go): Settings, then Open Folder next to Your Files. The first start after the update copied the old ones there.
Progress shows no percentage ffprobe wasn't found, so total length is unknown. Position and speed still show.
Deep Analysis reports "ffprobe not found" Deep Analysis needs ffprobe to detect the audio and video streams. Without it the scan runs as a standard scan.
The sound is louder but the hiss is too Choose Reduce hiss: Light (or Strong) with the level. The hiss is taken out before the level is raised.
Voices sound watery or hollow after Reduce hiss Strong takes out too much for that tape. Use Light, or Off.
A finished video is left as <name>.partial.mp4 Windows (or the studio server) wouldn't let it take its name, usually because the old copy being replaced was still open in a player or File Explorer. The tool waits and tries again first; if it still can't, it keeps the video and says so in the log. Close whatever has the old copy open, then rename the .partial.mp4 file to .mp4.
Files fail with a harmless-looking warning See Tuning the check ($benignPatterns).
"No supported video targets located" The path has no files with the supported extensions, or Recursive Scan is off.
Manifest shows N/A for a file ffprobe couldn't read it (see the Probe Failures count). The file may be corrupt. Run the validator on it.
"ffprobe could not be found" (manifest) or a console warning about ffprobe (integrity scan) Put ffprobe.exe in the same folder as ffmpeg.exe, in the bin folder next to the dashboard, or on your PATH.
Dashboard window closes a few seconds after opening Run Launch-Debug.bat instead of the Start menu icon. It keeps a console open and shows the error. Also check dashboard_error.log and dashboard_trace.log in the Logs folder of your user data folder (see Where your files go). Common causes: antivirus quarantining the bundled pwsh.exe, or files left blocked after unzipping (see Install). Unexpected errors inside the window are now logged and no longer close it.
The desktop shortcut still shows the old icon Open the toolbox once and the shortcut is pointed at the new icon file. If it still shows the old picture, restart the computer (Windows remembers icons it has shown before).
Desktop shortcut wasn't created The status bar shows the reason and Logs\dashboard_error.log has details. A desktop managed by company policy can block it. You can instead right-click Spoolwell.exe, choose Send to, then Desktop (create shortcut).
User Guide button says the guide wasn't found Put Media-Toolbox-User-Guide.html in a docs folder next to MediaToolboxDashboard.ps1.
Task Manager shows many PowerShell 7 (pwsh.exe) processes after closing the toolbox They may not be the toolbox's: it ends its own when it closes. To see whose they are, add the Command line column in Task Manager's Details tab: the toolbox's show its folder and a script name such as MediaToolboxDashboard.ps1. Each time the dashboard starts, Logs\dashboard_trace.log also lists every other pwsh.exe running, with its command line. To clear old ones, close the toolbox and restart the computer, or in Task Manager's Details tab end the pwsh.exe entries (this also closes any other PowerShell 7 windows you have open).
Browser dashboard: the Folder or File chooser doesn't appear, or does nothing On a Mac, allow the Automation prompt described in The browser dashboard (System Settings > Privacy & Security > Automation, where Terminal must be allowed to control System Events). Look for the dialog behind other windows. You can always type or paste the path instead.
Browser dashboard: "Forbidden" page Open the address printed in the terminal (it contains a one-time token). A link from an old run no longer works.
Browser dashboard: "Lost contact with the dashboard server" The server was stopped or the terminal window was closed. Start it again.
"The trial has ended. Enter a license key to keep using Video Finishing Toolbox." The 21-day trial and its 7 reminder days are over. Click Buy a license at the bottom of the dashboard, then Enter key... and paste the key from your email (see License and free trial).
"That key is not valid" when entering a key Paste the whole key from the email, including the dot in the middle. Spaces and line breaks don't matter. A key for Auto Crop & Straighten alone doesn't unlock the toolbox.
Nothing appears in the console Check Logs\dashboard_debug.log while the job runs. If it's filling up but the window isn't, the message [GUI ERROR] will appear in the log box.

Install

What you need:

  • Windows 10 or 11 for the dashboard window, or a Mac (or Windows) for the browser dashboard. The Mac package needs a Mac with Apple silicon (M1 or later) and, we believe, macOS 14 or later. Intel Macs aren't supported.
  • PowerShell 7 and ffmpeg/ffprobe are included in the packaged folder (runtime and bin, in both the Windows and the Mac package), so nothing else needs installing. If you run the scripts outside the package, you need PowerShell 7 or later and ffmpeg with ffprobe (see "How ffmpeg and ffprobe are found").
  • Nothing has to be writable in the toolbox's own folder: settings, reports (Reports) and logs (Logs) are saved in your user data folder (see Where your files go). It can be in Program Files.
  • Optional: an NVIDIA, Intel or AMD GPU for faster merging and trimming.

Windows

  • Installing: the easy way is ThePictureOrg-Spoolwell-Setup-<version>.exe. It asks who will use the toolbox:

    • Anyone who uses this computer (recommended, the default): installs in C:\Program Files\ThePictureOrg\Spoolwell, with Start menu and desktop icons for every account. Windows asks for an administrator's permission (click Yes; on a computer where you aren't an administrator, the person who is types their password).
    • Only for me: installs in your own account, %LOCALAPPDATA%\Programs\ThePictureOrg\Spoolwell, with no administrator permission.
    • Moving from an older version: older versions installed in C:\Program Files\The Picture Org\Media Toolbox or %LOCALAPPDATA%\Programs\Picture Org Media Toolbox. Setup moves an install from there into the new folder by itself, removes the old program files and remakes the Start menu and desktop icons. Anything of yours left in the old folder stays there, and your user data folder (see Where your files go) is not touched. If the toolbox is running, Setup asks you to let any task finish and close it first.

    Either way it makes a Spoolwell Video Toolbox folder in the Start menu (dashboard, browser dashboard, troubleshooting, User Guide, Cheat Sheet, My Reports and Logs, Uninstall) and, if ticked, a desktop icon. Running a newer Setup updates in place. Your settings, branding, Reports and Logs are in your user data folder (see Where your files go), so installing, updating and uninstalling never touch them unless you tick the box to delete them when uninstalling. If an earlier version is installed only for you and you now choose Anyone, Setup removes the old copy's Start menu and desktop icons (so there aren't two) and offers to remove its program files; your settings, branding, Reports and Logs are kept and the new version copies them to your user data folder the first time it opens. The Setup program is signed by The Picture Org LLC; if Windows still says "Windows protected your PC" (it can while a certificate is new), click More info, then Run anyway. Or unzip the zip to a folder of your choosing; README.txt has the steps, including upgrading and uninstalling.

  • Moving or copying the folder is safe. The dashboard finds the child scripts next to itself, falls back to bin\ffmpeg.exe and bin\ffprobe.exe if the saved path is gone, and stores in-folder paths relative (see Saved fields). Keep both executables in bin.

  • Where to put it (zip): anywhere, including Program Files: the toolbox only reads its own folder. Your settings, logs and reports go in your user data folder (see Where your files go), the same one the installed toolbox uses.

  • First run after downloading a zip: Windows may show a security prompt for Spoolwell.exe, Launch.bat or pwsh.exe. Right-click the zip, choose Properties, tick Unblock and click OK before extracting to avoid it.

  • Sharing the folder (for example on a network drive) is fine: each person's settings, Reports and Logs stay in their own account.

Mac

There are two packages: the Windows one (ThePictureOrg-Spoolwell-Standalone-<version>.zip, or the Setup program) and the Mac one (ThePictureOrg-Spoolwell-Mac-<version>.zip). The Mac package has the same scripts and documents, plus PowerShell 7 and ffmpeg built for Apple silicon (M1 and later), so nothing else needs installing. It needs a recent macOS (14 Sonoma or later; this is inferred from the .NET 10 runtime PowerShell 7.6 uses).

The Mac package is an app, Spoolwell Video Toolbox.app, which comes inside an installer app. Both are signed by The Picture Org (an Apple Developer ID) and notarized (checked by Apple), so macOS opens them without the "can't check for malicious software" warning:

  1. Double-click the zip to unpack it. The MediaToolbox-Mac folder holds Install Spoolwell Video Toolbox, Uninstall Spoolwell Video Toolbox, the README and the documents.
  2. Double-click Install Spoolwell Video Toolbox. macOS may say it was downloaded from the internet and ask whether to open it: click Open. The installer asks before it does anything, then copies the app into Applications > ThePictureOrg (or into Applications > ThePictureOrg in your home folder, if your account can't add apps to the main one), replacing an older copy (also one directly in Applications, where older versions went), and shows the next steps. If the toolbox is running, it asks you to click Quit on its page first. What it did is written to Logs/install.log in your user data folder.
  3. Open Spoolwell Video Toolbox from Applications > ThePictureOrg, or Launchpad. If you kept the app in the Dock, drag it in again from Applications > ThePictureOrg. The dashboard opens in your browser. To stop it, click Quit on the page (or just close the tab: it stops by itself 10 minutes later).

You can now delete the zip and the unpacked folder.

Your files on a Mac are in ~/Library/Application Support/PictureOrg/MediaToolbox (see Where your files go), never inside the app, so installing a new version or removing the app keeps them. Settings and branding from an older Mac package (a MediaToolbox-Mac folder in Downloads, Desktop, Documents or Applications) are copied there the first time a newer version opens.

Removing it: double-click Uninstall Spoolwell Video Toolbox (or drag the app to the Bin). It asks first. Your settings, Reports, Logs and license key are kept; the uninstaller says where they are if you want to delete them too.

Does it run on an Intel Mac? No. Spoolwell needs a Mac with Apple silicon (M1 or later). On an Intel Mac the installer, the app and the Lightroom plug-in say so and stop. The Windows version runs on any 64-bit Windows 10 or 11 PC.

Updating on a Mac. The app is signed, and changing anything inside it would break that, so current PowerShell and ffmpeg come with each new Mac package To move to a new Mac package, just run its installer.

Untested so far: the Mac package was put together on Linux and has not yet been run on a Mac. If the app doesn't open the dashboard, look in Logs/app_launcher.log in your user data folder, or open Terminal and run bash "/Applications/ThePictureOrg/Spoolwell Video Toolbox.app/Contents/Resources/launcher.sh" and then look in that log. A disk image (.dmg) to drag the app from, the usual Mac way, may come in a later version.

Lightroom Classic plug-in

Installing it. Setup (Windows) and Install Spoolwell Video Toolbox (Mac) put the plug-in in Lightroom's Modules folder for you; restart Lightroom and it is there. Updates (Install Update in the dashboard or in the plug-in, or a new Setup or Mac download) update it too; restart Lightroom afterwards. With the Standalone folder, or for another account on a computer where the toolbox is installed for everyone, open the dashboard once (Windows), or add it yourself: in Lightroom, File > Plug-in Manager > Add, then choose Spoolwell.lrplugin in the toolbox folder (on a Mac it is inside the app: right-click Spoolwell Video Toolbox in Applications > ThePictureOrg, Show Package Contents, then Contents > Resources).

License and free trial

The toolbox is free to try for 21 days, with every feature. The bottom right of either dashboard shows the days left, for example Free trial: 14 days left.

  • After the 21 days the toolbox keeps working for 7 more days, and a reminder opens each time you open the dashboard, with Buy a license and a box for the key.
  • After those 7 days the dashboard still opens, but Execute Task and the split player don't start until a license key is entered; a window explains why and has the box for the key. Your settings, reports and every file you have already made stay available.

Buying and entering a key. Click Buy a license at the bottom of the dashboard. The license key comes by email. Click Enter key... (or Enter Key... under License at the bottom of Settings), paste the whole key (it has a dot in the middle; spaces and line breaks don't matter) and click Save Key. The bottom of the dashboard then says Licensed to and your name. If the key is refused, the window says why (for example, a key that isn't complete, or a key for Auto Crop & Straighten alone).

What a license covers. One person, on up to 2 computers. Updates are complimentary within the major version: a key for version 1 works with every 1.x version. The full terms are in LICENSE.txt.

Moving to another computer. Click Remove license from this computer at the bottom of the dashboard (it asks first), then enter the key on the new computer. A bundle key for the toolbox and Auto Crop & Straighten unlocks both programs, and removing it removes it from both on that computer (the dashboard says so before it does).

Where the key is kept. In your user account, not in the toolbox folder, so it survives upgrades, the Setup program and moving the folder: %LOCALAPPDATA%\PictureOrg on Windows, ~/Library/Application Support/PictureOrg on a Mac. Each Windows or Mac user account on a computer enters the key once.

Command line. The tool scripts check too. After the trial and its reminder days, they print the reason and stop with exit code 9 before doing any work; during the reminder days they print a warning and carry on. The launchers are never stopped.

Updates

The dashboard checks by itself whether a newer version of the toolbox is out every time it opens. It reads a short list of current version numbers from The Picture Org's download service (the same list Auto Crop & Straighten uses). Nothing else is sent: not your name, your license key, your files or anything about your computer. If there is no internet connection, nothing is shown and the toolbox works as usual.

When a newer version is out, a bar appears at the top of the dashboard, just under its title (in either dashboard), once each time you open the dashboard:

  • Install Update (Windows): the toolbox installs the new version itself. Click it, then OK: the toolbox closes, a small window downloads the update, checks that it really comes from The Picture Org (its checksum and The Picture Org's release signature, and that every script is signed by The Picture Org LLC), puts the new files in place and opens the dashboard again. If the toolbox is installed for everyone (in Program Files), Windows asks for an administrator's permission first: click Yes. (Up to 1.16.6 it didn't ask, and the update stopped with Access to the path is denied; install 1.16.7 once with the full Setup, and later updates install themselves.) If anything goes wrong, the old files are put back and nothing is changed; the window says why, and you can use Download instead. The previous version's files are kept in a .update-backup folder inside the toolbox folder. PowerShell and ffmpeg are not part of these small updates. Let any running task finish first: Install Update starts only when no task is running. If another Spoolwell window is still open (a second dashboard, the browser dashboard, a command from Lightroom), the small window names it and offers to close it for you before installing. What happened is written to Logs/update_install.log in your user data folder.
  • Install Update with the full installer (on a Mac, and for a version that comes with a new PowerShell or ffmpeg, or when your copy is too old for the small update): the toolbox closes, downloads the full Setup (on a Mac, the Mac download), checks its checksum and that it is signed by The Picture Org LLC (on a Mac, also that Apple accepts it), and starts it. Follow the installer's steps; it keeps your settings, Reports, Logs and license key. If a check fails nothing is started, and you can use Download instead.
  • Download opens the download in your browser. Close the toolbox, then run the new Setup from the download (on a Mac, open Install Spoolwell Video Toolbox). Your settings, studio branding, Reports, Logs and license key stay as they are (see Where your files go).
  • What's New opens the Tools page on our website, with what changed in each version.
  • Not Now hides the bar until the next time you open the dashboard.
  • Skip This Version stops the reminders for that version; you are told again when a later one comes out.

Nothing is downloaded or installed until you click Install Update or Download. Updates within the major version are complimentary: a version 1 license key works with every 1.x version (see License and free trial).

Menu > Check for updates asks straight away: a newer version shows the bar at the top of the dashboard (even one you skipped), otherwise a message says you have the latest version, or why the check failed (for example no internet connection). Settings > Updates shows the version you have and the result of the last check, with the same Check Now; when it finds a newer version, Settings closes so you see the bar. Untick Check for updates automatically to stop the daily check; Check Now still works. The choice is shared by both dashboards and kept in update_check.json in your user data folder.

Spoolwell's PowerShell and ffmpeg are the versions it was tested with, and they are updated only by a new Spoolwell version.

Updating from Lightroom

The first time you use a Spoolwell command after Lightroom starts, the plug-in checks for a newer version (the same short version list as the dashboard, Updates; nothing about you or your files is sent). When one is out, the next command offers it once per Lightroom session: Install update, Not now or Skip this version. The Plug-in Manager's Updates section shows what the last check found, with Check now and What's new, Download installer and Install update when a newer version is out, and a tickbox to turn the automatic check off (shared with the dashboard's). Install update does what the dashboard's Install Update does: on Windows a small window downloads the update, checks The Picture Org's signature, installs it and refreshes Lightroom's copy of the plug-in; for a version that comes with a new PowerShell or ffmpeg, and on a Mac, it downloads the full Setup or Mac installer, checks its signature and starts it. Close the Spoolwell dashboard first if it is open. Then restart Lightroom Classic.

Help

Create an error log. If something isn't working and you'd like help, click Menu > Create an error log (in both dashboards; it is also in Settings). It saves one text file on your Desktop, named like Video Toolbox error log 2026-10-17 0915.txt, and shows it in Explorer or Finder. A window then offers to send it to The Picture Org for you. It holds:

  • the toolbox, Windows or macOS, PowerShell and ffmpeg versions;
  • your settings from both dashboards, with any license key left out and files and folders shown only as (set) or (blank);
  • for each run in the logs, a Settings used line near its start with every choice that run used (Preview only, Replace existing, quality, sound and so on), but never a folder, file name, family name or title (1.17.4);
  • the end of every log in the Logs folder (see Where your files go), including the last 5 runs;
  • the newest Report.

Your home folder is shown as ~, so your account name isn't in it. The names of your videos and their folders can appear in the logs; the videos themselves never do.

Sending it. The window shows exactly what would be sent. Your user name, computer name, email addresses, license key and the name on your license are taken out too, and you can delete anything else in the box. Add a line on what went wrong and, if you'd like an answer, your email, then click Send to The Picture Org. You get a reference number. Nothing is sent unless you click Send; Close sends nothing, and the file stays on your Desktop. Reports are kept for 90 days and used only to fix the problem (Privacy policy opens the details). If it can't be sent, for example with no internet, email the file on your Desktop to john@thepictureorg.com instead. The Lightroom plug-in's Spoolwell: Create an error log offers the same.

Each script's own help. Each script carries its own help text: Get-Help .\Test-Mp4Integrity.ps1 -Full (see Command line).

Appendix: What's new

  • 1.17.8: Show Title Sample lists the title of every video the job will make, and you can change any of them before it runs.
  • 1.17.7: Make smaller's quality check shows its progress in the video's own time (it showed times far past the video's length and stopped at 89%). If a Spoolwell window is stopped from outside, the next window notes why in its trace log, so an error log shows it.
  • 1.17.6: Settings > Reset to defaults puts every choice in both dashboards back to how Spoolwell first starts. Your studio branding, recipes, license, Reports and Logs are kept.
  • 1.17.5: Right-clicking Spoolwell on the taskbar and choosing Pin to taskbar pins Spoolwell itself (it used to pin PowerShell). If you pinned it before, unpin that icon and pin Spoolwell again.
  • 1.17.4: Preview only starts unticked every time Spoolwell opens, so a run makes files unless you ask for a preview. When a preview finishes, the status says Preview finished: nothing was made and the log says how to make the files. Each run's log starts with a Settings used line, so an error log shows the choices that run used.
  • 1.17.3: Convert a DVD with the check on no longer fails a good copy: when FFmpeg hands the check the frames out of step, it lines them up. The Sound choices for Convert a DVD now work from the desktop dashboard. A title skipped because its MP4 is already there says how to make it again.
  • 1.17.2: A DVD, a tape capture or any standard-definition or interlaced video is now checked with SSIM instead of VMAF, so a good DVD copy passes. Convert a DVD has the Sound choices (louder, with a limiter so nothing clips), also in Lightroom. Convert a DVD moved to the Make videos group, and Target Media says to point at the VIDEO_TS folder.
  • 1.17.1: The picture check now compares interlaced video (DVDs, DV tapes) as whole pictures, the way a player shows them, so a good copy is no longer failed with a low score. A different frame count is reported as such.
  • 1.17.0: Convert a DVD makes MP4s with AAC sound from a copied DVD, one per title, keeping the interlaced picture as it is, with an optional smooth copy for phones and the web (see Convert a DVD). In Lightroom: Convert DVD to MP4....
  • 1.16.12: Check videos with Deep Analysis no longer reports a title card's still picture and silence as a freeze and silence at the start of every video (see What the check looks for). Make videos smaller, Sound to AAC and Set a video's date now keep the title stored in the video, so Fix a title and the check still find it afterwards.
  • 1.16.12: Merge by day, Trim blue screen and Split a video have a Make the new videos smaller box, on by default: their new videos then go through Make videos smaller, checked as always (see Make the new videos smaller). The same box is in their Lightroom windows.
  • 1.16.12: on a Mac, Spoolwell needs Apple silicon (M1 or later); Intel Macs aren't supported. In Lightroom the check's keywords are now Picture Org > Problem found and Picture Org > Warning, under the one Picture Org keyword all our plug-ins share. Install Update only starts a full installer that carries our release signature.
  • 1.16.11: in Lightroom, Library > Plug-in Extras > Set a Video's Date... writes the date you type into the selected videos and sets their Capture Time to match, as the dashboard's Set a video's date does (see Set a video's date).
  • 1.16.10: Trim blue screen and Fix a title read each video faster, and Lightroom reads the selected videos in one go. The Keyboard shortcuts window in Lightroom can give a key to another plug-in's menu item, such as Negative Lab Pro, by its name. Each tool's log ends with a [STATS] line (programs started and time taken).
  • 1.16.9: in Lightroom on Windows, the Plug-in Manager's Updates box shows the whole message instead of cutting it off after the first line.
  • 1.16.8: fixes from a security and quality review: steps that were skipped quietly are now written to the log, and in Lightroom on Windows a path with a double quote (") is refused with a message before anything runs.
  • 1.16.7: a Menu at the top right of both dashboards, as in the other -well apps, with Check for updates (the answer shows at once), Settings, License, the error log and Quit. Install Update now asks for administrator permission when Spoolwell is installed for everyone, instead of stopping with Access to the path is denied.
  • 1.16.6: Choose your own keys for Spoolwell's Lightroom commands: click Keyboard shortcuts in Lightroom (see Your own keys in Lightroom). They keep working however many plug-ins you add. In a studio ZFS project, Spoolwell keeps a record of each job for Studio ZFS's Background tasks list.
  • 1.16.5: Video inventory shows each video's codecs on screen as well as in its spreadsheet: the video codec and profile, picture size and shape, frame rate, interlaced or progressive, every sound track, and the length, size and data rate. In Lightroom, Make a Video Details Inventory... shows the same when it finishes.
  • 1.16.4: Make videos smaller no longer fails a video when its quality check runs out of memory: VMAF uses fewer workers, and if it still can't get the memory, the same frames are checked with SSIM instead. Closing the Windows dashboard after a job has finished no longer asks Spoolwell is still working.
  • 1.16.3: Make videos smaller shows each video's size before and after, the percentage saved and the data rate before and after, in the log, the report and the Lightroom message. Its check is faster: Check Quick (the default) compares one frame in ten; Full and Off are the other choices. Minimizing the Windows dashboard puts it on the taskbar like any other app, instead of in the system tray.
  • 1.16.2: Make videos smaller, a new task: much smaller files that look and sound the same, each one checked frame by frame against its original before it is kept (see Make videos smaller). Also in Lightroom and on the Stream Deck. The dashboards use The Picture Org's own colors. In Lightroom, a progress bar shows the moment you pick a command, and clicking again while it works no longer starts a second copy. The User Guide shortcut in the Start menu has its own page icon.
  • 1.16.1: Stream Deck buttons come with Spoolwell (press ? and click Add Stream Deck buttons), and each Spoolwell window in Lightroom has a User Guide button.
  • 1.16.0: a key for every button in both dashboards (press ? to see them), and the same actions, and the Lightroom commands, for a Stream Deck with Spoolwell.exe --do (see The dashboard).
  • 1.15.0: Find date stamps, a new task: the frames where the camcorder's date is on the screen, with the first and last dates as close-ups on a page (see Find the camcorder's date stamps). Also in Lightroom. The update notice sits at the top of the Windows dashboard.
  • 1.14.4: closing the dashboard, or the Lightroom progress bar, while a job runs asks first, with Keep working or Quit anyway.
  • 1.14.3: minimizing the Windows dashboard sends it to the system tray instead of closing it.
  • 1.14.2: Trim blue screen also cuts the vertical lines and static a tape shows when the camera was stopped, at the start and end and next to the blue (see Trim the blue screen). An Open logs folder button at the right of the console log bar, to look back at earlier runs. Minimizing the Windows dashboard now really sends it to the system tray, and the Minimize to Tray button is gone (see The dashboard).
  • 1.14.1: in Lightroom, when only one video is selected while a folder is chosen, Spoolwell asks whether you meant every video in the folder (see Work from Lightroom Classic).
  • 1.14.0: a tidier dashboard, in Windows and in the browser. The tasks are a grouped list on the left (Check, Make videos, Fix finished videos), and the panel opens with the task's name and what it does. Recipes save a task's choices under a name, such as Client VHS, to fill them in again with one click. Merge, trim and split keep the choices most jobs leave alone under More options, with a one-line summary of what is set, and the console log stays folded until a job runs (see The dashboard).
  • 1.13.13: Create an error log can send the report to The Picture Org for you, in both dashboards and the Lightroom plug-in. You see exactly what is sent first, with personal details taken out, and nothing goes unless you click Send (see Help).
  • 1.13.12: on Windows the dashboard opens with no PowerShell or Windows Terminal window beside it, so it is the only window you see. The Start menu and desktop icons now start Spoolwell.exe; older icons are changed the next time the dashboard opens.
  • 1.13.11: the Windows dashboard fits on a smaller screen and scrolls when you make the window shorter, so every option can be reached. The break-point player fits the screen too.
  • 1.13.10: a Sound setting for a merge, a blue-screen trim or a split: Louder by a number of dB with a limiter, or As loud as possible, and Reduce hiss (Light or Strong). Set Sound Level... plays a few seconds of the tape at that level so you can hear it first (see Raise the sound and reduce tape hiss).
  • 1.13.9: a finished video is no longer lost when Windows won't let it take its name at the end of a job ("Access to the path is denied"). The tool waits and tries again, and if that fails it keeps the video as .partial.mp4 and says so. Full re-encode (used with black bars), Copy only and merging now work on your PC's own drive and copy only the finished video to a server, as smart cut already did. With Family name blank, a title card takes the family name from the project folder, or a folder with "family" in its name (see Title card or overlay).
  • 1.13.8: Black Bars for a merge, a blue-screen trim or a split: cover a ragged top or bottom edge with black without changing the picture's size or shape. Set Black Bars... opens a frame with two lines to drag, and Show Sample shows the finished look (see Cover a ragged edge with black bars).
  • 1.13.7: Title Text and Second Line boxes when you start a merge, a blue-screen trim or a split, so a tape's title can be set before it is made, with the same choices as Fix a title. Show Title Sample fills them in for a single tape, and its window has a Looks right button that starts the job (see Type the title for a tape).
  • 1.13.6: Trim blue screen also cuts silent black at the very start and end of a tape (Cut silent black at the start and end, on by default; black in the middle is kept). When a job makes nothing because its output is already there, Spoolwell now says so instead of just finishing.
  • 1.13.5: the dashboard opens again (1.13.3 closed as soon as it started), and Install Update names any other Spoolwell window still open and offers to close it. The Update ffmpeg tile is gone: new ffmpeg and PowerShell versions now come only with a Spoolwell version they were tested with. Two tiles have clearer names: Merge DV video files by day and Video details inventory. The new Set a video's date tile gives a video the date you type, for one that was given the wrong date (see Set a video's date). Spoolwell is now the Spoolwell™ Video Finishing Toolbox (only the name changed), and in Lightroom Make a Storage Manifest... is now Make a Video Details Inventory....
  • 1.13.3: Spoolwell checks for a newer version every time it opens, not once a day, and in Lightroom the first Spoolwell command after Lightroom starts checks too.
  • 1.13.2: a job whose output folder can't be written to stops before any work and says so, scans skip snapshot folders, and on a studio ZFS server a running job tells the server so the project isn't sent or archived halfway through (see Read-only folders and studio servers). The dashboards show the tasks as tiles with plain names (Check videos, Merge by day, Trim blue screen and so on) instead of a list of script names, Show Title Sample draws the first titles exactly as they will look before anything is made, and Auto-Move puts broken videos in an _On Hold folder (it was failed, which scans still skip).
  • 1.12.9: blue that runs to the end of a tape is cut even when there is sound under it (tape hiss), and an Output Folder given as just a name is made inside the folder you're working on (before, it went into Spoolwell's own program folder and the job failed).
  • 1.12.8: Install Update in the Windows dashboard works after a job has run, and Setup asks you to close the toolbox when it is open, instead of stopping on a file in use.
  • 1.12.7: trimming the blue screen with a title card keeps the sound in step with the picture (some players started the sound under the card and rushed the start of the video), and captures whose picture starts a moment after their sound are trimmed in sync.
  • 1.12.6: this guide has a new order: what Spoolwell is and a Quick start first, then one section for each job, and the version history here at the end.
  • 1.12.5: a User Guide button in Lightroom's Plug-in Manager and the dashboards opens the guide on thepictureorg.com (the copy that came with Spoolwell when you're offline), and Other -well tools opens the Tools page. The home page button opens Spoolwell's own page, the Plug-in Manager's Updates box looks like the other Picture Org plug-ins, and a finished job says how long it took.
  • 1.12.4: update from Lightroom: the plug-in checks once a day, offers a new version before a command, and has Check now and Install update in the Plug-in Manager.
  • 1.12.3: the Lightroom plug-in no longer stops with an "attempt to call field 'getenv'" error on Windows, and is listed in Lightroom as tpo: Spoolwell™.

Earlier versions: see CHANGELOG.txt.

Appendix: What's in the folder

File Purpose
MediaToolboxDashboard.ps1 The dashboard window. Launches the other scripts, shows live progress, saves your settings.
MediaToolboxWeb.ps1 The browser dashboard for macOS (and Windows). Does the same job in your web browser. See The browser dashboard.
Test-Mp4Integrity.ps1 The validator. Fully decodes each video with ffmpeg and reports PASS / WARN / FAIL. Can also run in Deep Analysis mode.
Sync-MediaManifest.ps1 Inventory tool. Reads each media file's technical details (codecs, resolution, bitrate and so on) with ffprobe and writes a CSV manifest. See Make a video details inventory.
Merge-VideosByDate.ps1 Turns a folder of tape captures (AVI/DV, NTSC or PAL) into one MP4 per recording day, dated from the day's first clip. See Merge tape captures by day.
Remove-BlueScreen.ps1 Trims the VCR blue screen from the start, end and middle of analog tape captures, re-encoding only around each cut. See Trim the blue screen.
Split-VideoAtMarks.ps1 Splits one video into separate videos at break points you mark in the dashboards' player (or type in). See Split a video at break points.
Show-BreakPlayer.ps1 The Windows dashboard's player window for marking break points. It runs as its own program, so if Windows' video playback fails on a file, only the player closes. See Split a video at break points.
Find-SceneChanges.ps1 Suggests break points where the picture suddenly changes scene, for you to check in the player before splitting. See Split a video at break points.
Convert-AudioToAac.ps1 Converts the sound in videos (PCM, FLAC, AC-3 and so on) to AAC, copying the picture untouched and keeping the file name. Checks every new file before it is used. See Convert the sound to AAC.
Replace-VideoTitle.ps1 Redraws the title card or overlay of a finished video (a spelling fix, a missed line), keeping the rest of the picture and the sound untouched. See Fix a title.
Find-DateStamps.ps1 Finds the frames where the camcorder's date is on the screen and shows them on a page. See Find the camcorder's date stamps.
Set-MergedVideoDate.ps1 Sets the date of finished videos: the date you type (Set a video's date in the dashboard), or, on the command line, the first original clip's date for MP4s that were merged elsewhere (for example in UniConverter).
PictureOrgLicense.ps1 Checks the free trial and the license key, for the dashboards and the tools. See License and free trial.
ToolboxPaths.ps1 Says where the toolbox keeps your settings, branding, Reports and Logs (your user data folder, Where your files go).
ToolboxUpdateCheck.ps1 Checks whether a newer version of the toolbox is out, each time a dashboard opens (see Updates).
ToolboxJobs.ps1 Builds each tool's command from your choices, for the browser dashboard and the Lightroom plug-in alike, so both run a tool the same way.
Spoolwell.lrplugin The Lightroom Classic plug-in (see Work from Lightroom Classic).
Spoolwell-Lr.ps1 The plug-in's link to the toolbox: it runs the tools on the videos selected in Lightroom (see Work from Lightroom Classic).

Keep all scripts in the same folder. The dashboard looks for the child scripts next to itself. It only reads that folder; your settings, reports and logs go in your user data folder (see Where your files go).

A self-contained copy is laid out like this:

MediaToolbox\
  Spoolwell.exe               starts the dashboard (no console window); the Start menu and desktop icons use it
  Launch.bat                  starts the dashboard too (Windows 11 may show a terminal window beside it)
  Launch-Debug.bat            same, but keeps a console open to show errors
  Launch-Web.bat              starts the browser dashboard on Windows
  Launch.command              starts the browser dashboard on a Mac with Homebrew's PowerShell (the Mac package is an app instead, [The browser dashboard](#the-browser-dashboard))
  MediaToolboxWeb.ps1         the browser dashboard
  docs\                       User Guide (HTML, opened by the User Guide button), Cheat Sheet (HTML and PDF)
  assets\                     logo.png (top-left logo), app-icon.ico (the toolbox icon; shortcut.ico is the same picture under its older name), fonts\ (title font)
  MediaToolboxDashboard.ps1   the dashboard
  Test-Mp4Integrity.ps1       the validator
  Sync-MediaManifest.ps1      the manifest tool
  Merge-VideosByDate.ps1      merges tape captures by day (see [Merge tape captures by day](#merge-tape-captures-by-day))
  Remove-BlueScreen.ps1       trims blue screen (see [Trim the blue screen](#trim-the-blue-screen))
  Split-VideoAtMarks.ps1      splits a video at break points (see [Split a video at break points](#split-a-video-at-break-points))
  Show-BreakPlayer.ps1        the Windows player window for marking breaks (see [Split a video at break points](#split-a-video-at-break-points))
  Find-SceneChanges.ps1       suggests break points at scene changes (see [Split a video at break points](#split-a-video-at-break-points))
  Convert-AudioToAac.ps1      converts the sound to AAC (see [Convert the sound to AAC](#convert-the-sound-to-aac))
  Replace-VideoTitle.ps1      replaces a title card or overlay (see [Fix a title](#fix-a-title))
  Set-MergedVideoDate.ps1     sets a video's date (Set a video's date task)
  Find-DateStamps.ps1         finds the camcorder's date on the screen
  POHotkeys.ps1               the dashboard's keys and the actions a Stream Deck runs
  po-hotkeys-page.html        the same keys for the browser dashboard
  ThePictureOrg-StreamDeck.streamDeckPlugin   the Stream Deck plug-in (Add Stream Deck buttons opens it)
  Spoolwell-hotkeys.json      the list of keys and action names
  Apply-Updates.cmd           switches in a downloaded PowerShell; the launchers call it
  README.txt                  installing, upgrading and uninstalling
  CHANGELOG.txt               what changed in each version
  LICENSE.txt                 the terms of use (21-day free trial, then a license key; not to modify or resell)
  PictureOrgLicense.ps1       checks the trial and the license key (see [License and free trial](#license-and-free-trial))
  ToolboxPaths.ps1            where your settings, branding, Reports and Logs are kept (see [Where your files go](#where-your-files-go))
  ToolboxCommon.ps1           helpers the processing tools share (they won't start without it)
  tests\                      Test-Toolbox.ps1 (checks the tools on test clips it makes; needs only ffmpeg) and
                              Measure-EncoderQuality.ps1 (compares GPU encoders with the CPU one on a clip of yours)
  ToolboxUpdateCheck.ps1      checks for a newer version of the toolbox (see [Updates](#updates))
  NOTICE.txt                  copyright and the licenses of the bundled FFmpeg, PowerShell and font
  branding.json               the sample studio branding; your own is saved in your user data folder (see [Trim the blue screen](#trim-the-blue-screen))
  bin\                        ffmpeg.exe and ffprobe.exe, with FFmpeg's license (LICENSE-ffmpeg-GPLv3.txt)
  runtime\pwsh\               portable PowerShell 7 for Windows (pwsh.exe)

Reports, Logs and settings are not in this folder: they are in your user data folder (see Where your files go). The Mac package has the same files inside Spoolwell Video Toolbox.app (see The browser dashboard).

Inside the Mac app. What's where inside the app (right-click > Show Package Contents): Contents/MacOS/MediaToolbox is a small signed starter program that runs Contents/Resources/launcher.sh; Contents/Resources holds the toolbox; runtime/pwsh-macos/ there holds PowerShell, bin/ffmpeg and bin/ffprobe are ffmpeg, and lib/ holds the libraries ffmpeg needs. They are the conda-forge community builds, unchanged; their licenses are in runtime/licenses-macos/. runtime/fontconfig/fonts.conf tells ffmpeg where the Mac's fonts are. The app's own messages go to Logs/app_launcher.log in your user data folder.

Appendix: License and credits

© 2026 The Picture Org LLC. Free to try for 21 days, then a license key is needed (see License and free trial); not to be modified or resold; see LICENSE.txt. Includes PowerShell, © Microsoft Corporation (MIT License), and FFmpeg, © 2000-2026 the FFmpeg developers (GNU GPL version 3). Microsoft, Windows and PowerShell are trademarks of the Microsoft group of companies; FFmpeg is a trademark of Fabrice Bellard; other names are trademarks of their owners. See NOTICE.txt.

This is the User Guide that comes with Spoolwell, kept up to date with each release. Questions: info@thepictureorg.com · Spoolwell home page · All the -well tools