Spoolwell finishes home movies and tape transfers. It can:
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:
ThePictureOrg-Spoolwell-Setup-<version>.exe; on a Mac unzip ThePictureOrg-Spoolwell-Mac-<version>.zip and open Install Spoolwell Video Toolbox (see Install).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.
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.
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:
._something.mp4 (small files macOS leaves on FAT and exFAT drives) are skipped.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
Supported containers: .mp4, .mov, .mkv, .avi, .m4v.
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.
-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.$benignPatterns list near the top of Test-Mp4Integrity.ps1.# 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) |
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.
[SYNC] line in the log says by how much (in ppm). -NoAudioStretch turns this off.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.
.\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).
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.
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.
-MinPartSeconds changes it).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.
.\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).
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.
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.
Dashboard: click Split a video in the task list and pick the video with File....
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:
# 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).| 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.
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
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.0 names the first part, or skips it.# 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..\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.
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.
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.
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.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.
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.
Reports\Title samples in your user data folder (the last five samples). On the command line, -TitleSample <folder> does the same.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.
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.
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:
| (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.
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.
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.
-MaskTop and -MaskBottom.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.
-SoundGain 6, -SoundMax and -Hiss Light (or Strong).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.
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.
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:
.MTS into MP4), every decoded frame is compared instead.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).
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:
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).
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.
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.
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
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.
.\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 |
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:
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.
.\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 |
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.
.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.Logs/lightroom_run.log in your user data folder (see Where your files go), and goes into the error log.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.
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:
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.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 tools say so before anything starts.-NameSuffix Final to Merge-VideosByDate.ps1, Remove-BlueScreen.ps1, Split-VideoAtMarks.ps1 or Convert-AudioToAac.ps1. Without it, the scripts add no ending.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.
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.
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
_On Hold folder next to it. It is ticked by default on first launch; after that the dashboard remembers your choice. See Quarantine.Buttons
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.
For ffmpeg, the dashboard looks in this order and uses the first that exists:
bin\ffmpeg.exe next to the dashboard script (the packaged layout).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:
ffprobe.exe in the same folder as the ffmpeg being used.bin\ffprobe.exe next to the dashboard script.ffprobe on your PATH.It can therefore live in a different folder from ffmpeg. If none is found:
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
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.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.
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:
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. |
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.
.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..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.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:
.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.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.
[INFO] Video encoder: h264_nvenc (NVIDIA GPU). If none works, the CPU encoder (x264) is used.-NoHwDecode on the command line) to decode on the CPU.-Encoder CPU) for the smallest files at the cost of time.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.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.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.
| 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. |
What you need:
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").Reports) and logs (Logs) are saved in your user data folder (see Where your files go). It can be in Program Files.Installing: the easy way is ThePictureOrg-Spoolwell-Setup-<version>.exe. It asks who will use the toolbox:
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).%LOCALAPPDATA%\Programs\ThePictureOrg\Spoolwell, with no administrator permission.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.
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:
MediaToolbox-Mac folder holds Install Spoolwell Video Toolbox, Uninstall Spoolwell Video Toolbox, the README and the documents.Logs/install.log in your user data folder.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.
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).
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.
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.
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:
.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.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.
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.
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:
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).
Spoolwell.exe --do (see The dashboard).Spoolwell.exe; older icons are changed the next time the dashboard opens..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)._On Hold folder (it was failed, which scans still skip).Earlier versions: see CHANGELOG.txt.
| 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.
© 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