HOW-TO:Modify the video cache
![]() |
![]() ![]() |
![]() |
This page describes three advancedsettings.xml settings that can be used to maximize the video playback cache. You can use all or just a couple of these settings to see significant improvements in cache performance, should you require it (most users will not require these modifications). This can help with intermittent network issues, buffering, reduce how long the network is tied up, and sometimes improve battery life.
Note: Even if you change the cache settings in Kodi, that won't change how fast the video file data comes in over the network. For example, it won't make a slow server load the video any faster.
Steps
If you don't already have an advancedsettings.xml file, it's very simple to make. Kodi uses this file for advanced settings and features that normal users shouldn't modify without first knowing what they do, as well as for experimental features, etc.
1 | Since you can use all or just some of the following settings, let's start out with the basic file. Create a plain text file (no rich text formatting, don't use .doc, etc) and save it as advancedsettings.xml. Make sure that the file extension is ".xml" and not ".txt" or ".xml.txt". | ||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
2 | Cut and paste this into your new plain text file:
| ||||||||||||||||||||||||||||||
3 | Add some or all of the settings tags from the next section. | ||||||||||||||||||||||||||||||
4 | Save this file in your userdata folder:
Note: If you have an existing file, make sure the The Userdata folder is a subfolder of the Kodi Data Folder and is located as shown in the table below.
|
Cache settings
advancedsettings.xml tag | what it does | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
<buffermode>1</buffermode>
|
Choose what to buffer
This setting will force Kodi to use a cache for all video files, including local network, internet, and even the local hard drive. Default value is 0 and will only cache videos that use internet file paths/sources.
| ||||||||||
<memorysize>20971520</memorysize>
|
Increasing the cache
Here we can do two things:
or
| ||||||||||
<readfactor>10</readfactor>
|
Increase the fill-rate of the cache
By default (value: 4), Kodi will only fill the cache a little above what is needed to play it back. It does this as to not max out your network and possibly max out some hardware. For most users and hardware, this setting shouldn't cause any issues, but be aware of it if you have unusual CPU spikes in your HTPC.
|
Kodi v17 changes
In Kodi v17, the cache-related tags were removed from <network>
and placed under a new <cache>
tag. In addition, the following tags were renamed:
<cachemembuffersize>
was renamed to<memorysize>
<readbufferfactor>
is renamed to<readfactor>
Examples
![]() |
NOTICE: These are just examples to explain how the feature works. Most users will just want to use example 4. |
Example 1
All three options enabled, using local hard drive for cache.
![]() |
Do not use this for flash-based memory devices. |
- advancedsettings.xml
<advancedsettings> <cache> <buffermode>1</buffermode> <memorysize>0</memorysize> <readfactor>30</readfactor> </cache> </advancedsettings>
Example 2
Only cache size changed, using 100MB of RAM for cache (which requires 300MB of free RAM).
- advancedsettings.xml
<advancedsettings> <cache> <memorysize>104857600</memorysize> </cache> </advancedsettings>
Example 3
Two options enabled, using 50MB of RAM for cache (which requires 150MB of free RAM), and cache both internet, LAN, and local content.
- advancedsettings.xml
<advancedsettings> <cache> <buffermode>1</buffermode> <memorysize>52428800</memorysize> </cache> </advancedsettings>
Example 4
A safe setting for most devices with 1GB of RAM that should help most users "on the edge". All protocols get cached, cache rate fills up pretty much as fast as possible, and cache size is about 133MB, using about 400MB of ram total.
- advancedsettings.xml
<advancedsettings> <cache> <buffermode>1</buffermode> <memorysize>139460608</memorysize> <readfactor>20</readfactor> </cache> </advancedsettings>