VLClean Forum

VLClean Player => VLClean Player General => Topic started by: FM71 on November 17, 2014, 01:29:08 AM

Title: Clean File Creation - The Inclusive Guide
Post by: FM71 on November 17, 2014, 01:29:08 AM
This is the advanced guide on how to make a video filter and what all those confusing looking things in the template.clean file are in depth. If you want the beginners guide, scroll to the bottom.

[Video_Filters] *Required if your clean file skips video
This is where you would denote the type of scenes filtered. These are written like "-Gore=1" which would correspond with a [Video_Skip], like so "--Filter=Gore". These allow you or other people to turn off sections of skipping if so desired. If you wish to note exactly what the skipped scene contained, you can do so by writing what it was in plain text (example: beheading) directly below the end time.


[Audio_Filters] *Required if your clean file mutes audio
This is where you would denote the specific words filtered. These are written like "-God=1" which would correspond with an [Audio_Skip], like so "--Filter=God". These allow you or other people to turn off sections of muting if so desired.


[Offset]
Everything in this section here has to do with the generation of offsets for videos that may be different slightly different from the original video the filter was created using. These are VERY important to include when creating clean files, the omission of any of these numbers will break the filter and cause issues for other people trying to use the clean files.

--Custom_Audio_MS=0
--Custom_Video_MS=0
These are manually input by you (the end user) in the event VLClean Player's automatically generated offset is not working. For more information on how to use this, check out our guide on audio offsets (http://forum.vlcleanplayer.com/index.php?topic=4.msg8). These are normally set to 0. In the off-chance you need to change them, they should both be the same number 99.9% of the time.

--Original_offset *Required
This is the offset from the video file the clean file was created using. This number is generated by VLClean Player by calculating the length in ms to the first audio spike of a specific decibel level. This can then be used to line up most (mind you, I said most) videos regardless of where you got it or "backed it up" from.

--Original_Filetype *Required
This is the filetype of the video file the clean file was created using. This is necessary mainly because AVI files have some odd playback offset issues, though so do MP4's so until we figure something out for those this is necessary.

--Original_Length *Required
This is the length of the video file the clean file was created using. If you are creating the filter, this is the length of the video file you are filtering. This should never be edited after it's uploaded to the VLClean filter database.


[Clean_Test] *Required
This is where you place video times that are a few seconds prior to any filter locations you feel would be a good test spot for checking if the filter worked on first run. Preferably something filtered that would not fall under any Level 1 category in-case the filter fails the first time around.


[Video_Skip] *Required if your clean file skips video
All of the video skips go in between these section markers. The actual video skip code is as follows.


[Audio_Skip] *Required if your clean file mutes audio
All of the audio mutes go in between these section markers. The actual audio mute code is as follows.

(http://i.imgur.com/gtASKa4.png)
Beginners Guide to making your first Clean File
Warning! This may look like a ton of steps but It's not. I am just being very thorough.

Creating and Building your .clean file | (Example) (http://forum.vlcleanplayer.com/my_images/guide/offsets.png)

Preparing to clean your video | (Example) (http://forum.vlcleanplayer.com/my_images/guide/levels.png)

Filtering audio from the the video | (Example) (http://forum.vlcleanplayer.com/my_images/guide/audiofilters.png)

Filtering scenes from the the video | (Example) (http://forum.vlcleanplayer.com/my_images/guide/videofilters.png)

How to easily verify any edit while cleaning the video | (Example) (http://forum.vlcleanplayer.com/my_images/guide/buildmode.png)