Kokotime now has a new feature, since version 2.0 addons have been introduced to Kokotime bringing a new era to the app. With addons now available on Kokotime users can access a wide variety of new content provided by content providers anywhere. If a video is available on the internet and an addon exists for that service you can access all the content on that service via a 3rd party addon while enjoying kokotime's elegant user interface and media player. Addons can be implemented in unlimited types of ways, our main goal is to let the community focus on the content while we focus on the user interface !

How do they work ?

Addons are a very simple concept, Kokotime is prepared so that small bits of code can be created by anyone and loaded into the app as long as these bits of code comply with the Kokotime requests. In other words an addon can be made for any source of content on the internet or for any media server/service personal or public.


Addons are not part of the app, meaning that Koktime does have access to the source code of any unoffical addon. They can be created by any developer, uploaded to an addon repository and then installed by users either through the in-app Addon store or manually by downloading them from an external website. Addons found on the official store are not developed by us unless indicated otherwise, because of that we have no control over their behaviour or the bugs they might cause. Please keep that in mind when using addons on Kokotime since this can affect your user experience.


Installation

Addon installation is a very simple procedure, we made it so that the installation flow is as user friendly as possible, so you don't need to be a tech freak to install any addon I mean hey even a kid could do it!

There are two main ways to install addons :

  • In app installation
  • SD card or external installation

We will go through both of them in this tutorial even though in app installation is probably the one you will use the most.

In App Installation

IMPORTANT : Before you start this step make sure you have linked the addon manager to an addon store, by default the addon manager is automatically linked to Kokotime 's official repository but on some versions you have to link it manually. You will be prompted to set the server url when you open the addon manager enter the repository you would like to use, it can be an external repository or our official one. For more info you can read about addon stores on the Addon store page

Go ahead and fire up kokotime navigate to the Addons button in the main menu you will find it under this icon click it and you should find yourself on the addon page. There you can manage your installed addons or find new ones, go ahead and browse the available addons until you find one that suits your needs, hit the install button and wait a few seconds for it to download and install. Addons are normally really small in size it only takes seconds for them to download and install. Once the addon is installed you should see a on the installed addon.

Tip : If you are having trouble loading the installed addon or the addon causes app to crash on launch try unsinstalling the addon, restarting the app and reinstalling the addon once again. If the issue still persists you can contact the addon developer so he can attempt to solve the issue.

The in app addon store is updated automatically with the latest available addons for Kokotime, make sure to check the addon store frequently for new addons. Because the community has direct access to the addon store new addons can be uploaded daily so make sure to check for new addons from time to time !

External source installation

You most likely are wondering why you would want to install addons from an external source but hey thats what addons are all about ! Providing the ability to install addons from any source enables users to find addons for kokotime all over the internet and install them to their device with only a few easy steps. Even though installing addons from your sd card is possible only kokotime specific addons can be installed on kokotime !

Warning : Downloading and installing addons from external websites can be dangerous, even though we do not monitor addons users can always report dangerous addons and we will remove them immediately. So make sure you trust the source before installing the addon.

To install an addon from a third party source download the addon file with a .jar extension and place it anywhere in your device's storage. Open up kokotime and head over to the Addons page once again and click on the import button located on the top-right corner of the page, navigate to the folder where you placed your .jar file and select it, confirm the addon details and thats it ! If the addon is valid and installs successfully it should be visible in the main menu. If you get an error while installing the addon you will get an option to contact the addon's developer for assistance if he provided an email in the addon's setup file.


Usage

Now that you have successfully installed your desired addons all thats left to do is enjoy your media ! All your installed addons will be available on Kokotime's main menu, there is currently no limit to the number of addons you can install at once.

Depending on the type of installed addon once you click on your addon in the menu the app will load a layout based on the addon the addon can then load its content into the apps layout, there is currently 2 types of layouts :

  • Season based layouts
  • Movie based layouts

Each one of these layouts will allow you to browse the content in Kokotime and watch it in the apps native player except if the addon is created to redirect you to an external website or source of the content provider.


Updating your addons

Addon updates are automatically managed by kokotime since version 2.0.5, when a new version of an installed addon is available kokotime will automatically update it in the background so next time you start up kokotime your addons are up to date. This allows developers to fix addon issues and the fixes will be applied automatically before you even notice that there is an issue with a specific addon !

Warning : Addons installed from outside the in app addon store cannot be updated automatically !


Removal

Uninstalling addons is as easy as installing them, you will not always keep all the addons you install, to uninstall an addon simply navigate to the Addon manager and in the downloaded tab click Uninstall to remove the addon and all its saved files including favorites, watch list etc...


Getting started with kokotime addon coding

Kokotime addons are coded in Java so to start creating addons for kokotime you need to have a minimum of knowledge or experience in the Java coding language.

To start you will need the following :

  • Eclipse IDE for java developers available here
  • kokotime SDK jar file compatible with the version of kokotime you are developing for, the latest sdk is available here kokotime_sdk_v1 JavaDocs included
  • kokotime builder/compiler here
  • Java Development Kit available here

Setting up your project

Once you are done downloading and installing all the necessary software and files you can start setting up your project and working on your addon

Creating a new project

Open up Eclipse and click on File > New > Project.

A new window should open and your screen should now look like this :

Click on the Java Project and give a name to your addon project

Your project folder will be created and added to the side left panel of eclipse, we can then move on to the next step and add the Kokotime library to your project.

Now that you created your project your project panel should look like this :

Importing the kokotime library

Now you can import the kokotime library, right-click on your addon folder folder and click Build path > Configure build path

click on Add external jar and add the Kokotime library your downloaded earlier on in the tutorial, now that the Kokotime library is added you need to create your package and main class, this part is essential so that Kokotime can read your addon, right click src > new > package and create a package called addon, then, in your newly created package create a new Java class and call it Main.java.

Warning : The package name and class name MUST be identical to the ones indicated above or else the app will not be able to launch your addon once it is installed.

Your final project panel should now look like this :


Coding your addon

Once you finish the steps above you can now start coding your addon and generating custom content to be displayed on Kokotime. To get started you will first need to do a few more steps.

Choosing an addon type and implementing the correct interface

The kokotime library includes two main interfaces that you can implement in your main class depending on the type of addon your are wishing to create. For the moment the available interfaces are :

  • MoviesAddonInterface
  • SeriesAddonInterface

When you implement one of those interfaces you will then be able to override the methods available and return the content specific to each method.

Example : For example the getFeatured() method must return an ArrayList of MovieItem objects, the returned objects will then be displayed on the featured pager on the home page of your addon.

Here is an example of an addons Main class that implemented a MoviesAddonInterface

Normally Eclipse will manage all the imports from the Kokotime library by itself and will also override all the unimplemented methods by itself once you click Add unimplemented methods as shown below


Adding the data file

The data file is a simple data.json file that will contain info on your addon, the data in this file will be used when you upload the addon to the Kokotime addon store but also when users install your addon from an external source.

A sample data.json file can be downloaded below

Sample : data.json

Make sure to remove the comments and input the correct types of values for each variable, when completed add this file under the src directory of your addon project

The data.json file should contain a json object with the following keys :

Key Type Value Comments
name String Name of your addon No spaces, cannot be changed after you upload your addon to Kokotime store
icon String Url of the addon icon
addon_type_id Number series : 0
movies : 1
description String Short description of your addon
author String Alias or name of developer Account name will be used instead when uploading to Kokotime store, this value will only be used when installing from external source
author_email String Email of developer Account email will be used instead when uploading to Kokotime store, this value will only be used when installing from external source
build Number Current build of your addon Should be incremented by 1 upon each update
kokotime_version Number Current kokotime sdk build you are using Check kokotime sdk for value
download_url String The direct download url of the addon This value is only necessary if your are uploading your addon to an external addon store or if you are hosting your own addon repository. Make sure the url contains a protocol http or https.
language_code String The ISO 639-1 language code of the language the content served by the addon is in The default is English but if you are serving content in a different language it is always better to indicate the language code.

Exporting/Building your addon

Once you are done coding your addon you will need to first export your addon project then "compile" it with a dex compiler to translate the java classes to a dex file that can be read by android 's dalvik virtual machine

Exporting your java project to a .jar file

If you are familiar with java and Eclipse this will be straight forward. To get started right-click on your addon project folder and click Export > Java > jar file and setup the export options as illustrated below

Once you click finish your .jar file will be available on the path indicated in the export setup.

You now have your addon as a jar file containing java classes, to be read by kokotime you will need to compile this jar file to a new jar file containing a classes.dex file. To do this, navigate to the kokotime compiler downloaded at the start of the tutorial and place the jar file exported from Eclipse and rename it addon.jar, run the jar2dex batch file and it will output your final file which you can then upload to our addon store, that's it you're done !