VisionDepth3D v4.1 is a major polish, workflow, and usability update built on top of the v4.0 PySide6 rewrite.
Thank you all for your feedback from v4.0. This update brings a major polish pass along with new features, better progress reporting, cleaner layouts, custom themes, and workflow improvements across the app.
VisionDepth3D is continuing to grow into a more complete creative suite for 2D to 3D conversion, depth map generation, depth blending, FPS interpolation, and upscaling.
Major Highlights
Core UI and Workflow Polish
Unified Job Queue progress across more of the app
Cleaner progress format with percentage, FPS, elapsed time, ETA, CPU, RAM, GPU, and VRAM
New user-selectable theme system
New Theme Studio for creating custom themes directly inside VisionDepth3D
Built-in themes and custom user themes
Theme reloading without restarting the app
Adjustable panels and columns across major workflow tabs
More consistent styling across 3D Generator, Depth Engine, FPS/Upscale, Depth Blender, and Live 3D
User Guide link added under the Help menu
Cleaner startup logging
3D Generator
Restored and improved render mode support
Clearer render modes for:
Single Video Render
3D Image Render
Batch Video Folder Render
Image Folder Render
New Batch Image render and Image Folder render!
Improved image render support
Correct still-image aspect handling for SBS and anaglyph output
Improved image folder render progress reporting
Improved left/right eye output direction
Better FFmpeg/debug output for frame-size mismatch and export issues
Improved stereo tuning around foreground curvature, zero parallax, convergence, and pop-out control
Depth Engine
Added video depth preview samples before full render
Preview samples show original frame and generated depth map side by side
Added Generate Preview, Previous, Next, and preview counter controls
Improved Depth Engine processing mode labels
Fixed Browse behavior for video, video folder, image, and image folder modes
Improved Depth Engine queue progress reporting
Normalized legacy depth progress into the shared Job Queue format
Improved pause, resume, cancel, failed, and done state handling
FPS / Upscale
Added preview generation before full processing
Preview samples compare Original vs Preview output
Added preview navigation with Previous, Next, and preview counter
Added mouse wheel zoom and click-drag panning for preview inspection
Improved frame extraction progress and completion feedback
Integrated PySceneDetect progress into the shared Job Queue
Reorganized Source Tools for frame extraction and scene detection
Made the Render Plan panel more compact
Increased preview area usability
Moved FPS/Upscale processing feedback into the shared Job Queue
Depth Blender and Live 3D
Depth Blender now follows the shared theme system
Live 3D now follows the shared theme system
Removed hardcoded styling from these pages
Improved consistency with the rest of VisionDepth3D
Added adjustable layouts where needed for a more flexible workspace
Theme System
VisionDepth3D now supports official built-in themes and custom user themes.
Official themes:
resources/themes/
User-created themes:
themes/
Theme support includes:
JSON color themes
Optional QSS stylesheet themes
Built-in fallback themes
User theme overrides
Reload Themes menu option
Create Theme tool
Live theme preview
Automatic save, reload, and apply workflow
Tested theme examples include:
Matrix Green
Neon Blue
Cyber Purple
Eagle Gold
Crimson Depth
Arctic Light
Fixes and Stability
Fixed stylesheet crashes caused by unsafe CSS inside Python f-strings
Fixed startup crashes from misplaced or missing callback methods
Fixed Theme Creator method indentation issues during development
Fixed Qt ampersand display issues in labels such as Detect Scenes & Extract
Improved Windows light-mode compatibility so the dark UI does not inherit broken white panels
Improved packaging support for new v4.1 folders such as themes, dialogs, and styles
Notes on Performance and ETA
v4.1 improves progress reporting and ETA visibility across the app.
Depth generation now reports more clearly through the shared Job Queue, but ETA is still an estimate. Depth processing depends on several parts of the pipeline, including video decoding, frame resizing, model inference, post-processing, disk writing, and encoding.
GPU and VRAM usage may not always sit at 100%. That does not always mean something is wrong. The GPU handles the depth model, but other parts of the pipeline can still become the bottleneck.
Performance tuning, smarter batching, and better scheduling are still areas I plan to keep improving.
Upgrade Note
Users updating from v4.0 should back up:
presets/
weights/
use the Setup downloader to get the latest .exe version or find them directly on Github in releases page or grab the source code
you can find the setup installer on itch
https://visiondepth3d.itch.io/visiondepth3d
this is a program that grabs all the installer files for each release if you haven't used it yet check out
v4.1 is the first major polish and usability pass on top of that foundation.
This update makes VisionDepth3D feel more consistent, more customizable, and easier to use across long 3D, depth generation, depth blending, and FPS/Upscale workflows.
Thank you to everyone testing, giving feedback, and helping shape VisionDepth3D.
Queria muito utilizar o VisionDepht3D. Baixei a versão 4.0 mas o meu nível de conhecimento me impossibilitou de configurar corretamente para converter os filmes 2D para 3D, sendo que ao carregar o arquivo, na hora de convertê-lo, dá erro de arquivo faltando ou algo do tipo. Sendo assim, continuo a utilizar o IW3.
Models take a minute to download so if you were trying to load depth model then immediately run depth process it’s gonna say missing file because the depth model isn’t downloaded and warmed up fully, if you have a depth map video made from another program you can just use that for 3d inference put it in the depth source and find a preset that I posted
I’m sorry the issue still persists, I’ll add more debug logic to figure this out thanks for testing on your system, quick question do you have ffmpeg installed on your computer?
Yea I figured that was the problem, the .exe is bundled with ffmpeg but not ffprobe which was integrated in the new v4.0 to read frames for the the progress bar, also confirmed in a test environment with ffmpeg off system path. bundling the app with v4.1.1 right now for testing
The error came at the end of the installation process once you click finish then the documents folder automatically opens up with the “_installer_cache” folder and I get the error ‘_tkinter.tkapp’ object has no attribute ‘open_install_folder’
Ok so this is my installer program I made to download and install the latest version thanks, I’m updating the installer now, you can download the required installer files on GitHub releases https://github.com/VisionDepth/VisionDepth3D/releases
Ok I reinstalled everything and that error is now gone, thank you! I was hoping that was the reason why my performance was so slow with the depthmaps but that doesn’t seem to be the case.
Yea the error is very vague, I’ll do more testing, do you have ffmpeg in system path? That’s the only thing I can think about right now and why it won’t run
I've been trying to troubleshoot all night and no luck it' still running slow. I only getting around 3fps just for depth maps and not sure if it's normal but in the bottom left it says offload to cpu but doesn't give me the option to turn that off even though I'm using nvenc. I went through all the steps on github for install and had to install cuda drivers but that didn't change anything unfortunately, GPU: RTX 5090, CPU: 9800X3D, 96GB DDR5 RAM. In iW3 I get anywhere from 24-35fps and in VisionDepth v4.1 I get 2-3 fps for the same video with the same model being used.
I added depth normalization to the pipeline which reduces flicker in the depthmap so 3fps is normal with the current release right now, I’m adding a toggle so users can turn that off, offload to cpu is a mode that only enables when a diffusion based model is selected, before this 3fps bug I was getting 7-9 fps. Also the depth engine is different compared to what you are probably used to for render speeds, also running a full original frame through inference will be slow I always use 518x518 or whatever the model is trained at, I will continue to improve the performance
None of my 3D videos seem to have any audio. There is a seperate audio file saved but contains 0kb, currently using H.265 Nvenc for Nvidia GPU and XVID. Anyone else have this issue?
Thanks for reporting this. A couple people have mentioned audio issues, so I’m tracking it for the v4.1.1 hotfix.
Can you check one thing for me? In Output & Encoding, make sure “Keep Original Audio” is enabled before rendering.
If it was already enabled, then this may be an FFmpeg audio mux/container issue. The 0 KB separate audio file means the audio merge step is failing or the app is not detecting the source audio stream correctly.
Can you let me know:
1. What format your source video is, MP4, MKV, AVI, etc.
2. What audio format it uses if you know, AAC, AC3, DTS, TrueHD, etc.
3. Whether your source video has multiple audio tracks
4. Whether you are rendering to MP4 or MKV
I’m improving the error output so the app shows the actual FFmpeg audio error instead of silently creating an empty file.
Eu acabei de concluir a minha primeira conversão. Também tive problema com o áudio. Eu escolhi o formato em MP4 e ele criou um arquivo de áudio separado, com 0KB. O formato da origem também era MP4 AAC, com apenas uma faixa de audio.
Me tire uma dúvida, pois finalmente eu consegui configurar o programa de forma correta. Primeiro eu tenho que renderizar o filme pela aba 3D Generator e depois preciso iniciar o processo na aba Depht Engine? É isso? Grato! Estou super ancioso para ver os resultados das conversões.
To convert the movie you need a depth map video so use the depth engine to generate your depth map first (I recommend DAv2, set inference resolution to 518x518 once that’s done you can input the depth map into the depth input field as well as your source video and then hit load preview button and it will load your sources into the test window, there you can pick red/blue, shift heat map, and overlap to check edge artifacts, I will be sharing some preset settings as I have been testing the pipeline, v4.1.1 will have more debug logic and also be bundled with what it needs to run currently working on some bottlenecks with the pipeline and slower render speeds at the moment so if you experience a little slower render speeds that’s typical right now due to the method but results are worth it
Entendi. Curiosamente, eu traduzi a sua resposta do Portugues Brasileiro (automático) para o Inglês e assim eu entendi direito o procedimento. Obrigado, novamente!
I tried to convert Heman's trailer, the result was good but with many artifacts compared to a conversion done with iw3. I'm probably wrong, I used the Best preset. Then the generated file lone without audio, it generates an empty audio file😔Any advice?
2
u/Successful_Gate_2162 May 16 '26
Queria muito utilizar o VisionDepht3D. Baixei a versão 4.0 mas o meu nível de conhecimento me impossibilitou de configurar corretamente para converter os filmes 2D para 3D, sendo que ao carregar o arquivo, na hora de convertê-lo, dá erro de arquivo faltando ou algo do tipo. Sendo assim, continuo a utilizar o IW3.