MicroJen Template Overview

What is MicroJen?

MicroJen is an addon written by the Community for the Community. It is free to use but has no scrapers integrated into it. This addon does not host any of the content which is found and has no affiliation with any of the content providers. This addon is a base to add links and lists into. Use at your own risk!

How to Install MicroJen

1. Add an Icon Add an icon to the main MicroJen folder. It should be 512 x 512 and it must be called icon.png

2. Add Fanart Add fanart to the main MicroJen folder It should be 1920 x 1080 and must be called fanart.jpg

3. Changing the addon.xml Change the addon id and name and anything else you need to suit your addon.

4. Change the name of the folder Change the name of the folder from plugin.video.microjen to the addon id in your addon.xml

5. Changing the main.xml Open resources/settings.xml Add your path to your main menu xml file to the default="". If it is a website URL, enter the full URL.

Upgrading MicroJen

1. Slide over your icon, fanart.

2. Edit the addon.xml to reflect your original addon and bump the version number up ( If Required )

3. Zip up the new folder and add the correct version number to the end eg. plugin.video.microjen-1.1.zip

4. Push out new version

MicroJen Plugins

How to Add a Plugin

1. Plugins are found in resources/lib/plugins

2. The plugin.py can be found in resources/lib

3. Disabled plugins can be found in resources/lib/DISABLED .

4. To use one of the disabled plugins. Move it from DISABLED folder to resources/lib/plugins folder

5. You can see where you can overwrite default behavior. If there are any other useful ones, open an issue.

Hosting

Hosting for XML and Thumbnails (Overview and Tips)

1. Root XML setting and even links to other menu files are always the full URL to the file

				<dir>
				<title>Cartoons</title>
				<link>http://www.example.com/menus/cartoons.xml</link>
				</dir>

2. Images, such as Fanart and Thumbnails, are always the full URL to the file

				<dir>
				<title>Cartoons</title>
				<link>http://www.example.com/menus/cartoons.xml</link>
				<thumbnail>http://www.example.com/artwork/toonicon.png</thumbnail>
				<fanart>http://www.example.com/artwork/toon_fanart.jpg</fanart>
				</dir>

3. Root XML setting and even links to other menu files are always pre-pended with file://

Local xml files root path starts in the xml folder under your Addon.

				Example for an xml file in the root of your xml folder

				<dir>
				<title>Main Menu</title>
				<link>file://main.xml</link>
				</dir>

You can put xml files locally in subfolders to help organize them better. Just include the subfolder name as part of the path

				Example for an xml file in the subfolder named toons under the xml folder

				<dir>
				<title>Cartoons</title>
				<link>file://toons/cartoons.xml</link>
				</dir>

You can link to thumbnails and fanart from folders in Kodi using the "special://" links like below

				To access artwork from your addon, or any other addon, use special://home/addons as the first part of the path

				<dir>
				<title>Cartoons</title>
				<link>file://toons/cartoons.xml</link>
				<thumbnail>special://home/addons/plugin.video.microjen/resources/media/toonicon.png</thumbnail>
				<fanart>special://home/addons/plugin.video.microjen/resources/media/toon_fanart.jpg</fanart>
				</dir>

Using Github for Hosting

How to get Raw URL

1. Click on the file you want the URL for.

2. Click on the raw icon.

3. Copy the URL in the address bar.

Using Pastebin for Hosting

How to get Raw URL

1. Click on the file you want the URL for.

2. Click on the raw icon.

3. Copy the URL in the address bar.

Formats for Jen

You can find all xml formats in xml/other/jenformats.xml

You can find all json formats in xml/basics.json

Adding Customized Icons

Add these to your main.xml in order to add these icons to your startup screen.

Just change plugin.video.microjen to your addon id

Settings

Settings are found in resources/settings.xml

Dev Mode in settings if set will save detailed info to log.

Either hide or remove dev mode from settings xml or remove / disable the do_log function. Before releasing your addon.

List Colors

You can change a list color for lists by opening the py files and changing the title color.

Only the title above the meta tag needs changing. See below. Change blue to whatever color you want.

				Movies
				xml = "<item>" \
				"<title>[COLOR blue]%s[/COLOR]</title>" \
				"<meta>" \
				"<content>movie</content>" \
				"<imdb>%s</imdb>" \
				"<title>%s</title>" \
				"<year>%s</year>" \
				"</meta>" \
				"<link>" \
				"<sublink>search</sublink>" \
				"<sublink>searchsd</sublink>" \
				"</link>" \
				"<thumbnail>%s</thumbnail>" \
				"<fanart>%s</fanart>" \
				"</item>" % (title, imdb, title, year, thumbnail, fanart)
				return xml

	
				TV Show
				xml = "<dir>"\
				"<title>[COLOR blue]%s[/COLOR]</title>"\
				"<meta>"\
				"<content>tvshow</content>"\
				"<imdb>%s</imdb>"\
				"<tvshowtitle>%s</tvshowtitle>"\
				"<year>%s</year>"\
				"</meta>"\
				"<link>trakt_tv_show(%s, %s, %s, %s, %s)</link>"\
				"<thumbnail>%s</thumbnail>" \
				"<fanart>%s</fanart>" \
				"</dir>" % (title, imdb, title, year, trakt_id, year, title, tmdb, imdb, thumbnail, fanart)
				return xml

				TV Seasons
				xml = "<dir>"\
				"<title>[COLOR blue]Season %s[/COLOR]</title>"\
				"<meta>"\
				"<imdb>%s</imdb>"\
				"<content>season</content>"\
				"<season>%s</season>"\
				"</meta>"\
				"<link>trakt_season(%s,%s, %s, %s, %s, %s)</link>"\
				"<thumbnail>%s</thumbnail>" \
				"<fanart>%s</fanart>" \
				"</dir>" % (season, imdb, season, trakt_id, season, year, tvtitle, tmdb, imdb, thumbnail, fanart)
				return xml

				TV Episodes
				xml = "<item>"\
				"<title>[COLOR blue]%s[/COLOR]</title>"\
				"<meta>"\
				"<content>episode</content>"\
				"<imdb>%s</imdb>"\
				"<tvshowtitle>%s</tvshowtitle>"\
				"<year>%s</year>"\
				"<title>%s</title>"\
				"<premiered>%s</premiered>"\
				"<season>%s</season>"\
				"<episode>%s</episode>"\
				"</meta>"\
				"<link>"\
				"<sublink>search</sublink>"\
				"<sublink>searchsd</sublink>"\
				"</link>"\
				"<thumbnail>%s</thumbnail>" \
				"<fanart>%s</fanart>" % (
				title, imdb, tvtitle, year, title,
				premiered, season, episode,
				thumbnail, fanart)
				xml += "</item>"
				return xml

First Time Install And Dependencies

Make sure you either have all the dependencies installed from your addon.xml .

Converting XML files to the JSON file format

1. You will need Python 2 or 3 installed on your PC.

2. Download the microjenConverter.py

3. Create a folder (Convert) and put the microjenConverter.py inside the folder

4. Whilst inside the convert folder. Create a folder called xmlFiles

5. Put your XML files inside the folder named xmlFiles

6. Run the microjenConverter.py, and the JSON files will appear inside the folder named jsonFiles