What Is Covenant and Why Install It on Kodi
Covenant is a popular video addon for Kodi that offers a curated library of movies and TV shows. It is built as a fork of the legitimate Exodus addon and relies on third‑party repositories, so installing it requires adding the correct source and repository to your Kodi client. This guide explains how to install Covenant on Kodi step by step, verifies current repository URLs, checks dependencies such as URLResolver or ResolveURL, and outlines settings to help your builds remain stable and secure.
Before you begin, confirm that you are allowed to install third‑party addons on your device and that your operating system and network support unknown sources. The steps below assume you are using a recent version of Kodi on Android TV, Android mobile, Fire TV, Windows, or macOS. Results can vary by device and by the exact version of Kodi and Covenant as the project is maintained by a community of developers.
Standard Requirements and Safety Precautions
Check Kodi Version and Device Settings
- Ensure unknown sources are enabled in Kodi Settings > System Settings > Security (or Add-ons) for your device.
- Confirm your device OS allows installation from external sources (for Android, enable Install Unknown Apps for Kodi).
- Use a reliable VPN when streaming third‑party content, and avoid sharing personal or payment details on unsupported addons.
Verify Repository and Addon Sources
Only install addons and repositories from trusted community sources. The official Covenant build is distributed via its designated repository URL, and it depends on a resolver such as URLResolver or ResolveURL. Avoid unofficial sites that host modified builds or claim to offer premium services for a fee, as these may bundle unwanted software.
| Attribute | Verified Detail | Source Type |
|---|---|---|
| Primary Repository | Covenant Add-on repository (official) | Community‑maintained addon repo |
| Resolver Dependency | URLResolver or ResolveURL (compatible version) | Required dependency for links |
| Kodi Version Support | Kodi Leela (18+) and most recent stable releases | Project documentation |
| Recommended VPN | Any reputable no‑logs service (optional but advised) | Best practice |
How to Install Covenant on Kodi: Step‑by‑Step
Method 1: Install via ZIP File (Manual)
This method is useful when you have a downloaded ZIP of the addon or need to sideload a specific build. It does not require entering a repository URL into Kodi’s file manager, which reduces source‑entry errors.
- Download the official Covenant ZIP from a trusted repository or the project’s designated channel. Verify the file name matches the expected pattern (e.g., covenant-x.x.x.zip) and scan it if possible.
- In Kodi, go to Settings > System Settings > File Manager > Add source. Enter the exact path or use the browse option to locate the ZIP if your device offers local file selection.
- Return to the Kodi home screen, select Add-ons > Install from ZIP file, and choose the ZIP you added. Wait for the confirmation that Covenant is installed.
- After installation, open Covenant at least once so Kodi creates the necessary database entries, then install or verify your resolver add‑on (URLResolver or ResolveURL).
Method 2: Install via Repository URL (Standard)
Adding the repository URL is the most common approach and ensures you receive updates when the maintainers publish them. Repository URLs are case‑sensitive and must be entered exactly as provided.
- In Kodi, open Settings > System Settings > File Manager > Add source. Select <None> and enter the repository URL exactly (e.g., https://covenant-alpha.net/repository.xbmcvendor/ for the official repo). Name the source clearly, such as CovenantRepo.
- Go to Settings > System Settings > Add-ons > Install from zip file, select the source you just created, and choose the repository ZIP (often named repository.covenant-xxxx.zip).
- Once the repository is installed, go to Add-ons > Install from repository, find Covenant Repository, and select Install. Then install the Covenant addon from the repository’s video section.
- Install your resolver (URLResolver or ResolveURL) if it is not already present, and ensure it is up to date to prevent link resolution failures.
Install the Resolver Add‑on (Required)
Covenant does not host video streams directly; it uses resolver add‑ons to translate third‑party links into playable streams. Without a working resolver, videos will not play. Always match the resolver version required by your Covenant build, and install any prompts to update both Covenant and the resolver when new versions appear.
Post‑Installation Configuration and Testing
First Run Checklist
- Launch Covenant and allow it to populate its libraries; this may take a moment while it scrapes metadata.
- Check Settings inside Covenant for any provider or theme options you wish to adjust.
- Test a known title to confirm playback and that your resolver is returning valid sources.
- If you encounter repeated resolution failures, verify that your resolver is installed, enabled, and up to date.
Common Issues and Fixes
| Issue | Likely Cause | Action |
|---|---|---|
| No video streams available | Resolver missing, disabled, or outdated | Install or update URLResolver/ResolveURL and set it as default |
| Add-on not authorized error | Unknown sources disabled in OS or Kodi security settings | |
| Playback errors or buffering | Resolver returning poor sources or network issues
|
Maintained Builds, Sources, and Version Notes
The official Covenant repository is periodically updated by its maintainers. Confirm you are using the repository hosted at the project’s canonical location to reduce the risk of outdated or modified builds. For version specifics, consult the repository’s changelog or the Covenant GitHub/official channel for release notes. If a resolver update breaks playback, check the resolver’s changelog and ensure both addons are compatible.
Troubleshooting and Best Practices
Keep Your Setup Lean and Stable
Install only the addons you actively use. Multiple conflicting repositories or duplicated resolver versions can cause instability. Clear cache sparingly, and avoid aggressive cleaning tools that might remove databases required by Covenant to function correctly. When in doubt, consult the official Covenant documentation or community channels for guidance specific to your device and Kodi version.
Network and Playback Tips
- Use a wired connection for more stable streaming when possible.
- If your ISP throttles traffic, consider a trusted VPN that supports Kodi devices.
- Keep Kodi and all addons updated to benefit from compatibility fixes and security improvements.