The complete guide to The Promise on Kodi [Retired]

The Promise is a Kodi add-on that allows you to stream movies and TV shows using free, premium and official sources. Based on The Oath, The Promise has all the features from its predecessor and adds a couple of new ones like specialized sections for IPTV, sports, documentaries, cartoons, and comedy.

IMPORTANT: The Promise and The Warehouse repository are no longer available. Please take a look at our favorite Kodi add-ons for laternatives to The Promise.

This add-on offers Trakt support, library integration, free sources, premium accounts from Real Debrid, Premiumize, All Debrid, and other Debrid services. It can also find sources in official streaming services if you have the corresponding accounts and add-ons installed.

In this guide, we’re going to install The Promise on Kodi. Let’s get started!

1. The Promise Overview

FeaturesMovies and TV shows
Free SourcesYes
Premium SourcesReal Debrid, Premiumize, All Debrid
Source TypeFile hosting websites and cached torrents
Trakt supportYes
Library integrationYes
Other FeaturesIntegrated subtitles, file downloads, Orion indexer support, Providers for official streaming services
The Promise Kodi addon
The Promise's main menu, the TV shows category is selected
source select screen on The Promise

2. How to install The Promise on Kodi

If this is your first time installing add-ons on Kodi, you will need to allow the installation of unofficial add-ons. Please read How to allow 3rd-party add-ons on Kodi and come back here when you’re ready.

2.1. Install TheWareHouse repository

We’ll start by adding a link to TheWareHouse source on GitHub, this allows us to download the repository zip file directly on Kodi.

1. Press the cog icon near the top left corner of the screen to open the Settings menu.
Open System menu on Kodi using the cog icon

2. Select File Manager.
Kodi File Manager on System menu

3. Press Add Source.
adding source using file manager on kodi

4. Enter on the top box and TheWareHouse on the bottom one.  Press OK to add the source. (The URL is case-sensitive). adding a link to TheWareHouse source URL

Now that we added the link, let’s use it to install the repository.

5. Go back to the Settings menu and this time select Add-ons.Kodi Add-on Browser on System Menu

6. Click on Install from zip file.install kodi add-on from zip file

On Kodi 19, you’ll see a message about the auto-update feature. Press Yes to proceed.

7. Select TheWareHouse.seelcting Loonatics source on Kodi

8. Click on to install the repository.installing the Loonatics repo

Wait a couple of seconds while the repository is downloaded and installed. You’ll see a notification when the process finishes.

2.2. Install The Promise add-on

Now that we installed the repository, we’ll use it to install the add-on and its dependencies.

9. Press Install from repository.Install add-on from repository on Kodi

10. Click The WareHouse Repository.opening loonatics repository

11. Select Video add-ons category on Loonatics repo

12. Scroll down and select The The Promise

13. Press the Install button.install The Promise Kodi addon

14. Press OK to install The Promise and its dependencies.list of dependencies for The Promise

Wait a couple of seconds for the installation process to finish. You’ll see a notification when it’s done.

15. Go back to the Home Screen, you should now see a shortcut to The Promise on the Add-ons tab. Press it to open the add-on.The Promise Kodi addon

16. All done! Use the menu to browse movies and TV shows.The Promise's main menu, the TV shows category is selected

You can now stream movies and TV shows using The Promise and Kodi.

The Promise has an integrated subtitles feature, but if you need more control over the subtitle selection process, please read How to enable subtitles on Kodi.

3. Additional Settings

Let’s take a look at some popular features of The Promise. These steps are optional, but can improve your user experience.

3.1. Using Real Debrid with The Promise

The Promise works with free sources, so using a Debrid account is not required, but it is recommended.

File hosting sites often limit file availability and bandwidth for free users. Using premium accounts gives you unrestricted access to several file hosters and cached torrents, it can greatly improve the quality and quantity of available sources.

In this example, we’ll use Real Debrid. A popular service to get unrestricted access to various file hosters and cached torrents for a very low price.

Before starting, we recommend logging into your Real Debrid account using a web browser.

1. Select Tools from The Promise’s main menu.The Promise's main menu, the Tools option is selected

2. Press ResolveURL: Settings.Open ResolveURL settings using The Promise

3. Select the Universal Resolver 2 tab and Press (Re)Authorize My Account in the Real Debrid section.authorize The Promise with Real Debrid

4. Copy the authorization code.copy the authorization code for Real Debrid

5. Use a web browser to visit and enter the authorization code. (You must be logged in with your Real Debrid account).enter real debrid authorization code

6. Enter ThePromise and press Set that name.register The Promise with Real Debrid

You can now use The Promise with premium sources.

Navigate the add-on menu to select a movie or episode. Once you’ve made your choice, The Promise will show a selectable list of available sources.

7. Select a source to start playing the video.source select screen on The Promise

Free sources are displayed in white, premium sources in orange, and official sources in green. There are 3 types of premium sources:

  • Cached Torrent: The file is already on the Real Debrid cloud, and it is ready to be downloaded.
  • File Locker Site:  The file will be downloaded directly from the specified File Hosting website.
  • Uncached Torrent: The magnet link or torrent file will be transferred to the Real Debrid cloud, where it will be downloaded and made available to you as soon as possible. Waiting time depends on the number of seeds/peers available.  You can see the download progress on the Real Debrid website under My Torrents

When using a Debrid service, your device won’t connect directly to the P2P network. Every download is encrypted by HTTPS protocol.

3.2. Using Trakt With The Promise is a free service that helps you organize and keep track of your favorite movies and shows. Using a Trakt account is very helpful when you want to sync your watched status across devices.

The Promise can integrate with your Trakt account, giving you access to your collection, lists, and bookmarks.

It is also capable of scrobbling, so using the official Trakt add-on is optional. Scrobbling means automatically checking in your watched episodes and movies on the cloud.

To use Trakt with The Promise, visit the website, log in with your account and follow these steps.

1. Select Tools from The Promise’s main menu.The Promise's main menu, the Tools option is selected

2. Press TRAKT: Authorize Trakt from the Tools menu

3. Copy the authorization code.copy the authorization code for Trakt

4. Using a web browser, visit and enter the authorization code. (You must be logged into your Trakt account)activate kodi addon on

5. Press Yes to link The Promise to your Trakt account. allow The Promise to use your Trakt account

Back in Kodi, you should see your Trakt username on The Promises’s settings menu.

If you’re not using the official Trakt add-on, you should activate Enable scrobble and change Set Resume Point to Trakt Scrobbles to synchronize your watched status with Trakt.

6. Adjust the Trakt settings according to your needs and press OK when you’re ready. Trakt options on The Promises's settings menu

To access your Trakt collection, lists, and other Trakt features, use My Movies and My TV Shows categories on the add-on’s main menu.

4. Alternatives to The Promise

Looking for more add-ons? These are some of our favorite Kodi add-ons for September 2023.

Please visit our list of the best Kodi add-ons for more information.

Seren Kodi Add-on featured imageSeren: Excellent add-on with great user interface and many innovative functions. (Premium sources)
Umbrella: Great add-on based on Venom. (Premium sources)
Fen Kodi Add-onFen: This add-on is very fast and offers many features. (Premium sources)
Elementum Kodi Addon featured imageElementum: An exceptional add-on that offers high-quality streams using torrents. (Free sources)
Scrubs: Great add-on specialized in free sources. (Free sources)
The Crew Kodi Add-onThe Crew: Great all-in-one add-on with many extra features for kids, sports, live TV, and more. (Free and premium sources)
The complete guide to The Promise on Kodi [Retired]
Tagged on:             

Leave a Reply

Your email address will not be published. Required fields are marked *

26 thoughts on “The complete guide to The Promise on Kodi [Retired]

  • 2 months ago

    The Promise is repeatedly showing no stream available, as others have mentioned

    • 2 months ago

      Hi! I’m still getting some results with The Promise, but the amount of streams available is significantly lower than before. Please try Scrubs if you’re looking for free sources.

  • 6 months ago

    Not working for me anymore.. not finding new episodes for a couple weeks now. Just shows the last new episode from 2 weeks ago.

    • 5 months ago

      Same here. Sumthin weird’s going on in the background methinks. I don’t dare update beyond Kodi 18.9. I’ve found that I can still find MOST of my regular shows using the Elementum + (Elementum Burst) from the Warehouse repo. Some MAY be delayed by a day or two. That’s my workaround for the time being. I’m sure hoping this glitch is temporary…

  • 6 months ago

    How do you download films?

    • 6 months ago

      I’m trying to download a TV episode using Kodi 20 and ThePromise. I have no problem watching the video, I just can’t get the download function to work.
      This used to work for me using older versions of Kodi with add-ons like Exodus.
      Is there a configuration thing that I’m missing?

  • 7 months ago

    Hi do u have to do this real Debrid thing to watch anything ? I did step by step everything and I cannot watch anything??!! I’ve done the jailbroken thing and updated my Kodi for years and are we now at the point when u have to pay now? Please help! I’m on kodi 20 nexus

    • 7 months ago

      Hi, you don’t need a Debrid account to use The Promise, it can scrape free sources that are openly available on the internet. Keep in mind that free sources are usually lower quality and can be prone to buffering, so you’ll probably have to try a couple of sources before finding one that works.

  • 7 months ago

    Thanks 😊

  • 9 months ago

    Just installed the promise on 19.4 , and when I goto set real debrid I don’t have the universal resolver 2 tab. Nor can I find real debrid in any of the resolver tabs

  • 10 months ago

    Good day,
    I seem to have a problem with Kodi / The Promise/Trakt adding to My Tv Shows and Movies those TVshows and movies I have searched and added to my Library. Previously when I used the Oath all the shows I wanted were loaded and have remained on. When starting with the Promise none of my searched TV shows or movies show in my collection after adding to my library. Some times it says Added to favourites ( where do I find the Favourites on Kodi/the Promise?) It also says added to library but does not show in Collection. What do I do to show in My Collection …. continue watching is also empty , Trakt watchlist is also empty. I have to go to search and watch from Search all the time. When Oath was no longer working I started from sctach except for Trakt just reactivated with new code in the Promise .My Collection it keeps track of what I watch but insearch it does not …….Please help
    What do I do to correct this problem Your help will be much appreciated.
    Margretha MartinMy email address is

  • 11 months ago

    smrlinktester is the only thing in this repo. Please remove instructions
    that don’t work. Waste of time!

    • 11 months ago

      Hi, I just installed The Promise and everything is working fine. It seems like you’re using an older version of Kodi. Please stick to the release version (currently 19.4) to avoid headaches.

  • 11 months ago

    na instaleren promise
    alles werkt buiten het vakje downloaden is er niet bij.
    enig idee

  • 1 year ago

    Recently I have a problem with proper integration with Watched episodes are updated in the database, but my tv shows / continue watching, collection, trakt watchlist, etc. functions don’t work. They just won’t load. I have to use search function every time.

    • 1 year ago

      Same happening to me. Running version 22.4.28 of the promise on kodi 19.4

  • 1 year ago

    Hi, i have the same vervion of kodi and the Promise on two different devices but getting more links on one than the other and I can’t figure out why.

  • 1 year ago

    I could do with some help with being able to move from using The Oath to The Promise. I’ve gone through this guide and I can’t seem to get The Promise to be the Add-On that searches for files. Even if I disable The Oath that isn’t making The Promise kick in; I’m just getting no search rsults at all.

    The weird thing is that even though I’ve read that The Oath has been taken down I can still search and play films through it, just not episodic TV.

    I’m running Kodi 19.3 via a Minix box that I have hooked up to my Android TV. However, I’m by no means an expert and could really use some help.

    • 1 year ago

      Oh, and if someone could get in touch with me directly via the e-mail address that I listed when posting this comment (I assume only the author or site admins will be able to see that) I’d appreciate it. Otherwise I’m likely to miss any replies to my question.

      Thank you.

    • 1 year ago

      Hi! There are some compatibility issues between The Oath and The Promise, you should try to remove all of The Oath’s dependencies but that can be a bit messy and it’s not guaranteed to work. It’s probably best to start with a clean install. You might also be interested in upgrading to 19.4, download the latest Kodi for Android here

  • 1 year ago

    Tools – ResolveURL : Settings is not working .Unable to add RD as no pop up window forms to lead you into the universal resolvers 2 tab

    • 1 year ago

      HI! It seems like you’re missing some dependencies, probably something went wrong during the installation process. Please try reinstalling The Promise.

  • 1 year ago

    On video add ons it’s only showing SMR Link Tester. The zip file name is the same as in the image though, any ideas?

    • 1 year ago

      Are you using Kodi 19? Seems like you’re on an older version.

      • 1 year ago

        Hi, I have the same issue as Chris, just SMR Link Tester in addons. Do you mean that if I did not update Kodi to the latest version, I won’t be able to download the addon?