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 end-user have some knowledge of how coding works as well as how to upload these files into a web server. Beginners can still follow this guide as we will do our best to help walk you through the process.
Please ensure that you follow each step in order. Failure to do so could and probably will result in errors!
Getting the necessary Kodi Wizard and Repo Files
The Kodi Wizard and Repo files that we are providing are open-source files that can be found online. We have slightly tweaked these files to allow for a better experience. Our files are already preconfigured with the best optimal settings for the best experience. We have also changed up some of the default text so you can easily configure all the files without needing to dig into them too much.
All of this information will be explained further in detail as we go through the setup process. Before you can begin you will need to have access to several free programs and files. Please use the links below to download the necessary files. These files are safe to download however we always recommend running a quick virus scan before doing so. You can use VirusTotal to scan each of the URLs listed below to ensure they are safe for downloading.
- You will need this free program or one like it so that you can easily “unzip” these compressed files
- Notepad ++
- Notepad ++ is a great free program that can be used to edit the code within these Kodi Wizard and Repo files. It’s a much better program to use rather than standard word editing programs.
- Kodi Wizard and Repo Files
- These are the files you will need to create your very own Kodi 18 & 19 Wizard and Repo.
- Python 3.8.1
- In order to run the “auto zip” function within the Kodi Wizard and Repo you will need this version of Python installed on your PC. We will explain this in more detail later but just know it allows you to fully zip up all the necessary files and folders with just one click. Without this you would have to create your own zips and folders which can be VERY time consuming!
Once you have downloaded all the content listed above be sure you go ahead and install each of the programs onto your PC. We suggest moving the zipped version of the Kodi Wizard and Repo to your Desktop for easier access. You can choose to move this file to another location just ensure you know where you have moved it to.
Unzipping your Kodi Wizard & Repo File
To unzip your Kodi Wizard & Repo file please do the following ( Windows 11 users, if you get an error when clicking EXTRACT ALL simply right-click on the zip file again>select show more options>Then click Extract ALL from that menu) :
- Right Click on the file titled Online Course – Single Kodi Repository.zip and select EXTRACT ALL (Windows 11) or EXTRACT HERE (Windows 10)
- This will create a unzipped folder of that file in the same location where your previous file was located. If done properly you should now see these two files.
- Next, go ahead and open up the new folder called Online Course – Single Kodi Repository. Open up the folders until you reach repository.YOUR NAME.master.
- The folder called repository.YOUR NAME.master is your MAIN REPO FOLDER that contains all the necessary files and folders for your Kodi 18 & 19 Wizard/Repo.
- As you can see we have already added the part YOUR NAME into this folders name. This is where you can change the name of your MASTER folder. You will notice throughout this guide that we have added YOUR NAME into certain parts that should be changed. We highly suggest that you try to keep your Kodi Wizard and Repo the same name. If you choose to go with different names just ensure that you are putting the correct name in the correct place as we move forward.
- For now, go ahead and select the YOUR NAME part of the master folder name and rename this to something of your choosing. For example we are changing our master folder name to repository.myfirestreams.master Take note that we leave on the “master” part so this represents to us that this is our “master” folder containing our main Repo/Wizard.
If you’d like, you can move your master repo folder outside of the Online Course – Single Kodi Repository folder for easier access or choose to leave it where it is. We are going to move this folder so it’s more easily accessible.
Explaining the folder and files within your master folder
Moving forward we will only be dealing with our “master” folder and the files and folders within it. At this time go ahead and open up your master repo folder so that you can see its contents. You should see the folders and files as shown below.
We are going to briefly explain what each of these folders and files is. Starting from top to bottom, first, we have the Leia Folder. This folder contains your Kodi 18 Wizard and Repo for Kodi 18 only. Next, you have the Matrix Folder which contains all of the Kodi 19 Wizard and Repo folders/files. The Presets folder contains caching presets that are used by your Wizard files. By default, the Presets folder contains optimal caching settings for high-end devices, low ram devices, zero caches, and default settings. These files should NEVER be messed with unless you know what you are doing!
Next, you have your repository. YOUR NAME folder. This folder contains your repo information and is shared with both the Leia and Matrix versions. It is coded to work for both versions of Kodi which allows you to only use ONE repo! It will automatically determine which version of Kodi you are running and only provide content for that version. This is why this Kodi Wizard and Repo guide is so good!
The Zips folder will contain all the zipped files needed to install content on Kodi (example, repo, wizard, addons, etc.)
The _repo_xml_generator.py file is your (Python) file that will be used to automatically create the necessary zip versions of your folders/files.
Lastly, your index.html file is what is used so that Kodi knows where to find your Repo zip file which will be located on your web server. Feel free to browse into each of these folders, even more, to get a better understanding of how they are laid out. Please ensure you do not edit or remove any content as this will prevent them from working. As we edit these files and folders we will explain even more about what it is you are doing so don’t overthink them right now.
Editing your Repository
Before we begin, as we stated earlier when we renamed our “master” folder we highly suggest keeping all the names the same. This goes for not only the repo folder names but also the names of your wizard. This just ensures you keep everything the same without mixing anything up. Failure to name something correctly will cause it not to work, so it is just easier to keep everything similar.
Open up your “master” folder and locate the folder called repository. YOUR NAME. As we did before with our master folder change the YOUR NAME part to the same name you used for your master folder. For example, we changed ours to repository.myfirestreams as shown below.
Now that you have changed the folder name go ahead and open up your repository folder. Keep in mind as we move along your folder’s names will change depending on the name you pick. After we edit the YOUR NAME part out we will only be referring to those folders as either repository or plugin.program etc. So to clarify, we changed our repository. YOUR NAME folder inside our master folder to repository.myfirestreams. Now we are opening up repository.myfirestreams.
You should now see three files inside this folder. The first is an addons.xml file and two image files.
In this particular guide, we will NOT be discussing in detail how to change images for both your repo and wizard however you can do so if you’d like. Before you add any images or change them please ensure you do the following.
- Keep image file names the same (example, fanart.jpg should be fanart.jpg on the new image)
- Also, please ensure you keep the image sizes the same. (example, icon.png should be 512×512 on the new image)
- Failure to keep file names the same or image sizes the same will result in either an error or missing images inside of Kodi!
As we stated at the beginning, we suggested you use Notepad++ for your editing. You can use any program you’d like but Notepad++ makes for a great “code” editing program. You may need to change the way file types are opened up in Windows 10/11. Start by right-clicking on addon.xml and selecting open with and look for the Notepad++ program. You may need to choose the “choose another app” option and locate the Notepad++ program via your file system. Normally you can find this in C: Drive> under program files (x86)>Notepad++>and select the notepad++.exe file.
Alternatively, you can change how files are opened within Windows 10/11 settings. For this option, we are going to change our default program for opening .xml files to Notepad++. This way always ensures that a certain file type will always open using the selected program. Since we are editing a lot of .xml files its best to change our default app for .xml to Notepad++. To do this follow the steps below.
- Right-click on Windows Start
- Select Settings
- In the search bar in settings type in default file and select the option called “choose a default app for each type of file”
- Scroll down the list until you find .xml
- Select the .xml and choose a default app for opening that type of file. Again, we suggest using Notepad++ and you can locate that app using the steps listed above.
Now that you have Notepad++ setup and ready to open XML files it’s time to edit our first XML file. Return back to your master folder and open up the first repository folder. Open up the addon.xml file using Notepad++.
You should now see this file inside Notepad++:
To make editing this file easier we are going to take advantage of the “replace” feature using Notepad ++, also known as Find and Replace. If you are using another program then we suggest that you find EVERY instance of YOUR NAME and replace the YOUR NAME text with your repository name. Again, we are following this guide by keeping all names the same!
For those using our guide with Notepad++, you will need to click on “search” on the menu and then select “replace”. Once opened you should see the box listed below.
In the “Find what” box type in YOUR NAME and in the “Replace with” box type in the name of your repo. Please ensure you type in the names correctly and keep in mind everything is case-sensitive. For example, make sure you type in YOUR NAME and not Your Name. With the replace with box ensure you type in your repo name exactly how you did when renaming the folders. We used myfirestreams and not Myfirestreams. This is extremely important!
Once you have those typed in click the “Replace All” option and Notepad++ will automatically find and replace all instances of YOUR NAME with your new repo name. If done correctly, you should now see that the YOUR NAME text inside the coding has been changed to whatever your repo name is.
Looking at the addon.xml even further you should see several instances of https://example.com. We need to change this information to that of your web server where your files will be stored. To do this we are ONLY going to be editing the domain name only and not the subdirectories.
Click on search and replace again. This time in the “Find what” box type in http://example.com and in the replace box type in your domain name. For example, we typed in http://example.com and replaced it with http://masterkodi.com as shown below. Once you have the names typed in click replace all to edit all the text.
If you followed our steps exactly you will notice that there are no corrections. This is because we did not type in the address correctly. You should type in https://example.com not http://
We did this to show you that you need to ensure you are putting in the information correctly at all times! Change the find what text to https://example.com and when you put in your domain ensure you are either using http or https. Now hit the replace all button and it should replace all URLs with your domain.
If you notice on line 25 that the address is still showing as https://www.example.com. This is because there was www. in the url. Again, make sure your domain names are kept the same! Either http/https or with/without www. Using the replace feature again, type in https://www.example.com and replace it with your domain name. When finished your file should look similar to this.
Save your changes to your addon.xml file and return back to your master repo folder. Your Repo is now complete!
Copying Repo folder into Kodi folders
Since we only need ONE repo folder for both versions of Kodi, rather than editing both Leia and Matrix repository folders/files, we are simply going to copy and paste them. To do this simply open up your master folder and do the following.
- Inside your master folder select and copy the folder titled repository (again, this will be repository. whatever name you picked. For us, we are copying the folder titiled repository.myfirestreams)
- Next, open up the leia folder
- Paste your repository folder into the leia folder.
- Inside the leia folder select the folder titled repository. YOUR NAME and delete that folder
- Return back to your master folder and open up the matrix folder
- Again, paste your repository folder into the matrix folder and delete the repository. YOUR NAME folder
- Both leia and matrix folders should now look like this
At this point, your repo is 100% complete! All that’s left is to edit our Kodi Wizards, create our zips, and then edit our index.html file.
Editing Kodi Wizard Files
Unlike with our repository folders/files we will need to edit each file/folder separately for both Leia and Matrix Wizard files. This is because the Kodi devs changed their Python coding when they made the switch from Kodi 18 to 19. We wish there was a simpler way but sadly this isn’t the case. This process isn’t hard but it can be somewhat repetitive.
We are going to start by editing our Leia Wizard before we move on to Matrix.
Start by opening up your master folder and then open up your Leia folder. The folder titled plugin.program. YOUR NAME is your Kodi 18 Wizard folder. We need to change this folder’s name to match our other repo folders. Select the YOUR NAME part and replace it with the repo name you have been using. For example, we replaced plugin.program. YOUR NAME with plugin.program.myfirestreams as shown below.
Next, open up your plugin.program folder for Leia and you should see the files and folders listed below.
Brief explanation of Kodi Wizard files
There are a lot of folders and files within the plugin.program folder. We will not be going over all of these in this guide. There are a lot of customization options you can choose from by editing some coding but this would require a whole new guide. For customizing a Wizard we do plan on releasing a new guide strictly for that. For now, we are only going to cover the files we will be editing.
Starting with the addon.xml file, this file contains the name, version, and location of your Wizard. This is the same type of file as your repo addon.xml. Although those two files are different they both contain the same important information. The fanart files and icon file are images that are used by your Kodi Wizard. As we previously stated, you can choose to edit these now rather than waiting for our new customization guide but please remember to follow the steps we stated earlier (sizes and file names).
The uservar.py file is an extremely important file when it comes to Kodi Wizards. This file contains everything about your repo, updates, notifications, contact info, URL locations, and much more. You can review everything by opening this file and reading over the green text. Please keep in mind that this is NOT an XML file and instead it is a Python file or .PY file type. In order to open this file and read it/edit it you will need to right-click on it and select open with. Then select Notepad++. We can’t change the default program for PY files since we need those files to be opened with Python (generator file). So instead we are left having to manually open these file types.
Editing Addon.xml file
Inside the Leia folder, click on the plugin.program folder and open up the addon.xml file using Notepad++. We will be editing this file the same way we did with our repo addon.xml file.
Go ahead and replace the YOUR NAME text in this file with the name you have been using for your repo/wizard. Once you have finished that, edit the URL and replace it with your domain name. Remember, only change https://example.com with your domain name. Do NOT edit the subdirectories of that URL. For example, ours shows http://masterkodi.com/leia/zips/plugin.program.myfirestreams so we only replaced the http://masterkodi.com part.
If you need a refresher on how to edit addon.xml file please click below to review this section
Once you have finished editing the plugin.program addon.xml it should look similar to this.
After ensuring that all the proper changes have been made go ahead and save this edited file.
Editing Uservar File
Now that you have edited your addon.xml file for your plugin.program in Leia it’s time to edit our uservar.py file. In order to open this file for editing, you will need to right-click on it and select open with. Then select Notepad++. If you don’t see Notepad++ click choose another app and locate the Notepad++.exe file as we previously stated.
Once opened you should see the following content
To keep this simple, we are going to be using the “replace” feature in Notepad++ to edit this file as we did with the addon.xml files. By now you should be familiar with how to use the find and replace feature, if not please scroll up and review this information.
Start by clicking on the search menu and selecting replace. Next, in the find box type in YOUR NAME, and in the replace box type in the name of your repo/wizard. Again, this name should be kept the same as we have stated multiple times. If you did go with another name be sure you are using the correct name. Once you are ready click replace all and this file will remove YOUR NAME and replace it with the name you selected.
Next, we need to replace the URLs with our own by removing https://example.com. To do this use the replace feature again and in the find box type in https://example.com With the replace box type in the same URL you used with the repo addon.xml file. For example, we are using http://masterkodi.com.
Next, review save this file.
You may have noticed that there are several locations listed on this file for builds, notifications, YouTube, addons, etc. We will cover this content in a separate guide which will show you how to create your own builds etc. This guide is only meant to show you how to get a working repo and Kodi Wizard that works for both Kodi 18 & 19 versions.
Congrats! You now have a working Kodi 18 Wizard! So now you have set up your Repo and created your own Kodi 18 Wizard. Our next step is to create our Wizard for Matrix.
Creating and editing your Matrix Wizard files
Here is where things get repetitive as we previously stated. In order to create your Wizard files for Kodi 19 Matrix, you will need to perform the same steps as you did for Leia. As a quick review you will need to do the following:
- Change plugin.program folder name by removing YOUR NAME
- Edit addon.xml file
- Change images if you wish (This content wasn’t discussed)
- Edit uservar.py file
For a full explanation please use the button below to read over how to edit this content using our guide for Leia.
Once you have completed that then your Repo and Wizards are 100% complete and ready to use. Bare in mind, we have not covered how to add builds or further customize your wizards/repo.
Automatically creating the necessary zip files
Now that we have completed everything we need to zip up these files. To do this we have an automatic generator that can be used to do it for you. This is why we recommended that you install Python at the beginning of this guide. Version 3.8.1 is what is needed. Some other versions do not work. To create zips do the following.
- 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
Creating the Index.HTML file
This is the last step! We have fully created our Repo and Wizard files and zipped them up. These files are ready to be uploaded to your webserver now. Before we can finalize this we need to ensure we have a way to tell Kodi how to access these files. To do this we need to edit the index.html file.
Return back to your master folder and open up the zips folder. Next, open up your repository folder. Copy the full file name for the zip. For instance, we are copying repository.myfirestreams-2.0.zip. Once you have that name copied return back to your master folder.
Next, right-click on the index.html file and select open with Notepad++, or any text editing program will work. Even the regular notepad would work.
Once opened, replace YOUR NAME with the name of your repo. However, we want to ensure that your names match completely so we suggest selecting repository.YOURNAME-2.0.zip and pasting in the name you just copied. Do this for both parts but ensure you do NOT remove anything else, ONLY THE FILENAME. Make sure both file names end with .zip
Save your index.html file
Congrats! Your Kodi Wizard and Repo are ready to go! All that’s left is to upload them to your webserver.
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.
At this point, you can get on Kodi and add your domain just as you would when installing addons/repos. See the images below.
Notice how Kodi (We are on Kodi 19) only pulls up ONE repo file. This is the file we listed on our index.html file. Go ahead and install the zip.
Now choose Install from repository on Kodi. You should see your newly installed repository.
Click on your repository and select the programs add-ons. This way we can install our newly created Kodi Wizard. Keep in mind, your repo will automatically give you the correct version of this Wizard depending on which version of Kodi you are running.
If everything has been done correctly you should now see this.
Since no builds have been added to this Wizard once you click continue nothing will happen. You can click on the Wizard addon again in Kodi to open it but just know there are no builds.
Congrats on completing this tutorial. If you have any questions please use our Support Forums to reach out. Stay tuned for an updated guide on how to further customize your Wizard, Repo, and add builds.
Checkout other guides in this series:
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 …