0 Fork 0

mirror of https://github.com/jellyfin/jellyfin-desktop.git synced 2026-10-26 16:45:24 +00:00

Files

T

iZack 52d5067676 Working 2.0.0 build for Windows

It is really late so I'm calling it here. I wanted to put this out for relevant people to get eyes on, in order to aid in getting the Windows build of v2.0.0 out. Apologies in advance for not following any contrib guidelines or there being messes.  I'm leaving in the build scripts I used for now. The build scripts still contain a few hardcoded visual studio related values for now.  At the moment when I run the app on a different machine to the dev VM I'm using the qt web view doesn't seem to be rendering.

summary of where this is at:
the whole thing builds
works on my Windows 11 virtual machine

short summary of what I did:

A couple of qt6 updates specific to windows were addressed.

Some build system issues were addressed

did some minor refactoring to sieve out binary build dependencies from generated build files since its a lot easier when you can just delete the build folder to run a clean build

2025-12-19 01:43:38 -08:00

2.1 KiB

Raw Blame History

Building Jellyfin Desktop on Windows

Quick Start

setup_build_deps.bat    # First time: download dependencies
build_windows.bat       # Build

Output: build\output\Jellyfin Desktop.exe

Prerequisites

Visual Studio 2022/2026 with C++ tools
- Install "MSVC v143 - VS 2022 C++ x64/x86 build tools" (required for Qt 6.10.1)
Qt 6.10.1 MSVC 2022 64-bit at C:\Qt\6.10.1\msvc2022_64
Build dependencies: Ninja, libmpv, VC++ redistributable

Directory Structure

build_deps/ - External dependencies (persisted)
build/ - Generated files (safe to delete)
build_vs_debug/ - VS debug build

Scripts

build_windows.bat - Release build + installer
build_vs.bat - Debug build for Visual Studio
setup_build_deps.bat - Download dependencies
rebuild.bat - Quick rebuild

Clean Build

rmdir /s /q build
build_windows.bat

Debugging

build_vs.bat

Opens VS solution at build_vs_debug\jellyfin-desktop.sln

Requires Qt debug libraries (install via Qt Maintenance Tool).

Troubleshooting

Black Screen / GPU Issues

If the app opens but shows a black screen instead of the web interface:

Try software rendering (disables GPU acceleration):

launch_software_mode.bat

Or rebuild with the fix and run:

"build\output\Jellyfin Desktop.exe" --software-rendering

Test different GPU configurations:
```
try_gpu_workarounds.bat
```
This interactive script tests various rendering modes to find what works.
Gather diagnostics:
```
diagnose_black_screen.bat
```
Collects logs, GPU info, and process details to diagnostics/ folder.

Common causes:

Outdated GPU drivers
Missing DirectX components
Hardware acceleration incompatibility
Older/unsupported graphics cards

Log Files

Application logs are located at:

%LOCALAPPDATA%\Jellyfin Desktop\logs\jellyfin-desktop.log

Notes

Qt 6.10.1 requires VS 2022 toolset (v143) for ABI compatibility
QtWebEngine resources auto-copied by build scripts
Installer created after 5-second countdown (press key to skip)

2.1 KiB Raw Blame History