# Manage-Kodi-Favourites
This Kodi Program Addon allows you to manage your Kodi favourites by sorting, inserting or swapping items and/or adding a prefix, suffix, a filter  and color to you Kodi favourites

![icon](MB-KODI-icon.png) ![icon](Manage-Kodi-Fav-icon.png)  

# Program Addon: Manage Kodi Favourites

This is a simple & lightweight KODI Program Addon that lets you quickly manage your Kodi favourites list that works on multiple Kodi skins. Use this Program Addon to easilly Manage (i.e. move, sort, add a prefix or suffix, a filter and color code Favourites) by inserting or swapping entries, using the sort function and/or adding Color, prepending a Prefix or appending a Suffix and/or Filter to entries in your Kodi Favourites list.

> [!NOTE]
> (Latest) - This is the latest version of the Manage Kodi Favourites
> 
> Supported by MB-KODI ✔️

Latest Version Manage Kodi Favourites :sunglasses:
- Added ability to laumch the Kodi Filemanger
- Added ability upload/download favourites file as well as download Kodi log file
- Added ability for users to add a Prefix, Suffix and/or Filter or Color each. Set the default actions in the configuration panel and easily and graphically modify entries in the Kodi Favourites list
- Added ability to "Sort" and "Filter" Favourites
- Added Help screens
(Latest)

<a href="Manage-Kodi-Favourites-3.0.zip">Manage-Kodi-Favourites-3.0.zip</a> (Latest)

This <font COLOR="blue"><B>MB-KODI Manage Kodi Favourites</B></font> Program Addon is published as a Kodi Program Addon that you can install directly into Kodi or via the MB-KODI Repository. It is a publicly available Kodi Addon supported by MB-KODI.<br />
<br />
<B>Installation Instructions</B><br />
<B><font COLOR="blue">1</font></B> - In Kodi use the "File Manager" to add a new 'source' pointing to one of these sources: <br />
<ul>
<li>http://borsch.myqnapcloud.com:8089/Manage-Kodi-Favourites</li>
<li>https://m-borsch.github.io/Manage-Kodi-Favourites</li>
</ul>
<B><font COLOR="blue">2</font></B> - In Kodi use the "Addons" - "Install from zip" option to install the Addon utilizing the 'source' that you added in the previous step<br />

# How to use

> [!IMPORTANT]
> Depending on the settings that you set in the configuration/setting panel for the Addon, this Addon will either **Add a Prefix/Suffix and/or Filter** codes to items and/or add a **Color** to items in your Favourites list as well as allow users to easily and graphically **Sort or Move items** by **inserting/swapping** entries or using the built-in **Sort** function to quickly 'alphabetize' your Favourites. Using Kodi's built in 'Filter' option, users can then quickly manage their Favourites i.e. filter lists to show just those items based on the Prefix/Suffix/Filter code or colors that they have modified in their Favourites list.

### Pickists

Default Picklists are provided, however if you do not want an action to apply, you simply select 'None'. Also, you can provide a 'Custom' entry by selecting the 'Custom' option and an editable text field will appear. This applies to Prefix, Suffix, Filter codes and associated Colors.
 
**Prefix Pickists**:
>Text - Select the Text to be "prepended" to a selected item. e.g. "NONE,TV - ,Movie - ,Show - ,Custom"
>
>Color - Select the Color to be applied to the Prefix. e.g. "NONE,green,yellow,blue,cyan,orange,purple,white,Custom"
 
**Suffix Pickists**:

>Text - Select the Text to be "appended" to a selected item. e.g. "NONE, - # Samsung TV+ #,Custom"
>
>Color - Select the Color to be applied to the Suffix. e.g.  "NONE,green,yellow,blue,cyan,orange,purple,white,Custom"

**Filter Pickists**:

>Text - Select the Text to be "appended" to a selected item. e.g. "NONE, ŒŒ, ŒR. ŒM,Custom"
>> ***NOTE:*** may have compatibility issues with Windows installs depending on your skin default font set. Workaround is to use ***Custom*** option and not use special characters in 'Filter' tags. 
>
>Color - Select the Color to be applied to the Filter. e.g.  "NONE,green,yellow,blue,cyan,orange,purple,white,Custom"

> [!TIP]
>### Filtering Your Favourites List:
>Using Kodi's built-in <B>"FILTER"</B> option, you can easily 'filter' your favourites list by Color, the Prefix, the Suffix or by using the Filter codes that you have added to your entries. This allows users to quicky manage their Favourites list. For example, use the built-in Kodi filter function to search for:
> - Enter "Movie" to show a list of Favourite entries tagged with a prefix of "Movie -"
> - Enter the "ŒŒ" 'Filter' tag to produce a Favourites list showing just those entries tagged with "ŒŒ" (Non-Windows installs)
> - Filter by Color - Enter "green" to produce a list showing just those entries tagged with the color "green"

## ADDON Main Menu
> [!IMPORTANT]
> If you make a change to your Favourites list using "Manage Kodi Favourites" - make sure after you return to the main menu that you use one of the "Save" options to 'lock' in your change. Otherwise, your edits will be lost! Also, once saved, users must use an option to **Reload** their user profile to see the changes that have been made to their Kodi Favourites list.

### 1) Manage Your Kodi Favourites...   
Opens a dialog where you can view and reorder your Favourites items usin the Insert/Swap functionality or add a Prefix with Color and/or a Suffix with Color.

**Add a Prefix and Color,  Suffix and Color, or FIlter and Color**
- To modify an items, select an item "A" to "mark" it, then select **Apply "Pre/Suffix/Filter.."** button to apply the current settings as displayed on the dialog in yellow  
(If an item is marked, you can select it again to unmark it.)  
- Press the Close button to close that dialog when you're done editing (your changes won't be saved yet).  
- If you've made some mistakes and want to start over, press the "Exit" button to abandon any changes you made to your favourites - i.e. This will undo any changes.

**Insert/Swap**
- To reorder items, select an item "A" to "mark" it, then select another item "B" to either **"SWAP"** or **"Insert"**.  
(If an item is marked, you can select it again to unmark it.)  
- Press the Close button to close that dialog when you're done editing Your changes won't be saved yet. Make sure to use one of the 'Save' optikns to lock in your changes.  

**Sort**
- This will 'alphabetize' (i.e. sort) your Favourites list. When used with a "Suffix", you can organize and/or group your favourites into categories, etc. - all stored in alphabetical order.

### 2) Apply Changes (Save-Exit-Reload Your Kodi Profile)
Saves your changes and reloads your Kodi profile, so your changes can be seen immediately instead of you having to restart Kodi to see them.
   
### 3) Save and Exit (Save-Exit-No Reload Your Kodi Profile)
Saves your changes, exit the Addon but doesn't reload your Kodi profile (as this operation can crash in some Kodi builds and you may wish to wait to reload your profile). After using this, you have to manually restart Kodi or use the 'Reload Profile' option within this Addon to see your changes.

### 4) Save Only (Save-No Exit-No Reload Your Kodi Profile)
Saves your changes but doesn't exit the Addon nor reload your Kodi profile. This option allows you to save your changes but keep working. After using this, you have to manually restart Kodi or use the 'Reload Profile' option within this Addon to see your changes.

### 5) Exit & Reload Profile (No Save-Exit-Reload Your Kodi Profile)
Exits the Addon and Reloads your Kodi Profile. Use this to load the last saved version of your Kodi Favourites file with all your recent changes.

### 6) Configure...(Change Settings) 
Call up the Settings Dialog to change default Insert/Swap actions, Thumbnail size, Font size on labels and Colors as well as set the Prefix and Suffix text.

### 7) Advanced - Download Current Favourites file (Advanced! - Save a Copy of favourites.xml file.
This is an advanced function that allows users to manually download a copy of their favourites file (favourites.xml). Users must enable this option in the Configure-Settings-Advanced section of the configuration panel for the Addon.

### 8) Advanced - Upload Kodi Favourites file, Leave Changes Pending a Kodi Restart or Reload Profile.
This is an advanced function and should be used with caution. It allows users to manually overwrite their favourites file (favourites.xml) with a new file of the same name. Users must enable this option in the Configure-Settings-Advanced section of the configuration panel for the Addon.

### 9) Exit (No Save-Exit-Abandon Any Unsaved Changes)
Abandon your edits. Just steps back from the Addon, no saving.

## Help Screens Available in the Addon

### Overview:

<img src="Manage-Kodi-Favourites-Help-Overview.png" alt="Overview" width="600">

### Settings - Prefix / Suffix:

<img src="Manage-Kodi-Favourites-Help-Prefix-Suffix.png" alt="Settings - Prefix/Suffix" width="600">

### Settings - Thumb / Font / Reorder / Insert/Swap:

<img src="Manage-Kodi-Favourites-Help-Insert-Swap.png" alt="Thumb/Font/Color & Insert/Swap" width="600">

### Settings - ADVANCED:

<img src="Manage-Kodi-Favourites-Help-Advanced.png" alt="Overview" width="600">

### Main Menu:

<img src="Manage-Kodi-Favourites-Help-Menu-Items.png" alt="Main Menu" width="600">

### GUI - Graphical User Interface:

<img src="Manage-Kodi-Favourites-Help-GUI.png" alt="GUI" width="600">

### Reference Articles available at: <a href="http://borsch.ca">borsch.ca</a>

- <a href="http://borsch.myqnapcloud.com:8083/index.php/articles-by-group/how-to/howto-create-a-github-kodi-addon?highlight=WyJrb2RpIl0="><b><i></i></b><i>Article on how to build a Kodi Repository and an Addon on borsch.ca</i></a>

Questions/Comments/thanks - <a href="mailto:kodi@borsch.ca">Send an email to MB-KODI</a><br />
<hr>
<p><img class="an1" draggable="false" src="https://fonts.gstatic.com/s/e/notoemoji/15.1/26a0_fe0f/72.png" alt="âš ï¸" width="20" loading="lazy" data-emoji="âš ï¸" aria-label="âš ï¸"> No Copyright infringement intended <img class="an1" draggable="false" src="https://fonts.gstatic.com/s/e/notoemoji/15.1/274c/72.png" alt="âŒ" width="20" loading="lazy" data-emoji="âŒ" aria-label="âŒ"> <a href="mailto:kodi@borsch.ca">Send an email to MB-KODI</a> to fix / Remove. (<span style="font-size: 8px;"><em>NAS</em></span>)</p>

<hr>

> [!IMPORTANT]
> MB-KODI Terms and Conditions / Disclaimer

Information published on or related to MB-KODI® repository is accurate and correct to our knowledge, however, there may be omissions, errors, or mistakes. Content published on or related to MB-KODI is for informational purposes only. By continuing to use these services, you agree to the following Terms and Conditions. 

Terms and Conditions / Disclaimer

This disclaimer ("Disclaimer") is a legally binding agreement between you ("user," "visitor," "you" or "your") and this repository ("MB-KODI", "we," "our," or "us"). It sets forth the general guidelines, disclosures, and terms of your use of this repository ("repository", "addons", "plugins", "services," "products," "information," or "content") operated and/or offered by MB-KODI.

Please read this disclaimer carefully before continuing to use this repository. Do not access and use the repository if you do not agree to the terms of this disclaimer. By using this repository or its services, you acknowledge that you have thoroughly read and also understand the terms of this disclaimer and hereby agree to be bound thereof.

General Disclaimer

The information or content displayed on this website/repository/addon is the intellectual property of the owner of MB-KODI. You may not reuse, republish, or reprint such information or content without our consent.

All the information or content related to MB-KODI is published in good faith and solely for general information and educational purposes. They are not in any way intended to serve as a substitute for professional advice. Our website/repository/addon is provided on an "as is" basis, and the author makes no representations or warranties of any kind or in any form, whether express or implied, about the completeness, timeliness, reliability, availability, validity, suitability, and accuracy, or guarantee that there will be no losses, errors, and omissions with respect to the information, or content contained on this website/repository/addon. Any action taken in reliance on any such information or content provided is strictly at your own risk.

As a result, the owner, its partners, employees, or agents will not be held liable for any accruing loss or damage as a result of the use of, reliance on, and reference to our repository, including without limitation, any special or incidental, direct or indirect, and punitive, or consequential loss or damage whatsoever.

We make every effort to keep the repository running smoothly. However, we take no legal responsibility and will not be liable if the website, repository or any addons are unavailable or inaccessible due to technical malfunctions beyond our control.

External Links Disclaimer

Through our repository, you can follow links to visit external websites, repositories, addons or content originating from third-parties that are not in any way affiliated with MB-KODI. While we try to provide only quality links to relevant and ethical websites, we have no control over the nature, content, accuracy, adequacy, reliability, validity, and availability of these sites. Accordingly, the inclusion of such links to other websites, repositories, addons does not in any way imply a recommendation or endorsement for the services or products contained on those sites. Also, owners and content may change without notice and may occur before we have the opportunity to remove broken or harmful links.

Professional Disclaimer

MB-Kodi does not contain professional advice. This site's information and content are provided for general information and educational purposes only and are not substitutes for professional advice.

We recommend that you also consult with the appropriate professionals before taking any actions based on such information, as the use or reliance of any such information contained on this site is solely at your own risk.

Affiliates Disclaimer

MB-KODI may contain links to affiliate sites, and we may receive an affiliate commission for any purchases made by you on those sites using such affiliate links.

Please know that other sites may have different privacy policies and terms beyond our control when you leave our website/repository/addon. MB-KODI does not monitor or investigate any transaction between you and any such third-party. We recommend checking the Privacy Policies of these sites and their Terms and Conditions before uploading any content or engaging in any business or transaction.

Testimonial Disclaimer

MB-KODI may contain testimonials by users of services or products that reflect such users' experiences and opinions. However, such experiences, opinions, and thoughts are personal to such users and do not necessarily represent all other users of our services or products. Testimonials are displayed verbatim except in grammatical and typing errors and long and extraneous information. Please be aware that the views or opinions in such testimonials belong to the user and do not represent the views of MB-KODI. As a result, the testimonials should not be construed as representing the adequacy, reliability, validity, and availability of such services or products.

Changes and Amendments

We reserve the exclusive right to change or modify this policy and its terms at any given time by posting the updated version here. Notification of those changes will be promptly posted on this site should we update, amend, or modify this document. The continued use of this website and its services after any such changes shall be construed to be consent to such changes. However, we advise you to frequently visit this disclaimer to ensure that you are up-to-date with the latest changes.

Consent

By proceeding to use MB-KODI, you hereby acknowledge that you have read this disclaimer in its entirety and hereby consent to this disclaimer and agree to all of its terms. If you do not agree to be bound by the terms of this disclaimer, you are not permitted to continue to use or access MB-KODI and its services.

