SendToKodi (Kodi Add-on)

Send video or audio links from your browser or phone directly to Kodi. SendToKodi resolves supported websites to playable streams using yt-dlp.

✨ Features

• 🎬 Stream links from supported websites directly in Kodi
• 🌐 Works with browser extensions and mobile share flows
• 📋 Playlist support via .m3u
• 🔧 JSON-RPC and plugin integration support
• 💾 Optional auto-download before playback

🚀 Quick Start

1. Install the SendToKodi Kodi add-on (steps below).
2. Install one of the companion apps/extensions.
3. Share or send a video URL to Kodi and start playback.

📦 Install in Kodi

This add-on is not in the official Kodi add-on repository. For automatic updates, first add the SendToKodi repo:

1. Download repository ZIP for Kodi 19+:
   • repository.sendtokodi-1.0.0.zip
2. In Kodi, go to Add-ons → Install from zip file and install the ZIP.
3. Then go to Add-ons → Install from repository and install plugin.video.sendtokodi.

Reference: Kodi Add-on Manager

📱 Companion Apps

Browser extensions

• Chrome Web Store
• Mozilla Add-ons
• Microsoft Edge Add-ons

Extension source & issues: firsttris/chrome.sendtokodi

Mobile

• Kore (official Kodi Android remote)
  • If prompted, set SendToKodi as the preferred add-on in Kore settings.
• The official iOS SendToKodi app is currently retired.
• Apple Shortcut (iOS + macOS)

⚙️ Usage Notes

Optional: auto-download before playback

In add-on settings (General), enable:

Auto-download resolved media before playback

Default path:

special://profile/addon_data/plugin.video.sendtokodi/downloads

You can change it with:

Media download path

🔌 Integration

• Supported sites: yt-dlp supported websites
• Call from playlists: playlist-example.m3u
• Send URLs via JSON-RPC: Development docs
• Call from another Kodi plugin: Development docs

💻 Development

Run unit tests locally (recommended: inside a virtual environment):

1. Install venv support (Ubuntu/Debian):

sudo apt install python3-venv

2. Create a virtual environment in the project root:

python3 -m venv .venv

3. Activate it (choose your shell):

• fish:

  source .venv/bin/activate.fish

• bash/zsh:

  source .venv/bin/activate

4. Install test dependencies and run tests:

python -m pip install --upgrade pip
python -m pip install -r requirements-dev.txt
pytest

Coverage reports are generated automatically:

• Console report with missing lines
• coverage.xml for CI integrations
• htmlcov/index.html as a human-readable report

Local add-on installation for development

1. Symlink (recommended)

# Standard Kodi install
rm -rf ~/.kodi/addons/plugin.video.sendtokodi
ln -s /home/tristan/Projects/plugin.video.sendtokodi ~/.kodi/addons/plugin.video.sendtokodi

# Flatpak Kodi install
rm -rf /home/tristan/.var/app/tv.kodi.Kodi/data/addons/plugin.video.sendtokodi
ln -s /home/tristan/Projects/plugin.video.sendtokodi /home/tristan/.var/app/tv.kodi.Kodi/data/addons/plugin.video.sendtokodi

Restart Kodi (or disable/enable the add-on) after changes.

2. Install local ZIP

zip -r plugin.video.sendtokodi-local.zip . -x "*.git*" "__pycache__/*" ".pytest_cache/*"

Then install via Add-ons → Install from zip file.

🤝 Contributing

Contributions are welcome. Please open an issue or submit a pull request.

Code of Conduct

See CODE_OF_CONDUCT.md.

License

This project is licensed under MIT. See LICENSE.md.