JavPlayer Manual
JavPlayer Manual
00
Please do not sell, distribute or publish videos created using JavPlayer without
the permission of the copyright holder.
Overview
This app is a video player whose main purpose is to record processed videos.
Recording requires complex processing and is time-consuming because it is done with external programs.
A watermark will be added to the created video, but JavPlayer has the ability to play it back while
removing it.
Requirements
JavPlayer itself should work on a PC with at 8GB of main memory, but without a video card, it will take
much longer to run external tools.
When running on the CPU, not only is it slow, but only some external tools can be used.
Even when running on a GPU, external tools may cause problems if VRAM is less than 4GB.
External tools use CUDA, so GTX1050 or higher is recommended as GPU.
The RadeonRX series is also supported, but there are compatibility concerns because ZLUDA is used to
convert CUDA code to ROCm.
For sufficient processing speed, 16GB or more of main memory and 8GB or more of VRAM are
recommended.
Operation is tested on Windows10 (64bit) and Windows 11, and Windows7 is not supported.
Install
Extract the downloaded zip file to any location and run JavPlayer.exe.
If you cannot play H265(HEVC) video on Windows10, please install the HEVC codec.
HEVC Video extension
*There may still be a download page for the free version, although it is now paid for.
ms-windows-store://pdp/?ProductId=9n4wgh0z6vhq
Likewise, install AV1 if necessary.
AV1 Video extension
Uninstall
Delete the extracted folder.
If you plan to reinstall, please save & restore the "installation folder/JP3.udj".
Deleting resets the system settings and video-specific settings.
If you want to take over the playback points, please do the same for "installation folder/JP3.ltj".
Saving UserData
The contents of the settings panel are auto-saved in JP3.udj.
Any changes made to the video-specific settings are executed just before the next video is loaded.
It is executed when the application exits, even if there are no changes to the video-specific settings.
JP3.ltj will be created if Restore Playback Point is enabled.
Basic Operations
F7&F8 keys can be used to load the previous and next videos in the same folder, press immediately after
startup to load the last video played.
In continuous auto playback mode, it moves back and forth in the video being targeted.
Seek playback position and volume control are done with sliders, either of which can be assigned to the
mouse wheel.
You can also seek to any position by swiping left or right on the screen.
The process status check mode is for viewing mosaic detection results.
The colored areas are mosaic detection results, and the size of the shrunken image (approximate value)
and cell size (mosaic roughness) for each area are shown in text.
Areas exceeding the upper limit (9 pieces) are grayed out and will not be processed.
Pressing the REC button in the upper menu switches to this control panel.
When encoding is completed to the end or the stop button ① finishes encoding, audio will be added to
complete the video.
If a loop range has been specified by ⑱⑲, only that range will be recorded.
The file name of the video to be created can be changed by “JavPlayer/rec_name_format.txt”.
If intermediate data created during recording remains in the work folder, resume according to the list to
the right of the REC button.
The default is From the Beginning if no data is available, or Required Process Only if data is available.
If all data has already been created, it will be From Encoding, but it means the same as the Required
Process Only.
You can select Behavior on Completion (Stay, QuitApp, or Shutdown) when recording is completed in
the list ②.
If the stop button is pressed to exit, nothing is done.
A folder for storing batch files named RetryToAddAudio will be created in the video destination folder.
If adding audio fails, a batch file named "OutputVideoName_AddAudio.bat" will be created in this folder.
This is to avoid the situation where a long time recording is wasted due to silence, and you can retry
adding audio later.
If the audio is added successfully as usual, a batch file named "_LAST_REC_OutputVideoName.bat" will
also be created.
However, the next recording will overwrite it and only the last one will remain.
If the audio is successfully added by this batch file, a video named "OutputVideoName_AddAudio.mp4" will
be created.
To discourage illegal distribution, a watermark will be added to the video you create.
Please refer to the "Watermark Removal" section for instructions about how to remove it.
Sequential Recording
Multiple videos can be registered for recording in advance, and recording can be executed at once.
Press E(Entry) key to register with the current settings (recording range, super-resolution batch file,
model type, etc.).
Press Q(Queue) key to display the cue panel (list of recording entries, buttons for operation, etc.) as
shown in the image above.
Color Correction is not included in the entry information and reflects video-specific settings.
Keys of Entry and Queue can be reassigned.
Frame Rate : Normally, V-Sync(1/1) is selected to avoid tearing, but if the V-Sync is turned off in GPU
settings, you must select something other than V-Sync.
Select 30fps if the PC performance is insufficient and the frequency of frame updates is not stable.
Think of "Match to the Video fps" as "automatic switching between 30fps and 60fps".
The frame rate is 50% of the refresh rate for V-Sync(1/2) and 25% for V-Sync(1/4).
AI Processing : Normally "on GPU with priority", but select "on CPU with priority" only if you are
using a slow integrated GPU.
Seek Interval : The short interval of moving the playback position.
Skip Interval : The long interval of moving the playback position.
*Maximum (Inf.) will move to the beginning or end of the video at one time.
Initial Volume : Leftmost (keep) restores the volume of the last session.
Subtitle Font Size : If a size is specified, subtitles will be displayed using the 'VIDEO_NAME.srt' in the
same folder as the video.
Window Size Limit : Make the window small enough to fit on the monitor.
Enlarge Window to the Limit : Automatically enlarge videos to fit the window size limit.
Base of Window Position : Select where in the window to align when the video in different sizes (vertical
and horizontal) will be opened.
Control Panel Type : Select whether the control panel should be overlaped on the video.
*If you are using a typical 16:9 monitor, "Overlay only in full screen" is recommended.
Always on Top : When turned on, it will not be hidden by other applications.
Restore Playback point : Play each video from the same point as the previous session.
Display system information : Displays the current super-resolution settings, frame rate, and main
memory usage in green text in the lower left corner of the screen.
Key Assignment
Step, Seek, Skip, and Move to Bookmark are executed continuously by holding them down.
While Shift is held down, Seek and Skip are interchanged.
Pressing Speed Up or Speed Down while holding down the Shift key resets the speed.
What is loaded as presets 1-6 are those saved by pressing the buttons at the bottom of the Processing
Settings Panel.
If you hold down the Shift key when loading, the numbers are 7 to 12.
If not saved, the default presets are loaded.
Preset 1 is applied when each video is opened for the first time.
Recording Settings
External Tool Exec Mode is used to specify the state of the console window for super-resolution tools,
etc.
The window may be obtrusive, so select Normal only if you want to check that the process is working
properly.
Processor Used by Tools is usually GPU0, but if the GPU is extremely slow, CPU should be selected, and
if there are two GPUs, GPU1 may be selected.
Tool Parrallel Exec Limit is for avoid running out of main memory or VRAM during super-resolution
processing.
The number of parallels is automatically limited, but the main memory and VRAM usage cannot be
accurately predicted and the load may be so high that the PC becomes inoperable.
When executed on a typical PC, there is a large difference between parallel number 2 and 3, but little
difference between 8 and 9.
Excessive number may slow things down, so for speed and safety reasons, usually set 3 to 8.
Be sure to set the correct value for Total VRAM Capacity. *Usually Auto is fine.
Since VRAM allocation per process is made as a “percentage of total VRAM,” setting a smaller value than
the actual value will result in over-allocation and cause VRAM shortages.
“Total VRAM capacity available for tools = Total system VRAM capacity - VRAM Left for Other Apps”
Normally, about 1 GB is sufficient, but set a larger value if other applications will consume VRAM during
recording.
It is also useful as a means of dealing with cases where the number of parallelisms is not properly limited
and main memory or VRAM is insufficient.
The default of Encoder/Codec is Ffmpeg/H264.
NatCorder has the disadvantage of degrading quality in scenes with intense motion.
FFmpeg can provide high quality throughout the entire video and can also save size by selecting HEVC or
AV1, but there may be problems such as "hardware encoding is not possible" or "the created video cannot
be played" depending on your environment.
You can also encode with any options by rewriting enc_opt.txt.
If FFmpeg is selected as the encoder, you can specify Processor for Encoding.
You need to check if your GPU supports hardware encoding of the specified codec.
If you are unsure, select CPU.
Since image processing is performed in parallel with encoding, using a GPU may not make much difference
(just more time waiting for processing to complete).
Setting the frame rate type to CFR (constant frame rate) will make the frame interval constant, which
improves the seek response during playback for some players.
However, if the original video is VFR (variable frame rate) or contains many missing frames, duplicate
frames will be inserted to prevent sound shift.
When Auto Switching is selected, CFR if the frame spacing of the original video is constant, and VFR if it
is uneven.
*When encoding with NatCorder, it is always VFR.
Quality 5 will still be a higher bit rate than a typical mp4 video.
If you want to use the created video as material for editing, you should select the maximum value.
Increasing Keyframe Interval will slightly reduce the file size of the created video, but will worsen the
seek response during playback.
The recommended value is 2 sec.
If ColorSpace Conversion is turned ON, the colors of the video to be created will be slightly darker.
It is impossible to determine the correct color because the color changes depending on the configuration
of the original video and the player used to play it, but it is better to turn it on for FHD videos.
External Tools Folder is where the separately distributed tools are deployed, and “JavPlayer/Tools” is the
default.
You can share tools with different versions of JavPlayer by specifying any folder.
It also has the advantage of eliminating the need to move tools during version upgrades.
Work Data Folder is where intermediate data (mainly still images) created during recording is stored.
Since a large amount of data will be written, please take into account the capacity of the drive and the risk
of corruption.
If you are creating many short videos, I recommend using a RAM disk.
Work Data Folder to Keep is the number of data folders that can exist simultaneously.
If 0, it is deleted immediately after the recording is completed.
If 1, it is deleted at the start of the next recording.
If 2, you can start recording with one data folder left and resume recording with the previous one.
The data folder will be moved to “JavPlayer/Work/_deleting/” and then deleted.
In the list of image Processing Batch File A(B), items appear according to the external tools installed.
TG&BVPP is required as of the release of JavPlayer_Ver.3.00.
Normally, only batch file A is specified, but if B is also specified, the super-resolution results from A and B
will be blended.
If the name of batch file B is enclosed in parentheses, such as “(NAME)”, super-resolution of B is
performed on the result of A.
If the result of 8x super-resolution in A is super-resolved 4x in B, the result is 32x, and if 4x with post-
processing as described below, the result is 128x.
For FHD videos, 24x super-resolution will sometimes exceed the resolution of the original video. The total
resolution of 32x should be considered as the upper limit, as it will not only be wasted by reduction during
compositing, but may also result in encoding failure due to lack of VRAM.
Similarly, if the name of batch file A is “[NAME]”, super-resolution of B is performed on the result of A.
This is a pre-processing that filters the image for input, usually without scaling.
Model Type specifies the super-resolution model to be used by the external tools.
STD(Standard) : The processed result will be clearer, but it may be broken depending on the type of
mosaic in the original video.
AF*(AntiFlicker-Level*) : Avoids the breakdown with STD, but the processed result will be blurred.
The difference between STD and AF* is also reflected in the simplified super-resolution in playback.
Usually AF0-2 use a common model and only differ in the filters applied to the image before super-
resolution.
Compared to AF1, AF0 is a little sharper and more distorted and AF2 is a little blurred and less distorted.
White Line Noise Reduction is the degree of application of a “filter that detects areas that are too bright
and suppresses noise” within a frame.
Do not set a value larger than necessary, as a stronger value will result in blurring.
Post Processing Type allows you to select the type of processing to be performed on the super-resolution
image of the external tool.
3XSR : Light weight super-resolution, effective enough for prominent areas such as black and white
borders.
SPAN4X : High-load super-resolution using AI and has a great effect to sharpen processed areas.
Re-Mosaic(L,S) : Special filter to re-mosaic (finer than the original) using the super-resolution result.
Post-processing is done at the same time as encoding, so selecting SPAN4X will increase the time required
for encoding.
Enabling Small Mosaic Detection improves the detection rate of fine mosaics but may fail to detect
coarse mosaics.
If a large value is set in Expansion of Detected Area, less mosaic will remain unprocessed.
However, it also results in processing to areas adjacent to the mosaic.
Appropriate values vary depending on the mosaic condition and user preference.
If the settings are saved as preset1-6, they can be loaded by pressing the corresponding shortcut keys.
Hold down the Shift key and save to preset 7-12.
Display Settings
Hold down Shift and move the red, green, and blue sliders to link the three together.
Pressing Save as Default will apply the color correction the first time the video is played back.
The margin setting is used to eliminate the black borders sometimes seen in older videos.
It is not reflected until the Apply is pressed so that the window size does not change continuously.
AutoAdjust automatically detects the black frame in the currently displayed frame and sets the value.
It is extremely rare, but if width or height of the original video has is odd number, use this function to
make it even.
Watermark Removal
Only videos created with JavPlayerEZ and JavPlayer (Ver. 2.00 or later), can be played while hiding the
watermark.
If you edit the created video and delete the beginning, the timing for displaying the watermark will be off
and cannot be processed properly, but this can be corrected by setting the base frame as shown below.
1. Pause at the frame where the watermark is brightest.
2. Hold down the Shift key and right-click near the watermark.
If the watermark remains, start over.
Hold down the Shift key and right-click in the center of the screen to reset its timing.
Configuration File
Special settings can be made by modifying JP3.ini, which is located in the same folder as JavPlayer.exe.
AllowOverhang : Allow the window to overhang from the screen when opening videos.
Normally false, correct windows position before starting up.
If the position correction is disturbing, such as in a multi-display environment, set to true.
If the entire window is off-screen, press Shift+Escape to move it to the center.
DefaultDecoder : Specify the decoder to be assigned to the video to be played for the first time.
Usually specify MediaFoundation.
MosaiclessFile : Videos that include the specified string in the file name will be excluded from the mosaic
processing.
Multiple strings can be set by separating them with commas.
This function is for users who play no mosaic videos with JavPlayer.
MosaiclessFolder : Videos in folders containing the specified string will be excluded from the mosaic
processing.
Subfolders are likewise excluded.
Multiple strings can be set by separating them with commas.
This function is for users who play no mosaic videos with JavPlayer.
WatermarkedFile: Videos that contain the specified string in the file name will be targeted for watermark
removal.
Only watermarks added with JavPlayerEZ and JavPlayerVer.2.00 or later can be removed.
WatermarkedFolder: Videos in folders containing the specified string will be targeted for watermark
removal.
Subfolders are covered as well.
Multiple strings can be set by separating them with commas.
DisableAutoClose: Set to true if you want to use association to play multiple videos at the same time.
PlaybackSpeeds: Enumerate the values (10 to 200%) applied by speed up/down function.
TROUBLE : The sound of the video created by recording is shifted when the original video is mp4 or mkv.
CAUSE : The range specified for FFmpeg in the audio cutout is not reflected correctly.
SOLUTION : Execute /RetryToAddAudio/*.bat in the folder where the video is saved.
*If the original video is a wmv, it is not a solution because it is re-encoded from the first move.
Others
If you encounter problems, check the debug log (Ctrl+MouseL+MouseR).
You may find the cause of the problem.
The Twitter account @Javski2 is used for announcements and answering questions.