What is a Wizard?
In Kodi, a Wizard is a plugin program that allows users to not only install Kodi Builds but Addons as well. The Wizard that we will be discussing in this post can not only install your custom Kodi Builds but it can do much more!
Wizard Source Files:
You may not be aware but Kodi developers have many “open source” codes available for you to use and distribute. For this tutorial, we will be using the “openwizard” source code in which we will be editing, later on, to fully customize our Kodi Wizard.
Get your Wizard source files:
Let’s Get Started:
Once you have obtained your free open-source Kodi Wizard source files you can proceed to the steps below. In these steps, we will walk you through the whole process of getting your Kodi Wizard fully customized.
- First and foremost you will need to extract the .zip file you downloaded earlier.
We recommend using WinRAR to extract the .zip file. If you don’t have WinRAR you can download a free copy of the software here.
- Go to the file location where you downloaded the zip
- Right-click on the zipped file and select Extract Here
- Now that you have an unzipped version of your source file it’s time to start editing the code.
- Open the unzipped file “plugin.program.openwizard-master”.
- Here you will see a list of files that are needed for your Kodi Wizard to work properly.
- First let’s get an easy to use notepad editor so that we can easily update the code. We suggest using Notepad ++ for this. You can obtain your copy of Notepad ++ by clicking here.
- Now that you have Notepad++ installed it’s time to start coding.
- First, open up the file addon.xml (you may need to set notepad ++ as your default editor or simply right click on addon.xml>select open with>Notepad++
- This is your Wizards addon code. There are a few changes you should make in this file to customize it to your liking.
- First, change the “addon id” from plugin.program.openwizard to plugin.program.YOUPICKYOURNAME. In this example, we will be using plugin.program.myfirestreams
- Just to the right of addon id you will see “name”. Change this to a name of your choice. We will be using Myfirestreams. You can edit the font style/color or just type in the name.
- Next, you will need to select your “version-number”. In this example, we will be using 1.0 however you can choose any version number you’d like.
- Just to the right, you will see “provider-name”. You can leave this as it is to give credit to the creator or change this name to something else. In this example, we will change this to Myfirestreams.
- Now scroll down and look for Summary and Description. Both are located on lines 17&18. You will need to edit this information to your liking. For this example, we are only changing the word “open” to Myfirestreams.
- If you scroll down to line 21 you will see “source”. We suggest that you edit this to show where you will be hosting your wizard. For us, we will use http://masterkodi.com/plugin.program.myfirestreams.
- On line 22 “news” you can edit the information below this to represent your “version”. For this example, we will remove all of the information and type in 1.0 Initial Release
- Using Notepad++ save the file. You are now finished editing the addon.xml file CONGRATS!
- Now that you saved your addon.xml you will need to open the uservar.py file in Notepad++. Again, make sure you right-click on uservar.py>select open with>Notepad++
- In the uservar.py file we will be making several changes to ensure our Wizard functions properly.
- Under the section “User Edit Variables” we will first be editing lines 16,17,&18 (ADDONTITLE, BUILDERNAME, and EXCLUDES)
- For addontitile we suggest using the same name you used in the addon.xml. Just change the name and leave wizard. We used Myfirestreams Wizard. This will be the title of your Wizard in Kodi. You can edit the font/color if you choose.
- Next, for Buildername again we suggest using the same name as before. We will use Myfirestreams.
- On line 18 (Excludes) you will ONLY need to change “openwizard”. Leave repository. In this example we will use repository.myfirestreams (all lower case. THIS MATTERS)
- Now look for line 20 (Buildfile). We will be creating a builds.txt file later on in “How to upload your Kodi Wizard”. You need to edit this to represent where the file will be hosted. Example http://example.com/builds.txt. For this example we are using http://masterkodi.com/builds.txt
- If you scroll down to line 80 “Contact” you can edit this to represent your contact information. We will change this information to show Myfirestreams as the name and our website as the contact url.
- Scroll down to line 99. Although we are not creating a repository in this guide you will need this if you follow our repository guide later on. Use the same name as line 18. We used repository.myfirestreams (Again all lowercase)
- Lines 101 and 102 will be in our repo guide. You do not need to edit these at this time.
- On line 117 you can edit this to show your Wizard name. We used Myfirestreams Wizard. Again, you can edit the font style/color if you choose.
- Using Notepad++ save the uservar.py file.
- You have now completed your Kodi Wizard setup. We will be making a part 2 to this guide to show you how you can further customize this Wizard.
- Finally, if you return to the unzipped file location you will need to rename this file. Make sure you rename this file to the same name you used on the addon.xml file under addon id. We used plugin.program.myfirestreams
Creating the addons.xml file:
- After you have renamed the file open it backup and then open addon.xml copy line 1 and the beginning of line 2 stopping after <addon
- Using Notepad++ click file>new
- Paste the copy code in the new file.
- After the “n” on addon type an s> to make it <addons>
- Hit enter to go to the next line. (line3)
- Hit enter one more time so that you are on line 4. Type </addons>
- Return to the addon.xml file.
- Copy from <addon to the very bottom. **Do not copy line 1. Only copy from line 2 to the very end.
- Return to the new file. and paste this in line 3 between <addons> and </addons>
- Click file>save as> and name this file addons.xml
- Save the file to your same location as the zip/unzipped file. For us it’s in our downloads folder.
Creating the Addons.xml MD5 file:
- Open up the addons.xml you just created.
- Right click on the opened file in Notepad++ and click select all
- Copy everything in this file
- Open up your web browser and go to this website http://www.miraclesalad.com/webtools/md5.php
- Paste everything you just copied in the box
- Copy the md5 code that was generated for you.
- Return to Notepad++
- Click file>new and paste the md5 code in this file.
- Click file>save as> Select the same location where you just saved your addons.xml
- Name this save addons.xml.md5
Creating our Wizard Zip file:
- Now you should be back at your file location that contains your unzipped file that we rename plugin.program.myfirestreams (or whatever you named yours)
- Right-click on that file and click “Add to Archive”
- Winrar will now open up. Ensure that you click on Archive Format and select ZIP. Click OK to start zipping your plugin.program file
You have now completely finished setting up your custom Kodi Wizard using the free source files provided.
Be sure to save the following files as you will need these to upload your Wizard:
- In this example, we made a folder titled Completed Kodi Wizard and uploaded the following file to this folder.
- Unzipped edited plugin.program file
- Zipped file of the edited plugin.program file
- Addons.xml file
- Addons.xml.md5 file
- Before you can upload your new custom Kodi Wizard you will need one more file before it will work. You will need a builds.txt file. This will be covered in our guide on how to upload your How to upload your Kodi Wizard.
Having trouble with any of the steps above? Leave us a comment below so that we can help.