How to Send a Debug Log (Umbrella + CocoScrapers)

[umbrellaplug]

If you're having a problem with Umbrella or CocoScrapers, a debug log is the single most useful thing you can send. Without one, there's usually no way to tell what went wrong. Follow every step below, in order, and you'll end up with a link you can paste into your issue.

It takes about five minutes.

---

Step 1: Turn on debug logging in Umbrella

1. Open Umbrella.
2. Go to Tools → SETTINGS : General (or open Umbrella's settings any other way you prefer).
3. In the settings window, select Debugging in the left-hand column.
4. Set the options exactly like this:

Setting | Set it to -- | -- Enable Debug | On Log Level | Debug(Extra info) Logging Location | kodi.log

5. Click OK to save and close.

⚠️ Same as above: Logging Location must be Kodi Log, not Addon Log.

---

Step 3: Reproduce the problem

Do whatever causes the problem, the same way you normally would: play the item that fails, run the search that comes back empty, open the menu that errors, etc.

• Do it once or twice, not twenty times.
• Note roughly what time it happened and what you clicked (title, season/episode, menu name). You'll include this in your issue.

⚠️ Do not restart Kodi after this step. When Kodi restarts, the current log is moved to kodi.old.log and a new empty one is started, and the error you just captured won't be in what you upload.

---

Step 4: Upload the log with Umbrella's tools

1. Open Umbrella.
2. Go to Tools → Logging Tools.
3. Select Kodi - Upload log file to pastebin.
4. After a moment, a window appears showing a link like https://paste.kodi.tv/abcdefg.
   • On supported devices you can choose Copy url To Clipboard.
   • Otherwise, write the link down or take a photo of the screen.

Make sure you choose Kodi - Upload log file, not Umbrella - Upload log file. Since you set everything to log to Kodi's log in Steps 1 and 2, the Kodi log is the one with everything in it.

---

Step 5: Send the link

Open an issue (or reply to your existing one) and include:

• The paste.kodi.tv link from Step 4
• What you did and what went wrong (e.g. "Played Movie Name (2024), got 'No Sources Found'")
• About what time it happened
• Your Kodi version and device (e.g. Kodi 21.2 on Nvidia Shield)

Please send the link, not a screenshot of the log or a copy-pasted snippet. The full log is needed.

---

Step 6: Turn debug logging back off (once your issue is solved)

Debug logging makes the log file grow quickly. When you're done troubleshooting, go back through Steps 1 and 2 and switch Enable Debug back off in both Umbrella and CocoScrapers.

---

A note on privacy

Logs uploaded to paste.kodi.tv can be viewed by anyone who has the link. They mostly contain technical information (add-on versions, settings, what was searched or played), but they may include the titles you were watching and your device's file paths. If you'd rather not post the link publicly, say so in your issue and ask for another way to share it.