- A basic guide to creating a custom Kodi Build:
- Creating our builds.txt file:
- Editing our Wizard Files to show Build File location
- Video Guide:
- Wrapping things up
- Previous Series Guide:
This guide on how to add a custom Kodi Build is a continuation to our “How to make a Kodi Wizard & Repo for both Kodi 18 & 19” guide. This build guide does NOT work for our “simple Kodi Wizard guide“. If you followed our guide “how to make a Kodi Wizard (complex wizard for Kodi 19) then you need to read over this post (How to upload your Kodi Wizard) as it shows you how to create a build file and upload that content to your server.
This Kodi Build guide is only referencing our newest Kodi Wizard/Repo that works for both Kodi 18 & 19!
Assuming you have already completed our “How to make a Kodi Wizard & Repo for both Kodi 18 & 19” guide it’s time to start adding some content to your Wizard. For this to work properly you will need the following.
- Access to a PC with Kodi installed on it
- You can install Kodi to your PC by using the Windows download from the Kodi Website Downloads section.
- Access to an unzip program on your PC like WinRar (which you should already have if you followed our previous guides)
- Text editing software like Notepad++
- The Build File (which we will be editing)
- Access to your Kodi Wizard & Repo for both Kodi 18 & 19
- Access to your web server for uploading
Once you have ensured that you meet those requirements proceed to the next step for creating a Kodi Build.
A basic guide to creating a custom Kodi Build:
We will not be focusing too much on how to create a Kodi Build in this guide however, we will show you the basics.
There are several ways of extracting and gathering the needed files to create a custom Kodi Build. In this tutorial, we will use the simplest method.
- Using a PC download and install Kodi
- Now that you have Kodi installed you can start customizing
- We suggest starting with a premade build. Simply install any kodi build to get started.
- Once you have the build installed you are already halfway done making the build
- You can go a step further and customize the menus, addons, images, and so forth. For this guide we will not be showing you how to do this.
- Now that you have a build installed and maybe you made a few customizations. We now need to take this “custom” build and create the build files.
How to create the Kodi Build Zip file:
- Once you have your build setup the way you want it you can close Kodi
- We need to first locate the “Kodi” files on our PC
- Using the search feature on your computer type in %AppData%
- Open up the AppData folder
- If you scroll down the list you will see Kodi
- Open up the Kodi folder
- Here is a list of the files needed to create our custom build file.
- Select the addons, media, and userdata folders
- Right click and select add to archive
- Winrar will now open up. In the Archive Name box type in the name of your build (your choice)
- Under Archive Format ensure that you select ZIP
- Click OK
- This will create the zip file of your Kodi Build
- Move the zip file to your desktop or another location
How to upload your Kodi Build
- To upload your Kodi Build we suggest using Dropbox
- Go to Dropbox’s website and create an account if you already don’t have one
- Once you account has been created, upload the zip file of your Kodi Build
- In dropbox select the uploaded zip file and click share
- Copy the link
Now that you have created your own custom Kodi Build and uploaded that zip to Dropbox we need to create a builds.txt file. This file is used for your Kodi Wizard so that it can pull in the build information including the name of the build, version number, download links, images, etc.
Creating our builds.txt file:
- Open up Notepad++
- Click file>new
- Copy this code into Notepad++
id="" version="" zip="" name="Example Build 1" version="1.0" url="url.to.build" minor="http://" gui="url.to.guisettings" kodi="19.3" theme="url.to.themes" icon="http://" fanart="http://" preview="https://www.youtube.com/watch?v=djV11Xbc914" adult="no" info="url.to.info" description="A short description of the build."
Editing your Builds.txt File you created:
- With the builds.txt file opened up in Notepad++ we need to edit this information to match our custom build
- For name=” ” you need to create a custom name for your build. Ensure you enter the name between the ” “
- For version= ” ” edit this to show the version number of your build. We suggest starting with 1.0
- For url=” ” paste the url of the sharded zip file from dropbox. If you don’t have it already copied go back to dropbox and click share on the build zip file you uploaded earlier. Then paste it in the url section between the ” “
- When you paste a Dropbox share URL it will end in 0 you need to change the 0 to a 1
- The next line we need to edit is Kodi=” ” type in the version of Kodi your running for your custom build. This should be either 18 or 19. You can include the exact version number like Kodi 19.3
- For adult=” ” type in either YES or NO depending on if your build has adult content.
- By default, the Wizard & Repo you created earlier already has adult turn on so it will show adult builds. Without having this feature turned on if you were to put Yes in the build file for adult then the Wizard would NOT show any builds. So no worries, it’s already turned on for you.
- Lastly, for description=” ” type in a description of your custom build. Just make sure the description is between the ” “
- Now that you have edited your builds.txt file you need to save it.
- Click file>save as>builds.txt
- Ensure you save it inside the master folder for your Kodi 18 & 19 Wizard/Repo
Uploading your Builds.txt File:
So by now you have made your own Kodi Build, Zipped that build, uploaded it to dropbox, and created your Builds.txt file. There are only a few steps left to get this to show up on your Kodi Wizard. First, we need to upload the Builds.txt file to our web server
- Open up your web server where you previously uploaded your Kodi Wizard & Repo files. It should look like this as of now:
- Next, upload the builds.txt file you just created to your servers public_html folder or www. folder.
- You need to upload this file to the same location as your Wizard/Repo folders as shown above.
- Also, ensure this file is named builds.txt not Builds.txt (it is cassensitive)
Editing our Wizard Files to show Build File location
So now that we have our Kodi Build and Builds file complete it’s time to get it to work with our Kodi Wizard. Pro tip- Anytime you make changes to your Repo/Wizard files you need to go through the “zip” process again and reupload those files/folders to your server.
In this part, we will be editing our uservar.py file in both Leia and Matrix folders under the plugin.program.YOUR NAME section. Keep in mind, inside the Leia and Matrix folders you have repository.YOUR NAME and plugin.program.YOUR NAME. Your plugin.program folder is your Wizard whereas repository.YOUR NAME is your repository folder. So in order to edit our Wizard files we need to open up the plugin.program.YOUR NAME folder in both Leia and Matrix.
- Open up your Master folder
- Next, start by opening up the Leia folder first
- Right-click on uservar.py as we did in the previous lesson and select open with Notepad++
- On line 20 in the uservar file we need to add in the URL to our builds.txt file
- Keep in mind, everything typed in must match your domain name/location. For example, be sure to either put https or http depending on your domain and ensure you type in the URL of the builds.txt file exactly how it is on your server.
So for us, on line 20 we will be adding in the following URL between the ‘ ‘ marks (http://masterkodi.com) as shown below.
We type in http://masterkodi.com/builds.txt because our builds.txt file is on our server’s main directory under public.html or www. If we placed our builds.txt file in another location for example inside our Leia folder then our URL would be http://masterkodi.com/leia/builds.txt. This is bad practice so we highly recommend uploading files exactly where we state to put them.
Once you have finished editing your uservar.py file save your changes.
Next, inside the matrix folder you need to make the same changes to that uservar file and save.
After you have edited both uservar files (Leia and Matrix) you need to zip up your files again.
Automatically creating the necessary zip files
Below is a refresher from our post “How to make a Kodi Wizard & Repo for both Kodi 18 & 19” on how to create the proper zip files.
- Open up your master folder
- Locate and double click the file _repo_xml_generator.py
- You should quickly notice a command prompt window open and run
- Don’t worry! This is nothing more than python running the script which creates zip files for you!
- To see if this tool ran correctly open up the zips folder inside your master folder
- You should now see a new folder titled the same as your repository folder
- Open up youre repository folder
- You should see a zipped version as shown below. The only difference is it will contain your repository version number. For instance ours is repository.myfirestreams-2.0.zip
- We did not cover version numbers in this guide. It will be part of our customization guide. For now your version numbers should match ours for all content
- Next, open up your Leia folder and run the _repo_xml_generator.py file there
- Again, you should see your newly created zip folders/files inside the zips folder in Leia. This time you will notice two folders. One for plugin and one for repo
- If you open up those folders you should see newly created zips of those. The repo one should have 2.0 and the plugin.program one should be 1.4.9
- Do this again for the Matrix folder.
- Same as with Leia, you should have two new folders and zips with matching version numbers
Uploading files to the server
Uploading these files and folders to your server needs to be done in the correct order for this to work. In our addon.xml files that we edited, we listed those URLs (where we replaced example.com) to match our URLs on our server. In short, your server should be empty as shown below.
Inside your www. or public_html folder on your server, you need to upload the following folders and files from your master folder.
- Open your master folder>zips>repository.YOUR NAME>and copy your zipped version to your servers main director along with the files above.
You do NOT need to upload each file individually (except for your zipped repo). By simply uploading the folders it will also upload everything inside those folders to your server. See the final upload picture below.
If you followed our steps correctly, your server should look like this:
Wrapping things up
When you access your Kodi Wizard inside Kodi you should now see a builds menu option that will show your newly updated Kodi Build. If you do not see any builds listed then you missed an important step. It is highly recommended that you start this guide over if your build is not showing up. Are you having issues getting it to work? Reach out to us on our forums for support!
Did you know that you can add multiple builds to your wizard? To do this all that is needed is for you to copy the same code used for the builds.txt file and paste it below the original code. You can do this as many times as you’d like. Have builds for both versions of Kodi? Simply add them all to the same builds.txt file but be sure to list which version of Kodi they support on the builds.txt file.
Once you have done this a few times it will be like second nature to you. It seems complicated at first but the whole process only takes a few minutes to complete. The most important thing to keep in mind is to make sure you are keeping your names the same and ensuring you are listing the proper URLs.
We are always here to help so again if you need help reach out to us on our Forums for support.
In the next guide for this series, we will be showing you how to customize your Wizard and Repo even further. Stay tuned!
Previous Series Guide:
Do you want a single Kodi Wizard and Repo that works on both Kodi 18 and 19 versions? Look no further! In this guide, we will be showing you how you can easily make your very own Kodi Wizard and Repo that can be used on both Kodi versions. This guide does require that the …