0 Fork 0

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

Files

T

History

Ditin2 7a251c5fff Use delayed variable expansion in setup.bat (#1168 )

* Rename variable 7ZIP to SEVENZIP

Currently this script fails, as %7ZIP% is interpreted as "ZIP", because %7 is treated as the 7th positional argument in bash scripts. Alternatively you could use !7ZIP! as this uses the already enabled DelayedExpansion.

* Update setup.bat to use delayed variable expansion

2026-03-01 20:10:07 -05:00

build.bat

Reorganize dev docs/scripts

2025-12-26 23:57:17 -05:00

bundle.bat

Reorganize dev docs/scripts

2025-12-26 23:57:17 -05:00

common.bat

Add test runner scripts (#1171 )

2026-03-01 15:38:11 -05:00

README.md

Add test runner scripts (#1171 )

2026-03-01 15:38:11 -05:00

run.bat

Add test runner scripts (#1171 )

2026-03-01 15:38:11 -05:00

setup.bat

Use delayed variable expansion in setup.bat (#1168 )

2026-03-01 20:10:07 -05:00

test.bat

Add test runner scripts (#1171 )

2026-03-01 15:38:11 -05:00

README.md

Building Jellyfin Desktop on Windows

Quick Start

Setup and build

dev\windows\setup.bat   # First time: download dependencies
dev\windows\build.bat   # Build

Run the application

dev\windows\run.bat

Run the unit tests

dev\windows\test.bat

Prerequisites

winget (Windows Package Manager)

setup.bat installs everything else:

Visual Studio 2022 Build Tools (v143 toolset)
CMake, Ninja, 7-Zip, Inno Setup
aqtinstall, Qt 6.10.1
libmpv (AVX2 + fallback), VC++ redistributable
MinGW, WiX (for packaging)

Directory Structure

dev/windows/deps/ - Downloaded dependencies (Qt, mpv, etc.)
build/ - Build output (safe to delete)
build/src/Jellyfin Desktop.exe - Built executable

Scripts

setup.bat - Download all dependencies
build.bat - Configure and build
bundle.bat - Create installer and portable ZIP
run.bat - Run executable (sets up Qt/mpv in PATH)
test.bat - Run unit tests (sets up Qt/mpv in PATH)
common.bat - Shared variables (sourced by other scripts)

Clean Build

rmdir /s /q build
dev\windows\build.bat

Troubleshooting

Black Screen / GPU Issues

Try software rendering:

dev\windows\run.bat --software-rendering

Common causes:

Outdated GPU drivers
Missing DirectX components
Hardware acceleration incompatibility

Log Files

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

Notes

Qt 6.10.1 requires VS 2022 toolset (v143) for ABI compatibility
Version info centralized in common.bat
run.bat adds Qt/mpv to PATH; bundle.bat creates standalone packages