Add-on:Library Node Editor

From Official Kodi Wiki
Jump to navigation Jump to search

Library Node Editor

See this add-on on the showcase

Author: Unfledged, Team-Kodi

Type: Program
Repo: repo v20 repo v19 repo v18

License: GPL-2.0-only
Source: Source code
Summary: Manage custom library nodes.
Home icon grey.png   ▶ Add-ons ▶ Library Node Editor
Attention talk.png Need help with this add-on? See here.

Create and edit custom library nodes.

1 Installing

To install this add-on you must do so from the Add-on manager from within Kodi by going to

  1. The home screen
  2. Add-ons
  3. Download
  4. Program Add-ons
  5. Library Node Editor
  6. Install

2 About

The Library Node Editor allows you to create and customise custom video nodes and music nodes within Kodi.

3 Anatomy of a Custom Node

3.1 Parent nodes

Parent nodes act like folders - they contain nodes, and can contain parent nodes. You can also add rules to a parent node, which will be applied to all nodes immediately within it.

3.2 Nodes

Nodes describe views of your media. They can include multiple elements which describe what media Kodi will display, and how it will filter it. A new node will let you set one of two parameters, either 'Content' or 'Path'. If you select 'Content', then you will be able to create a node based on various rules. If you select 'Path', you will be able to create a node which links directly to a library path with various path components specified within the editor.

3.2.1 Content

Set content to the type of media that Kodi will display in this node. Either Movies, TV Shows, Episodes or Music Videos for a video node; Artists, Albums or Songs for a music node. Once content is set, new options become available. Order

Set the property of the media that it will be ordered by in the view. You can select the property (title, year, director, etc) and the direction that it will be ordered (ascending, descending) Grouping

Group media be a given property (genre, actor, director, etc) Limit

Limit the number of results that will be returned Rule

A rule that must be matched by any content that will be returned. Rules are made of three parts - the property of the media that is being queried (title, year, director, etc); the operator (Is, Is Not, etc) and the value that must be matched.

3.2.2 Path

Set content to a particular videodb:// or musicdb:// address provided by Kodi. For example, for recently added movies, videodb://recentlyaddedmovies/. You will then be able to specify additional components of the path to customise what content will be available.

4 Examples

4.1 Add a 'Recently Viewed' node

To add a new 'Recently Viewed' node which shows the last 20 watched items to an existing parent node:

  1. Open the Parent Node you wish to add the Recently Viewed node to
  2. Select 'New Node...' and give it the title 'Recently Viewed'
  3. Open the 'Recently Added' node you just added
  4. Select 'Add content...' and choose the content that matched the Parent Node you are using
  5. Select 'Add limit...' and type 20 in the dialog
  6. Select 'Add order...'
    1. Select 'Title' and change this to 'Last played'
    2. Select 'ascending' and change this to 'Descending'
    3. Back out of the 'Order' property by clicking '..' or pressing Back

4.2 Limit content by path

To add a new Parent Node for video nodes which only shows movies from a particular path. (This presumes that differing types of media you want to display are kept in different sources. In this example, the source is smb://anime/)

  1. Select 'Video Library'
  2. Select 'New parent node...'
    1. Type a title which corresponds to the type of media you want to display, for example 'Anime'
    2. Choose 'Movies' when asked which defaults to start with. This will give you all the nodes you will find under the default 'Movies' Parent Node
  3. Open the new Parent Node you just added
  4. Select 'Add Rules...'
    1. Select 'Title' and change to 'Path'
    2. Select 'contains' and change to 'starts with'
    3. Select '<No value>' and type in 'smb://anime/' OR select 'Browse for value', open the source containing your media and click OK.

All nodes within your new Parent Node will now be limited to content from that path.