Home Addon Development Builders & Bloggers: Create Batch Installers for Git Browser (“Kodi Builds”)

Builders & Bloggers: Create Batch Installers for Git Browser (“Kodi Builds”)

0
SHARE

We’ve finally developed a better method of distributing preconfigured Kodi setups, commonly known as “Kodi builds.” This method retires the need to host large backup files, and ensures that customizations are easily auditable by anyone in minutes. Once you get the hang of Batch Installers, you’ll see that this method is far superior to what people are accustomed to currently.

Using this method will ensure that any Kodi addons installed using your preconfiguration are always the latest versions, and also ensures authenticity of code since each addon is downloaded directly from its original developer’s GitHub repository and not some middle man.

In the guide below, we’ll walk you through making a basic Batch Installer preconfiguration, however the possibilities are truly endless. This system uses native Kodi commands and therefore provides an efficient, compatible way to automatically configure Kodi without requiring any dirty “hacks.”

Before making your own, we suggest looking at our community Batch Installer file for inspiration and clarity. Follow this guide to see it in action on Kodi.

Part A: Signup to GitHub + Create a New Repository

Step 1: Register for your own free account at GitHub.

Screen Shot 2018 07 07 at 7.30.03 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 2: When prompted to Choose your personal plan, simply press the green Continue button at the bottom.

Screen Shot 2018 07 07 at 7.30.17 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 3: Either fill out the questionnaire, or press skip this step at the bottom of the page.

Screen Shot 2018 07 07 at 7.30.42 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 4: You’ll now need to verify your email address, check your email for the link.

Screen Shot 2018 07 07 at 7.30.50 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 5: Click on the grey Start a project button.

Screen Shot 2018 07 07 at 7.31.09 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 6: For Repository name put something like: ballerina-batch-gitbrowser

Obviously replace ballerina with whatever you want to call your batch.

Screen Shot 2018 07 07 at 7.31.41 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 7: For Description put something like: Ballerina’s Git Browser Batch for Kodi Addons

Obviously replace Ballerina’s with whatever you want to call your feed.

Screen Shot 2018 07 07 at 7.31.58 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 8: Enable the checkbox for the Initialize this repository with a README field.

Screen Shot 2018 07 07 at 7.32.06 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 9: Click on the Add a license dropdown, and select GNU General Public License v3.0 from the listing.

Screen Shot 2018 07 07 at 7.32.14 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 10: Click on the green Create repository button at the bottom.

Screen Shot 2018 07 07 at 7.32.22 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 11: And just like that, you’ve finished creating your first GitHub repository.

Screen Shot 2018 07 07 at 7.32.30 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Part B: Preparing Files for New Batch Installer

Step 1: Download and extract the examples_batches.zip compressed folder to your Desktop.

Screen Shot 2018 07 07 at 7.45.36 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 2: Open the example_batches folder.

Screen Shot 2018 07 07 at 7.45.52 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 3: Extract the example-gitbrowser.installer-1.0.0.zip compressed folder.

This is the version for those who wish to preconfigure addons without changing the skin.

Screen Shot 2018 07 07 at 7.46.11 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 4: Open the example-gitbrowser.installer-1.0.0 folder.

Screen Shot 2018 07 07 at 7.46.18 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 5: Highlight the manifest.xml file.

Screen Shot 2018 07 07 at 7.46.26 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 6: Right click the manifest.xml file and select the Open With function.

Screen Shot 2018 07 07 at 7.46.44 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 7: Select your text editor or Notepad from the listed applications.

Screen Shot 2018 07 07 at 7.47.14 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 8: Edit the first section of the example manifest file to display your desired name instead of Example. We used Ballerina for the purpose of this guide. Screen Shot 2018 07 07 at 7.48.51 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 9: The second section lists the addon IDs and developers’ GitHub usernames for the Kodi addons to be installed. Edit accordingly.

Dependencies will be automatically retrieved by Git Browser, so no need to include them here. However, repository IDs should probably be included.

Screen Shot 2018 07 07 at 7.50.17 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 10: The second section called Configs contains file replacements should you wish to include certain complete files with your Batch Installer

This is for more advanced users and should likely be erased until you’re more comfortable with the functionality.

Screen Shot 2018 07 07 at 7.50.33 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 11: The third section is called Settings and allows you to preset addon settings according to their optional values.

This is for more advanced users and should likely be erased until you’re more comfortable with the functionality.

Screen Shot 2018 07 07 at 7.50.59 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")Step 12: The fourth section is called Built-In Commands and allows you to run certain Kodi API commands. Read the official Kodi wiki carefully to learn about potential options.

This is for more advanced users and should likely be erased until you’re more comfortable with the functionality.

Screen Shot 2018 07 07 at 7.51.09 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds") Step 13: The fifth and final section allows you to run JSONRPC commands, very powerful stuff when used properly. Read the official Kodi wiki carefully to learn about potential options.

This is for more advanced users and should likely be erased until you’re more comfortable with the functionality.

Screen Shot 2018 07 07 at 7.51.25 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 14: Save your changes once you’re finished compiling your batch manifest.

Screen Shot 2018 07 07 at 7.51.34 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 15: Highlight the manifest.xml file back in your example-gitbrowser.installer-1.0.0 folder.

Screen Shot 2018 07 07 at 7.55.32 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 16: Right click the manifest.xml file and select the Compress manifest.xml function.

Depending on which operating system you’re on, the name of the function may differ slightly.

Screen Shot 2018 07 07 at 7.55.42 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 21: Right click the manifest.xml.zip file you just created and select the Rename function.

Screen Shot 2018 07 07 at 7.56.03 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 22: Edit the filename to appear in the following format: ballerina-gitbrowser.installer-1.0.0.zip

Screen Shot 2018 07 07 at 7.56.14 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 23: This part of the process is now finished, continue reading to upload your Batch Installer to GitHub.

Screen Shot 2018 07 07 at 7.56.20 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Part C: Uploading Batch Installer File to GitHub

Step 1: Return to your newly created GitHub repository, then click on the Upload files button.

Screen Shot 2018 07 07 at 7.32.30 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 2: Select the choose your files function.

Screen Shot 2018 07 07 at 8.01.27 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 3: Select the ballerina-gitbrowser.installer-1.0.0.zip file, and then press the Open button.

Depending on which operating system you’re on, the name of the function may differ slightly.

Screen Shot 2018 07 07 at 8.02.12 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 4: Click on the green Commit changes button at the bottom of the interface.

Screen Shot 2018 07 07 at 8.02.38 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 5: Wait a few seconds for the files to upload to GitHub.

Screen Shot 2018 07 07 at 8.02.43 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 6: You’re finished. Time to tell everyone about your new Batch Installer for Git Browser!

Screen Shot 2018 07 07 at 8.02.53 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Part D: Finding Your New Batch Installer in Git Browser

Required: Git Browser on Kodi 17.0 Krypton or Above

Step 1: Click on the Add-ons tab from the vertical menu bar within Kodi.

Screen Shot 2018 07 07 at 1.00.16 PM 1 - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 2: Select the Program add-ons category from the vertical Add-ons menu bar.

Screen Shot 2018 07 07 at 12.58.20 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 3: Launch the Git Browser tool for Kodi.

Screen Shot 2018 07 07 at 12.58.21 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 4: Press back after reading, to close the instructions prompt on first launch.

Screen Shot 2018 07 07 at 12.58.24 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 5: Select the Search by GitHub Username function.

Screen Shot 2018 07 07 at 12.58.28 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 6: Press the *** New Search *** function.

Screen Shot 2018 07 07 at 12.58.31 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 7: Input tvaddonsco (or whomever’s batch installer you wish to use) using the on-screen keyboard, then press the OK button.

Screen Shot 2018 07 07 at 12.58.35 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 8: Choose the tva-gitbrowser-installer-1.0.0.zip (or whichever other batch installer) file from the listing. Batch Installer files should always be displayed in a light orange colour.

Screen Shot 2018 07 07 at 12.58.41 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 9: Press the Yes button to proceed.

Screen Shot 2018 07 07 at 12.58.44 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 10: Wait a few minutes for the Batch Installer to download and install. Don’t touch anything until it’s complete.

Screen Shot 2018 07 07 at 12.58.48 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 11: Once complete, press the Restart button to finalize the Batch Installer process.

Screen Shot 2018 07 07 at 12.59.59 PM - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Step 12: Relaunch Kodi to find the Batch Installer preconfigured setup ready for use!

Screen Shot 2018 07 07 at 1.00.16 PM 1 - Builders & Bloggers: Create Batch Installers for Git Browser ("Kodi Builds")

Have a Question? Visit our Discussion Forums Today! There's always someone who's eager to be of assistance. Praise is always appreciated as well.

Please remember that our community is supported entirely by volunteers, developers are not paid and updates made to their addons are made during their free time.