Capture Naming Guide

Why a Naming Guide?

Due to ever growing format support and the agnostic, openly standardised methods, the ability to accurately handle, store, communicate and collaborate with sample data is key but also helps you the end user in the long run.

As such this naming guide has been expanded into a basic data management guide.

You can submit sample data in single folders/files or even in mass to the public shared drive

The Key Simple Stuff

FLAC compressed final captures are preferred for archival, and long term storage with context provided in both the name and the extension, the decoders are RAW/FLAC file agnostic same with bit-depth so as long as the correct sample rate is known alongside the TV system you are good to go.

Add VCR/Player/Camera used and or original source of media generation if known this keeps track of what came from ware.

External .txt or .md or .pdf for supporting documentation files are recommended also screen snips of Black SNR/Dropouts from ld-analyse if not the entire .JSON alongside.

Image data of the physical cassette for easy high resolution scans of labels use a flatbed scanner at 1200dpi although 600dpi or a phone photo will work if that's all you have.

Tools recommended for windows users is Everything & WinDirStat these make life easier when doing mass file management.

Checksums

The point of checksums today is to verify a clean file upload or download and backups are still clean, this is both a data corruption/manipulation detection system but an foundation for offline or archival storage systems, if you cant verify something is wrong early it could be too late to recover.

Key value in doing this is confirming data moved from HDD/SSD system to system and or burned to M-Disks for example is an exact copy without system or user errors in the process.

RapidCRC / TeraCopy - Windows GUI Tools

GTKHash - Linux GUI Tool

How this works is it computes a unique hash value for every single byte of data this looks like the following:

CRC: 2E462BD1

SHA3-512:9C6269C2D26B37B6086CDFC443FA31B20FF9BF5D68A12299FB3E9A275FA36DC8D6CFD32ABCBBFD43C64DEA5947F8BD7E70C84420CDCA85AEEA56654B0202097C

MD5 is small enough to embed into file names for quick check.

Sha3-512 can be easily stored as a file and within an documentation file for absolute check.

An combination of CRC/MD5 & Sha3-512 is recommended for data integrity validation although it should be noted CRC32 can be embedded into files stored on NTFS systems like what windows uses.

Although FLAC/RAW files have an degree of redundancy and the time base corrected files are header-less so a few bit flips wont destroy captures easily this process is more about ensuring the .json & supporting files remain in tact.

Formatting Captures:

Both - and _ are legal separator, spaces in file names is a hassle with Linux and UNIX systems so its best to avoid them all together on RF data as it avoids conflicts and allows copy pasting.

For sample sharing just add an username tag (typically discord etc) to the beginning of the name this way its easy to reference who added the sample.

MediaName - MediaType - TV System - VCR_Name - Capture_Device - Gain - BitDepth - SampleRate

Example 1: User Submission

Harrypm-Dialog_2001-vhs-pal-DdD-gain-2.02-Panasonic_AG7150-2022-12-11_04-37-13.lds

Example 2:

Dialog_2001-svhs-ntsc-Panasonic_AG1980P-CX_Blue_Stock-gain22-cxadc3-2022-12-11.vhs

Example 3:

THX_Disk-ld-pal-CX_White_Modified-Gain5-8-bit-20mhz-2022-12-11.u8

Example 4:

EBU_Colourbars-vhs-pal-Panasonic_950B-16msps-8bit-2022-12-11.vhs

Tape type should always be in file name if the .vhs or .svhs or new format extensions are not used i.e the .ldf/.flac/.u16/.u8 etc

CXADC Designators:

Stock CX Card captures can use the CXADC Designators.

--cxadc 28.6 MHz/8-bit (8fsc)

--cxadc3 35.8 MHz/8-bit (10fsc) (No longer recommended for capture)

--10cxadc 14.3 MHz/16-bit (4fsc) (Technically 4fsc NTSC*)

--10cxadc3 17.9 MHz/16-bit (5fsc) (Technically 4fsc PAL*)

-f 20 20Mhz8-bit - Standard Current Driver Capture

40msps 8-bit - Modified CX Card (40Mhz Crystal Mod decodes automatically)

DomesDayDuplicator Designators

.LDS 40msps Non-Compressed

.LDF 40msps FLAC Compressed

FLAC Compressed Naming Designator's

VHS - .vhs

S-VHS - .svhs

Umatic - .umatic

Video8 - .video8

Hi8 - .hi8

βetaMax - .betamax

βetaCam - .betacam

Video2000 - .v2000

Information Calculation

Decode Runtime & Progress:

Frames: 63500

25 ÷ 63500 = 2,540 Seconds (TV System 25 PAL 29.97 NTSC)

2,540 ÷ 60 = 42.33 (Minutes.Seconds)

Sample Calculation:

Seconds Times MSPS i.e 40/20/28 and so on.

Seconds: 1817

40 x 1817 = 72,680 * Samples

Compression Ratio & Percentage Calculation:

158,209,146,880 Bytes - Uncompressed

52,103,563,068 Bytes - Compressed

19,237,694,012 Bytes - Re-sampled Compressed

For Ratio: Uncompressed Divided By Compressed

Ratio: 3.036436235148109

For Percentage: Uncompressed Divided By Compressed Times 100

Percentage: 303.6436235148109

Formatting An Index File

Now you know how to get the basic information of your captures, you need some level of formatting this is a basic example used for home media archives going onto discs for archive.

Index file example:

Media Information:

(Append photos in DNG/JPEG if any)

Cassette: (S)VHS or (S)VHS-C (etc)

Condition: Clean, No mould, Shedding, Sticky (etc)

Tape Name: Title On Cassette (if any)

Tape Date or Year: 00.00.0000 DD.MM.YYYY

Tape Format: VHS / SVHS / Umatic / Video8 / Hi8 / βetaCam / βetaMax (etc)

Tape Speed: SP / LP / β I / β II (etc)

Tape System: NTSC / NTSC-J / SECAM / MUSECAM / PAL / PAL-M /

Tape Runtime: 00:00:00:00 (HH:MM:SS:FF Hours Minutes Seconds Frames)

Audio Modes: Linear / HiFi

Timecode: (VITC/LTC Yes/No/Both)

Head switch: Normal / Moved

(this is if you want the bottom lines recovered by moving the head switching position or ''the distorted line'' at the bottom of analogue tapes)

RF Capture Information:

RF Video Start Point: (If multiple formats cut points should be noted due to decoders fixed format mode though this is only really an issue with VHS/S-VHS)

-s 286 -s 5763

RF Capture: Tape-002-TP-DdD-Gain2.02_PAL_Cap1_2022-04-28_01-04-10.lds

Duration: (Total RF Capture Duration) 00:30:17 HH:MM:SS

Original: (Initial Capture Size) 88,514,560 KB

Compressed: (After Compression Size) 29,701,474 KB

Compression Ratio: xxxxx

Resampled: (Size after 16~24msps 8-bit resampling) 9.902.103 KB

Notes Section:

From simple to the smallest detail

Scratch, Label's Scanned (ref to scan data location) Duplicate Made.

Chapter Notes:

HH:MM:SS:FF (Hours Minutes Seconds Frames)

02:34:12:03 Event Notation

If the decoded TBC/Video is included then you will want to include the version of vhs-decode/hifi-decode used to process it.

git log inside the vhs-decode directory and copy the last commit information.