Last Updated: 2016-12-02
LAV Filters 0.70
Important Notice: The developer of DSPlayer has decided to step away from this project due to personal reasons. All links remain active, so this set up guide will remain in place.
Krypton 17.0 is available on the first page of the DSPlayer forum.
The Jarvis release is the focus of this guide. Jarvis 16.1 should be stable for most users and will work with madVR v0.90+.
Isengard 15.2 is compatible with madVR v0.89.13.
Visit Troubleshooting Tips for an in-progress list of known fixes for current DSPlayer issues.
New to Kodi? Try this Quick Start Guide.
Guide: Building a 4K madVR HTPC
This tutorial is dedicated to the set up of DSPlayer as a primary video player using madVR as the video renderer. This is Windows-only software.
The DirectShow Player (DSPlayer) branch of Kodi has been active for several years. Using popular DirectShow filters such as LAV Filters, FFDShow and ReClock, DSPlayer has traditionally provided an alternative to Kodi’s FFmpeg-based DVDPlayer. However, with the addition of madVR video rendering, this branch has the potential to be the premier way to enjoy high-quality audio & video playback with Kodi.
What is madVR? madVR is a GPU-assisted video renderer known for its advanced scaling algorithms and quality-at-all-cost approach to video presentation. madVR integrates into the Kodi interface by combining it with DSPlayer and a DirectShow filter pack such as LAV Filters. This eliminates the drawbacks associated with external players as the Kodi GUI remains accessible during playback and start and resume points work as they do with the default player.
The quality of madVR with LAV Filters is capable of besting even high-end Blu-ray players such as the Oppo BDP-103D with a capable graphics card and some knowledge of correct set up. It should offer an immediate advantage over DVDPlayer, where output is done at 8-bits though DXVA scaling logic. madVR offers full 16-bit processing dithered to 10-bits or less avoiding the GPU's low-quality hardware scaling regions. The software is known for its advanced image scaling such as Jinc, super-xbr, NNEDI3 and NGU, which possess lower levels of ringing and aliasing compared to traditional resizers. Its high bit-depth, dithered output will produce a more precise image with fewer rounding errors and less overall noise, while its upscaling is capable of rendering a cleaner, sharper image. This should even be apparent with content displayed at its native resolution.
Other advantages of DSPlayer come from access to features in the DirectShow library. This could include the use of ReClock or FFDShow to perform audio post-processing and channel mixing; the use of specialized video decoders such as the Strongene Lentoid HEVC/H.265 decoder; or the addition of frame interpolation provided by the Smooth Video Project (SVP). DSPlayer offers access to the full suite of DirectShow filters.
Click here for an introduction to what madVR scaling can do for video content.
Screenshot comparison of DSPlayer and MPC-HC with LAV Filters & madVR.
List of scaling algorithms used by Kodi DVDPlayer.
This DSPlayer Configuration Guide Includes:
- Introduction to DSPlayer & List of Required Software;
- DSPlayer Set up;
- LAV Filters, XySubFilter & ReClock Set up;
- madVR Set up;
- Other Resources;
- Troubleshooting Tips.
A complete media player is comprised of many parts. Understanding these components is useful in understanding DSPlayer set up.
The process of decoding and rendering a media file can be split into three components:
- Audio & Video Filters
- Video Renderer
- Audio Renderer
Source Filter: Reads source files and generates the appropriate output pins for the file type to be read by the splitter.
- e.g. LAV Source
- e.g. LAV Splitter
- e.g. LAV Video
- e.g. LAV Audio
- e.g. XySubFilter
The video renderer receives the output from the video decoder and deinterlaces, upscales, converts to RGB, resizes and applies any post-processing before rendering an image to the display.
- e.g. madVR
The audio renderer receives the output from the audio decoder and communicates with the audio device. This can lead to further post-processing or bit-exact delivery of the audio streams.
- e.g. Sanear or ReClock
DSPlayer is a media player designed to take the place of the default Kodi player codenamed DVDPlayer. It is a complete media player with player controls and an integrated OSD. The player distinguishes itself from DVDPlayer by using its own set of DirectShow filters as defined in mediasonfig.xml and filtersconfig.xml. The player also uses its own custom video renderers.
Set up in this guide focuses on using LAV Filters as the filter set, XySubFilter as the subtitle filter, madVR as the video renderer and ReClock as the audio renderer. Completing set up requires access to the following:
- DSPlayer Installer
includes LAV Filters & XySubFilter;
- ReClock audio renderer (optional).
- Internal filters: Use the filters installed with DSPlayer.
- Media rules and Filters configuration: Use mix of internal/external filters with manual configuration.
- System filters (DirectShow merits): Use existing system filters, ignoring the filters installed with DSPlayer.
- Run the Kodi installer (Jarvis 16.1) to overwrite existing copies of Kodi on your system and replace with the integrated DSPlayer.
- Install madVR: http://forum.doom9.org/showthread.php?t=146228 (v0.88.21 & later)
To install madVR, extract the zip file to the Program Files directory and run the "install.bat."
- Optional – Install ReClock: http://www.videohelp.com/software/ReCloc...how-Filter
- Open Kodi and navigate to DSPlayer settings (Video -> DSPlayer).
- Select madVR as the Video Renderer.
- Set Filters management to Internal filters.
- Configure each filter to your personal hardware: - Splitter, - Video decoder, - Audio decoder, - Subtitle filter.
- Play a test video to configure madVR. Test the performance of your settings using Cntrl+J.
DSPlayer installers are released in concert with official releases of Kodi. This installer is identical in appearance to the default Kodi installer and will remove old versions of Kodi and integrate DSPlayer and its setup menus into Kodi.
DSPlayer installers are released by the branch’s maintainer aracnoz. The most recent link is always available in the first post of the DSPlayer official forum.
You can find the DSPlayer Krypton installers here: http://forum.kodi.tv/showthread.php?tid=...pid1972183
MediaPortal and Argus TV – Live TV Users
Built-in support is available for live TV streams using the rtsp protocol. This service has been tested with MediaPortal and Argus TV PVR backends. Instructions and required add-on settings are found here: MediaPortal and ArgusTV PVR.
NextPVR – Live TV Users
Support for NextPVR using the http protocol is also possible. Instructions for NextPVR are found here: NextPVR Directshow Filter for DSPlayer.
Video Add-ons – Streaming Content
Playback of most http/https streams from video add-ons is possible with DSPlayer using LAV Splitter Source. The odd incompatibility may be encountered where add-on links are loaded instead by DVDPlayer. The use of DSPlayer for streaming sources does come with limitations. Currently, buffering issues, failure to load streams and slow navigation may be experienced with some add-ons. If you find playback or navigation is suffering, it is possible to substitute DVDPlayer as the video player.
A copy of playercorefactory.xml is linked below, which contains instructions pre-configured to reroute all Internet protocols (e.g. streaming content) to be played with DVDPlayer.
Move the included playercorefactory.xml from DVDPlayer merits to:
DVDPlayer merits: https://drive.google.com/file/d/0B2LAr9I...sp=sharing
Emby for Kodi Users
Emby for Kodi users must configure Emby Server for compatibility with DSPlayer. Compatibility requires path substitution is used for folders on the server. This entails converting the path of each Emby folder into the folder's actual path on the computer. A direct Windows path is needed for DSPlayer to correctly read and play each file.
An example of path substitution is shown below:
Emby Server -> Library -> Path Substitution
Each media source listed in the Folders tab requires its original path.
If using external filters and customized configuration files, it may be desirable to back-up your DSPlayer settings. When using the Backup add-on for system backups, you must select the dsplayer folder in the userdata directory as a custom directory. This folder is not backed-up by default by the add-on.
Kodi Backup add-on:
To back-up the DSPlayer configuration files, select the dsplayer folder as a custom directory.
ReClock Audio Renderer
The purpose of the ReClock DirectShow Filter is to get rid of jerky playback of video material (AVI, MKV, DVD, Blu-ray, etc) on a PC or a PC connected to a TV or Projector. This software includes an audio renderer supporting WASAPI Exclusive playback. WASAPI provides applications with exclusive access to audio devices so bitstreams are passed directly to the audio output device without any interference from the audio driver or Windows Mixer. Use of Reclock is optional but recommended due to its breadth of audio customization options and performance.
ReClock set up is covered at the end of Section 3.
Summary of Required Software
With all software installed, you should be set up with the following components:
- Frontend – Kodi DSPlayer Edition
- Audio & Video Filters – LAV Filters and XySubFilter
- Video Renderer – madVR
- Audio Renderer – ReClock