Files
Vocaluxe/HowToBuildWin.md
T
McSchneidar cf2fa796e2 .NET10 Migration (#946)
Runtime and build
- Move all projects to .NET 10 with SDK-style project files and a shared
  Directory.Build.props (WIN/LINUX, x86/x64 defines)
- Load managed and unmanaged dependencies from libs/managed and
  libs/unmanaged through assembly and native library resolvers
- Compile party modes with Roslyn instead of CodeDom
- Update AppVeyor to the .NET 10 SDK and dotnet test
- Download the FFmpeg and gstreamer runtimes from the dependencies
  repository during the build
- Remove the VC++ 2015-2022 runtime check, no dependency needs it anymore

Graphics and windowing
- Replace the Direct3D 9 renderer with Direct3D 11 (Vortice)
- Pace Direct3D 11 frames with a frame latency waitable swap chain
- Move window, input and message boxes to SDL3
- Replace System.Drawing with SkiaSharp and WinForms with SDL3 and a
  software renderer

Video and audio
- Replace Acinerella with FFmpeg 8.1.3 (FFmpeg.AutoGen)
- Add hardware accelerated video decoding (D3D11VA, DXVA2, VideoToolbox,
  VAAPI, VDPAU) with software fallback
- Convert YUV video frames to RGB on the GPU in Direct3D 11 and OpenGL
- Add the video options HardwareDecoding, GpuColorConversion,
  DecoderThreads and VideoDownscaleResolution
- Update OpenAL to OpenTK 4 and NAudio recording to WasapiRecorder

Fixes
- Fix the song preview start and shorten the reporter buttons
- Fix a crash when opening the highscore without a selected song
- Use the options slide highlight in the party mode screens to avoid
  brightness flicker on VRR displays
- Disable GameInput in the x86 build, SDL3 crashes in GameInputCreate
  on 32-bit systems with the GameInput runtime installed
- Fix a truncation warning in PitchTracker
2026-11-02 08:11:20 +01:00

2.9 KiB

Build Vocaluxe - HowTo (Windows)

  • Navigate to the right repository: usually Vocaluxe Main

  • Navigate to the right branch: usually develop (The main branch of Vocaluxe)

    branch

  • Copy the URL of the corresponding git file

    url

  • Make sure Visual Studio 2026 with the workloads .NET desktop development and Desktop development with C++ and the .NET 10 SDK are installed

  • Make sure Node.js (LTS) is installed. It is needed to build the WebApp (folder WebApp), which is built automatically together with the project VocaluxeWeb. Restart Visual Studio after installing it.

  • Clone the repository and open it

    Method A: Use Visual Studio (2013+)'s git client:

    • Start Visual Studio
    • VIEW->Team Explorer
    • Click on the Connect to a Team Project button inside the Team Explorer
    • Click on Clone under Local Git Repositories
    • Enter [theCopiedGitUrl] in the first field
    • Enter a target folder in the second field
    • Click clone vsclone

Method B: Use commandline git client: * Make sure git is installed git-scm * Open a git bash (there should be a link in the start menu) or a normal commandline if you have added git to the PATH variable * Navigate to the folder where git should create the Vocaluxe project folder

  ```
  cd [PathToYourFolder]
  ```
* Clone the repository (could take some time...) 
  ```
  git clone [theCopiedGitUrl]
  ```
  ![clone](https://cloud.githubusercontent.com/assets/5115160/4995707/bc5aa6da-69c2-11e4-95cb-71ac7b0c3fc8.png)

* Now you should find a Folder `Vocaluxe` in the given directory -> navigate into it

* Open the file `Vocaluxe.sln` with Visual Studio
  • Configure the build target to ReleaseWin and x86 or x64 (if unsure -> select x86)

  • Build the projects by clicking "Build"->"Build solution" or just press Control+Shift+B

    build

  • Check if your build was successful buildsuccess

  • YOUR build should have appeared here:

    [PathToYourFolder]\Vocaluxe\Output
    
  • Run Vocaluxe.exe or copy the whole folder to a location of your choice

  • Have fun!