wine-staging/README.md

What is Wine Staging?

Warning: Do not report bugs at bugs.winehq.org when using this version! Please take a look here for more information about how to report bugs.

Wine Staging (formerly wine-compholio) is a special wine version containing bug fixes and features, which are not yet available in regular wine versions. The idea of Wine Staging is to provide new features faster to end users and to give developers the possibility to discuss and improve their patches before they are sent upstream. We also intend to create a community of wine developers to share experience and to make it easier for beginners to start hacking on wine. More information about Wine Staging can also be found on our website wine-staging.com.

Although we are reviewing and testing all patches before adding them, you may encounter additional bugs, which are not present in vanilla wine. Make sure to report such issues in our bug tracker instead of winehq.org so that we can try to solve them in future versions. Thanks!

How to install and use Wine Staging

Ready-to-use packages for Wine Staging are available for a variety of different Linux distributions directly for download. Just follow the instructions available on the Wiki.

When using Wine Staging there are a few differences compared to regular Wine. The main difference is that it is not sufficient to type wine to run it, but instead you will have to type /opt/wine-staging/bin/wine. Besides that there are also some other differences, for example additional configuration options to tweak performance, which are not available in regular Wine. All those differences are also documented on the Wiki.

Included bug fixes and improvements

Bug fixes and features in Wine Staging 1.7.51 [260]:

Note: The following list only contains features and bug fixes which are not yet available in vanilla Wine. They are removed from the list as soon as they are included upstream. The list also includes features and fixes from previous releases, take a look at the changelog for more details.

• Add IDragSourceHelper stub interface (Wine Bug #24699)
• Add IHTMLLocation::hash property's getter implementation (Wine Bug #32967)
• Add a ProfileList<UserSID> registry subkey (Wine Bug #15670)
• Add implementation for mfplat.MFTRegister (Wine Bug #37811)
• Add implementation for shlwapi.AssocGetPerceivedType
• Add nvapi stubs required for GPU PhysX support
• Add performance library registry keys needed by MS SQL Server Management Studio Express 2008 R2 (Wine Bug #33661)
• Add semi-stub for FileFsVolumeInformation information class (Wine Bug #21466)
• Add shell32 placeholder icons to match offsets with Windows (Wine Bug #30185)
• Add stub dlls required for MSVC 2015 runtime library (Windows 10)
• Add stub fltmgr.sys (filter manager driver) (Wine Bug #23583)
• Add stub for D3DXComputeNormalMap
• Add stub for D3DXFrameFind (Wine Bug #38334)
• Add stub for NtSetLdtEntries/ZwSetLdtEntries (Wine Bug #26268)
• Add stub for dwmapi.DwmUpdateThumbnailProperties
• Add stub for gdiplus.GdipCreateEffect (Wine Bug #32163)
• Add stub for ntoskrnl.ExAcquireResourceExclusiveLite
• Add stub for ntoskrnl.ExDeleteResourceLite
• Add stub for ntoskrnl.ExReleaseResourceForThread
• Add stub for ntoskrnl.KeWaitForMultipleObjects
• Add stub for ntoskrnl.Mm{Map,Unmap}LockedPages
• Add stub for ntoskrnl.PsRemoveLoadImageNotifyRoutine
• Add stub for setupapi.SetupDiSelectBestCompatDrv (Wine Bug #32088)
• Add stub for wininet.ParseX509EncodedCertificateForListBoxEntry (Wine Bug #29842)
• Add stub for winscard.SCardListReadersA/W (Wine Bug #26978)
• Add stub for winspool.SetPrinterW level 8 (Wine Bug #24645)
• Add stub for winsta.WinStationEnumerateW (Wine Bug #38102)
• Add stubbed ISWbemSecurity interfaces in wbemdisp
• Add stubs for D3DXCreateAnimationController interface
• Add stubs for additional wininet options in InternetSetOption
• Add stubs for d3dx10_43.D3DX10CreateEffectFromFileA/W (Wine Bug #27739)
• Add support for CopyFileEx progress callback (Wine Bug #22692)
• Add support for GTK3 theming
• Add support for GetPropValue to PulseAudio backend
• Add support for hiding wine version information from applications (Wine Bug #38656)
• Add support for process specific debug channels
• Add wined3d detection for GeForce GT 425M (Wine Bug #35054)
• Adobe Reader needs ITextSelection_fnGetDuplicate implementation
• Allow non-nullterminated string as working directory in kernel32.create_startup_info
• Allow selection of audio device for PulseAudio backend
• Allow special characters in pipe names (Wine Bug #28995)
• Allow to cancel a file operation via progress callback (Wine Bug #22690)
• Allow to edit winecfg library override by double clicking
• Allow to open files/directories without any access rights in order to query attributes
• Allow to override number of quality levels for D3DMULTISAMPLE_NONMASKABLE. (Wine Bug #12652)
• Allow to set pixel format for desktop window
• Anno 1602 installer depends on Windows 98 behavior of SHFileOperationW (Wine Bug #37916)
• Assign a drive serial number during prefix creation/update (Wine Bug #17823)
• Audio stuttering and performance drops in multiple applications (Wine Bug #30639)
• Avoid crashing when broken app tries to release surface although refcount is zero (Wine Bug #18477)
• Avoid race-conditions in NtReadFile() operations with write watches.
• Avoid race-conditions of async WSARecv() operations with write watches.
• Avoid race-conditions with write watches in WS2_async_accept.
• Avseq crashes when multisampling is enabled (Wine Bug #31998)
• Basic handling of write watches triggered while we're on the signal stack.
• Basic support for CUDA
• Black & White needs DXTn software decoding support (Wine Bug #14939)
• CPU-Z fails to start because GetLogicalProcessorInformationEx returns FALSE
• Calculate msvcrt exponential math operations with higher precision (Wine Bug #37149)
• Catch invalid memory accesses in imagehlp.CheckSumMappedFile
• Check architecture before trying to load libraries (Wine Bug #38021)
• Create Microsoft\Windows\Themes directory during Wineprefix creation (Wine Bug #34910)
• Create stub files for system32/drivers/etc/{services,hosts,networks,protocol} (Wine Bug #12076)
• CreateProcess does not prioritize the working directory over the system search path (Wine Bug #23934)
• D3DCompileShader should filter specific warning messages (Wine Bug #33770)
• Do not allow to deallocate thread stack for current thread
• Do not fail when a used context is passed to wglShareLists (Wine Bug #11436)
• Do not use unixfs for devices without mountpoint
• Enforce that surfaces are flushed after ReleaseDC
• Ensure NtProtectVirtualMemory and NtCreateSection are on separate pages (Wine Bug #33162)
• Ensure X11 input events are handled even without explicit message loop (Wine Bug #8854)
• Exception during start of fr-043 caused by missing DXTn support (Wine Bug #37391)
• Export additional OpenAL32 functions (Wine Bug #38972)
• Expose PKEY_AudioEndpoint_PhysicalSpeakers device property in PulseAudio driver
• FEAR 1 installer expects basic_string_wchar_dtor to return NULL (Wine Bug #37358)
• Fake success in IViewObject::Draw stub (Wine Bug #30611)
• Fake success in kernel32.SetFileCompletionNotificationModes (Wine Bug #38960)
• Fallback to default comspec when %COMSPEC% is not set
• Fallback to system ping command when CAP_NET_RAW is not available (Wine Bug #8332)
• Fix NULL dereference in ICSeqCompressFrameStart (Wine Bug #27595)
• Fix access violation in MSYS2 git when cloning repository
• Fix caps lock state issues with multiple processes (Wine Bug #35907)
• Fix comparison of punctuation characters in lstrcmp (Wine Bug #10767)
• Fix condition mask handling in RtlVerifyVersionInfo (Wine Bug #36143)
• Fix crash in Space Rangers2 caused by missing DXTn support (Wine Bug #24983)
• Fix crash of winedevice when relocation entry crosses page boundary (Wine Bug #28254)
• Fix cursor clip regression / broken raw input in multiple games (Wine Bug #33479)
• Fix detection of case-insensitive systems in MSYS2
• Fix device paths in HKLM\SYSTEM\MountedDevices (Wine Bug #38235)
• Fix endless loop in regedit when importing files with very long lines
• Fix error handling in DeferWindowPos when passing an invalid HWND (Wine Bug #23187)
• Fix failure to create anonymous file mapping after failed open_fd server call
• Fix flickering introduced by pixelformat changes. (Wine Bug #35718)
• Fix for ConnectNamedPort return value in overlapped mode (Wine Bug #16550)
• Fix for programs leaking wndproc slots (Wine Bug #32451)
• Fix graphical corruption in FarCry 3 with NVIDIA drivers (Wine Bug #35062)
• Fix gray screen on startup introduced by pixelformat changes. (Wine Bug #35975)
• Fix handling of ANSI NTLM credentials (Wine Bug #37063)
• Fix handling of empty section and key name for profile files. (Wine Bug #8036)
• Fix handling of invert_y in DrawTextExW (Wine Bug #22109)
• Fix handling of opening read-only files for FILE_DELETE_ON_CLOSE (Wine Bug #38417)
• Fix handling of window attributes for WS_EX_LAYERED | WS_EX_COMPOSITED (Wine Bug #37876)
• Fix implementation of msvcrt.close when stdout == stderr
• Fix issues with dragging layers between images in Adobe Photoshop 7.0 (Wine Bug #12007)
• Fix missing video introduced by pixelformat changes. (Wine Bug #36900)
• Fix multithreading issues with fullscreen clipping (Wine Bug #38087)
• Fix possible segfault in pulse_rd_loop of PulseAudio backend
• Fix race-condition when threads are killed during shutdown
• Fix regression caused by blacklisting supported OpenGL extensions (Wine Bug #38480)
• Fix return value of ScrollWindowEx for invisible windows (Wine Bug #37706)
• Fix scaling behaviour of images and mipmap levels in IDirect3DTexture2_Load (needed for example by Prezzie Hunt)
• Fix texture corruption in CSI: Fatal Conspiracy (Wine Bug #33768)
• Fix unintentional leaks with ntdll internals
• Fix wined3d performance drop introduced by pixelformat changes. (Wine Bug #35655)
• Fix wrong colors in Wolfenstein (2009) (Wine Bug #34692)
• Fix wrong defition of ntoskrnl.IoReleaseCancelSpinLock function.
• Fix wrong version of ID3DXEffect interface for d3dx9_24
• Fix wrong version of ID3DXEffect interface for d3dx9_25 (Wine Bug #25138)
• Forward exitcode from child process when in wineconsole
• Free RPC parameters allocated by application before anything else (Wine Bug #36743)
• GetMessage should remove already seen messages with higher priority (Wine Bug #28884)
• GetMonitorInfo returns the same name for all monitors (Wine Bug #37709)
• GetSecurityInfo returns NULL DACL for process object (Wine Bug #15980)
• Globally invalidate key state on changes in other threads (Wine Bug #29871)
• Graphical issues in Inquisitor (Wine Bug #32490)
• Ignore unsupported flags for CoInternetSetFeatureEnabled (Wine Bug #35197)
• Implement AMStream GetMultiMediaStream functions (Wine Bug #37090)
• Implement D3DXGetShaderOutputSemantics
• Implement DDENUMSURFACES_CANBECREATED in IDirectDraw7::EnumSurfaces (Wine Bug #17233)
• Implement FolderImpl_Items and stubbed FolderItems interface
• Implement ID3DXEffect::FindNextValidTechnique (Wine Bug #34101)
• Implement IDXGIOutput::GetDesc
• Implement a Courier New replacement font (Wine Bug #20456)
• Implement a Microsoft Yahei replacement font (Wine Bug #13829)
• Implement a Times New Roman replacement font (Wine Bug #32342)
• Implement an Arial replacement font (Wine Bug #32323)
• Implement combase.WindowsSubstring function
• Implement default homepage button in inetcpl.cpl
• Implement empty enumerator for IWiaDevMgr::EnumDeviceInfo (Wine Bug #27775)
• Implement enumeration of sound devices and basic properties to dxdiagn (Wine Bug #32613)
• Implement exclusive mode in PulseAudio backend (Wine Bug #37042)
• Implement general tab for file property dialog
• Implement locking and synchronization of key states (Wine Bug #31899)
• Implement mscoree._CorValidateImage for mono runtime (Wine Bug #38662)
• Implement ntoskrnl driver testing framework.
• Implement ntoskrnl.KeInitializeMutex
• Implement proper handling of CLI .NET images in Wine library loader (Wine Bug #38661)
• Implement shell32 NewMenu class with new folder item (Wine Bug #24812)
• Implement special handling for calling GetChildContainer with an empty string (Wine Bug #38014)
• Implement stub for ntoskrnl.IoGetAttachedDeviceReference
• Implement stub for ntoskrnl.KeDelayExecutionThread.
• Implement stubs for ntoskrnl.Ex{Acquire,Release}FastMutexUnsafe
• Implement stubs for ntoskrnl.ObReferenceObjectByPointer and ntoskrnl.ObDereferenceObject
• Implement {Set,Get}ThreadGroupAffinity and related ntdll functions (Wine Bug #36549)
• Improve ReadDataAvailable handling in FilePipeLocalInformation class
• Improve startup performance by delaying font initialization
• Improve stub for AEV_GetVolumeRange (Wine Bug #35658)
• Improve stub for ID3DXEffectImpl_CloneEffect
• Improve stub for NtQueryEaFile
• Improve stubs for AEV_{Get,Set}MasterVolumeLevel
• Improve stubs for AEV_{Get,Set}Mute
• Improve stubs for dxgi MakeWindowAssociation and GetWindowAssociation
• Improvement for heap allocation performance
• Initialize *lpcDevices in RasEnumDevicesA (Wine Bug #30378)
• Initialize System\CurrentControlSet\Control\TimeZoneInformation registry keys
• Jedi Knight: Dark Forces II crashes with winmm set to native (Wine Bug #37983)
• Lego Stunt Rally requires DXTn software de/encoding support (Wine Bug #25486)
• MSYS2 expects correct handling of WRITECOPY memory protection (Wine Bug #35561)
• Make it possible to change media center / tablet pc status (Wine Bug #18732)
• Map EXDEV error code to STATUS_NOT_SAME_DEVICE
• MediaCoder needs CUDA for video encoding (Wine Bug #37664)
• Multiple applications need EnumDisplayDevicesW implementation (Wine Bug #34978)
• Need for Speed 3 installer requires devices in HKEY_DYN_DATA (Wine Bug #7115)
• Only set SFGAO_HASSUBFOLDER when there are really subfolders (Wine Bug #24851)
• Other Pipelight-specific enhancements
• Port Royale doesn't display ocean correctly (Wine Bug #17913)
• Prevent window managers from grouping all wine programs together (Wine Bug #32699)
• Process APC calls before starting process
• Process Hacker 2.x needs ntoskrnl.ProbeForRead (Wine Bug #38103)
• Properly close sockets when WSACleanup is called (Wine Bug #18670)
• Properly implement imagehlp.ImageLoad and ImageUnload (Wine Bug #23455)
• Properly initialize caps->dwZBufferBitDepths in ddraw7_GetCaps (Wine Bug #27002)
• Properly render themed buttons when they are pressed (Wine Bug #37584)
• Reduced SetTimer minimum value from 10 ms to 5 ms (improves Silverlight framerates)
• Report correct ObjectName for NamedPipe wineserver objects
• Return STATUS_OBJECT_NAME_INVALID in wine_nt_to_unix_file_name for paths that only contain a prefix (Wine Bug #39133)
• Return a dummy BIOS name in Win32_BIOS record
• Return a valid mesh in D3DXCreateTeapot (Wine Bug #36884)
• Return an error when trying to open a terminated process (Wine Bug #37087)
• Return correct IMediaSeeking stream positions in quartz
• Return correct values for GetThreadTimes function (Wine Bug #20230)
• Return default palette entries from GetSystemPaletteEntries for non-palette-based devices (Wine Bug #36895)
• Return dummy ID3DXSkinInfo interface when skinning info not present (Wine Bug #33904)
• Return fake device type when systemroot is located on virtual disk (Wine Bug #36546)
• Return proper status codes when NtReadFile/NtWriteFile is called on closed (but not disconnected) pipe
• SHFileOperation with FO_MOVE should create new directory on Vista+ (Wine Bug #25207)
• SO_CONNECT_TIME returns the appropriate time
• Scrolling causes mouse and screen to lock in Call to Power II (Wine Bug #34559)
• Send WM_PAINT event during dialog creation (Wine Bug #35652)
• Set EOF on file which has a memory mapping should fail
• Set NamedPipeState to FILE_PIPE_CLOSING_STATE on broken pipe in NtQueryInformationFile
• Share source of d3dx9_36 with d3dx9_33 to avoid Wine DLL forwards (Wine Bug #21817)
• Show unmounted devices in winecfg and allow changing the unix path
• Silence repeated LocaleNameToLCID/LCIDToLocaleName unsupported flags FIXMEs (Wine Bug #30076)
• Silence repeated wbemprox "timeout not supported" fixme (Wine Bug #37618)
• Skip unknown item when decoding a CMS certificate (Wine Bug #34388)
• Software support for Environmental Audio Extensions (EAX)
• Super Mario 3: Mario Forever fails to load keyboard mapping from profile files. (Wine Bug #18099)
• Support for AllocateAndGetTcpExTableFromStack (Wine Bug #34372)
• Support for BindImageEx (Wine Bug #3591)
• Support for CSMT (command stream) to increase graphic performance (Wine Bug #11674)
• Support for CUDA GPU video decoding
• Support for D3DXGetShaderInputSemantics (Wine Bug #22682)
• Support for DDS file format in D3DXSaveTextureToFileInMemory (Wine Bug #26898)
• Support for DOS hidden/system file attributes (Wine Bug #9158)
• Support for FileFsFullSizeInformation information class
• Support for GetFinalPathNameByHandle (Wine Bug #34851)
• Support for H264 DXVA2 GPU video decoding through vaapi
• Support for ID3DXFont::DrawTextA/W (Wine Bug #24754)
• Support for ID3DXSkinInfoImpl_UpdateSkinnedMesh (Wine Bug #32572)
• Support for Junction Points (Wine Bug #12401)
• Support for KF_FLAG_DEFAULT_PATH in SHGetKnownFolderPath (Wine Bug #30385)
• Support for LoadIconMetric (Wine Bug #35375)
• Support for MPEG2 DXVA2 GPU video decoding through vaapi
• Support for NVIDIA video encoder library (nvencodeapi)
• Support for NtQuerySection (Wine Bug #37338)
• Support for PulseAudio backend for audio (Wine Bug #10495)
• Support for SHCreateSessionKey (Wine Bug #35630)
• Support for TransmitFile (Wine Bug #5048)
• Support for WTSEnumerateProcessesW (Wine Bug #29903)
• Support for extra large and jumbo icon lists in shell32 (Wine Bug #24721)
• Support for inherited file ACLs
• Support for linux priority levels for faster performance
• Support for loader dll redirections
• Support for named pipe message mode (Linux only) (Wine Bug #17195)
• Support for non-blocking SIO_ADDRESS_LIST_CHANGE requests (Wine Bug #38062)
• Support for pasting HTML from Unix applications (Wine Bug #7372)
• Support for process ACLs (Wine Bug #22006)
• Support for setcap on wine-preloader (Wine Bug #26256)
• Support for shell32 file operation progress dialog
• Support for stored file ACLs (Wine Bug #33576)
• Support for ws2_32.dll.WSAPoll (Wine Bug #38601)
• Translate flags in LaunchINFSectionW
• Try harder to get the host name address in getaddrinfo() (Wine Bug #29609)
• Tumblebugs 2 requires DXTn software encoding support (Wine Bug #29586)
• Update a XIM candidate position when cursor location changes (Wine Bug #30938)
• Use GLX_MESA_query_renderer extension to get more exact GPU infos
• Use NVX_GPU_MEMORY_INFO extension for more exact video memory accounting on NVIDIA graphic cards
• Use POSIX implementation to enumerate directory content on FreeBSD (Wine Bug #35397)
• Use actual program name if available to describe PulseAudio streams
• Use manual relay for RunDLL_CallEntry16 in shell32 (Wine Bug #23033)
• Use proper glyph names in wineps driver to allow copying text from generated PDF files (Wine Bug #6416)
• Use video memory for rendering targets if possible (Wine Bug #34906)
• Voobly expects correct handling of WRITECOPY memory protection (Wine Bug #29384)
• Wine ignores IDF_CHECKFIRST flag in SetupPromptForDisk (Wine Bug #20465)
• Workaround for shlwapi URLs with relative paths
• XEMBED support for embedding Wine windows inside Linux applications
• eRacer Demo doesn't correctly display text (Wine Bug #29598)
• ntdll is missing WinSqm[Start|End]Session implementation (Wine Bug #31971)
• wglDescribePixelFormat should return max index for NULL descriptor (Wine Bug #6176)