Files
Vocaluxe/HowToBuildLinux.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

33 lines
1.1 KiB
Markdown

# Build Vocaluxe - HowTo (Linux)
Runing Vocaluxe on Linux is not offically supported yet -but you can try it yourself.
(the problematic part is fullfilling the runtime dependencies)
* Install the [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0)
* Get sure gcc, g++, make and pkg-config are installed
* Install the runtime dependencies:
- FFmpeg 8 (libavformat 62, libavcodec 62, libavutil 60, libswscale 9, libswresample 6)
- portaudio
- hidapi (libhidapi-libusb)
- openal (optional, only needed for the OpenAL playback)
- gstreamer 1.0 (optional, only needed for the GStreamer playback)
* Clone the repository and execute in its folder:
```bash
chmod ugo+x ./.build/linuxPostBuildEvent.sh
chmod ugo+x ./.build/linuxPreBuildEvent.sh
make
```
* The build should complete without errors
* change to the Output directory:
```sh
cd Output
```
* Start Vocaluxe:
```bash
./Vocaluxe
```
* If GStreamer is not installed, set `PlayBackLib` to `PortAudio` in the `Config.xml`
* If yo make some progress we would be happy if you share it with us in a pull request/issue.