![The complete guide to The Promise on Kodi [Retired] The complete guide to The Promise on Kodi [Retired]](https://howtomediacenter.com/wp-content/uploads/2022/05/kodi-the-promise-featured-image.jpg)
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
Features | Movies and TV shows |
Free Sources | Yes |
Premium Sources | Real Debrid, Premiumize, All Debrid |
Source Type | File hosting websites and cached torrents |
Trakt support | Yes |
Library integration | Yes |
Other Features | Integrated subtitles, file downloads, Orion indexer support, Providers for official streaming services |



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.
2. Select File Manager.
3. Press Add Source.
4. Enter https://warehousecrates.github.io/TheWareHouse/ on the top box and TheWareHouse on the bottom one. Press OK to add the source. (The URL is case-sensitive).
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.
6. Click on Install from zip file.
On Kodi 19, you’ll see a message about the auto-update feature. Press Yes to proceed.
7. Select TheWareHouse.
8. Click on repository.thewarehouse-x.x.x.zip to install the repository.
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.
10. Click The WareHouse Repository.
11. Select Video add-ons.
12. Scroll down and select The Promise.
13. Press the Install button.
14. Press OK to install The Promise and its dependencies.
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.
16. All done! Use the menu to browse movies and TV shows.
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.
2. Press ResolveURL: Settings.
3. Select the Universal Resolver 2 tab and Press (Re)Authorize My Account in the Real Debrid section.
4. Copy the authorization code.
5. Use a web browser to visit https://real-debrid.com/device/ and enter the authorization code. (You must be logged in with your Real Debrid account).
6. Enter ThePromise and press Set that name.
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.
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
Trakt.tv 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 Trakt.tv website, log in with your account and follow these steps.
1. Select Tools from The Promise’s main menu.
2. Press TRAKT: Authorise.
3. Copy the authorization code.
4. Using a web browser, visit https://trakt.tv/activate and enter the authorization code. (You must be logged into your Trakt account)
5. Press Yes to link The Promise to 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.
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: Excellent add-on with great user interface and many innovative functions. (Premium sources) |
![]() | Umbrella: Great add-on based on Venom. (Premium sources) |
![]() | Fen: This add-on is very fast and offers many features. (Premium sources) |
![]() | Elementum: 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: Great all-in-one add-on with many extra features for kids, sports, live TV, and more. (Free and premium sources) |
I’m not sure ThePromise is still being supported. The repo link no longer works, and sources are declining. Without real debrid it’s frustrating finding sources.
https://warehousecrates.github.io/TheWareHouse/
The Promise is repeatedly showing no stream available, as others have mentioned
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.
Not working for me anymore.. not finding new episodes for a couple weeks now. Just shows the last new episode from 2 weeks 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…
How do you download films?
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?
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
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.
Thanks 😊
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
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 gretham@gmail.com
smrlinktester is the only thing in this repo. Please remove instructions
that don’t work. Waste of time!
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.
beste
na instaleren promise
alles werkt buiten het vakje downloaden is er niet bij.
enig idee
Recently I have a problem with proper integration with trakt.tv. 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.
Same happening to me. Running version 22.4.28 of the promise on kodi 19.4
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.
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.
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.
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 https://kodi.tv/download/android
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
HI! It seems like you’re missing some dependencies, probably something went wrong during the installation process. Please try reinstalling The Promise.
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?
Are you using Kodi 19? Seems like you’re on an older version.
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?