{"id":38682390,"url":"https://github.com/romanvm/kodi.web-pdb","last_synced_at":"2026-01-17T10:16:32.014Z","repository":{"id":41380794,"uuid":"68382197","full_name":"romanvm/kodi.web-pdb","owner":"romanvm","description":"Web-based remote Python debugger for Kodi addons","archived":false,"fork":false,"pushed_at":"2024-12-15T15:35:30.000Z","size":1139,"stargazers_count":87,"open_issues_count":8,"forks_count":16,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-03-30T11:34:15.646Z","etag":null,"topics":["debugger","kodi","python"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/romanvm.png","metadata":{"files":{"readme":"Readme.rst","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-09-16T13:31:28.000Z","updated_at":"2025-02-28T17:12:58.000Z","dependencies_parsed_at":"2024-12-15T18:15:12.417Z","dependency_job_id":null,"html_url":"https://github.com/romanvm/kodi.web-pdb","commit_stats":null,"previous_names":[],"tags_count":44,"template":false,"template_full_name":null,"purl":"pkg:github/romanvm/kodi.web-pdb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/romanvm%2Fkodi.web-pdb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/romanvm%2Fkodi.web-pdb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/romanvm%2Fkodi.web-pdb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/romanvm%2Fkodi.web-pdb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/romanvm","download_url":"https://codeload.github.com/romanvm/kodi.web-pdb/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/romanvm%2Fkodi.web-pdb/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28506028,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T06:57:29.758Z","status":"ssl_error","status_checked_at":"2026-01-17T06:56:03.931Z","response_time":85,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["debugger","kodi","python"],"created_at":"2026-01-17T10:16:31.926Z","updated_at":"2026-01-17T10:16:32.007Z","avatar_url":"https://github.com/romanvm.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"script.module.web-pdb\n#####################\n\n``script.module.web-pdb`` is a port of my `Web-PDB`_ Python package modified for using in `Kodi mediacenter`_.\nIt is a web-interface for Python's built-in `PDB`_ debugger that can be used for remote debugging of\nPython addons *in vivo*, that is, while running inside Kodi.\nExcept for modifications needed to run inside Kodi, all other Web-PDB/PDB functionality is left intact\nso you can use all available documentation and tutorials for the PDB debugger\nto learn how to debug your Python code.\n\n.. figure:: https://raw.githubusercontent.com/romanvm/python-web-pdb/master/screenshot.png\n  :alt: Web-PDB screenshot\n  :width: 640px\n  :height: 490px\n\n  *Web-PDB console in Chrome browser*\n\nUsage\n=====\n\nFirst you need to install ``script.module.web-pdb`` addon in your Kodi instance where you want to debug your addon.\nThe addon can be installed from the Kodi official addon repository:\n**Kodi Add-on repository** \u003e **Program add-ons** \u003e **Web-PDB**.\nAlso an installable ZIP can be downloaded from `Releases`_ tab of this repository.\n\nThen include ``script.module.web-pdb`` in your ``addon.xml`` as a dependency:\n\n.. code-block:: xml\n\n  \u003crequires\u003e\n    ...\n    \u003cimport addon=\"script.module.web-pdb\" /\u003e\n  \u003c/requires\u003e\n\nRestart Kodi so that it re-reads addon dependencies.\n\nInsert the following line into your addon code at the point where you want\nto start debugging:\n\n.. code-block:: python\n\n  import web_pdb; web_pdb.set_trace()\n\nThe ``set_trace()`` call will suspend your addon and open a web-UI at the default port ``5555``\n(port value can be changed). At the same time a notification will be displayed in Kodi,\nindicating that a debug session is active. The notification also shows web-UI host/port.\n\n.. figure:: https://raw.githubusercontent.com/romanvm/kodi.web-pdb/master/kodi_message.png\n  :alt: Kodi notification\n\n  *Notification in Kodi about an active Web-PDB debugging session*\n\nEnter in your the address bar of your browser: ``http://\u003cyour Kodi machine hostname or IP\u003e:5555``,\nfor example ``http://monty-python:5555``. Use ``127.0.0.1`` or ``localhost`` as hostname\nif you are connecting from the same machine that runs Kodi.\nIf everything is OK, you should see the Web-PDB UI like on the preceding screenshot.\nNow you can use all PDB commands and features. Additional **Current file**, **Globals** and **Locals**\ninformation boxes help you better track your program runtime state.\n\nMultiple ``set_trace()`` calls can be used as hardcoded breakpoints.\n\n**Note**: it is strongly recommended to work with the Web-PDB web-UI only in one browser session.\nWith more than one browser window accessing the web-UI it can display incorrect data in one or more\nbrowser sessions.\n\nAdditionally, Web-PDB provides ``catch_post_mortem`` context manager that can catch\nunhandled exceptions raised within its scope and automatically start PDB post-mortem debugging session.\nFor example:\n\n.. code-block:: python\n\n  import web_pdb\n\n  with web_pdb.catch_post_mortem():\n      # Some error-prone code\n      raise RuntimeError('Oops!')\n\nFor more detailed info about the Web-PDB API read docstrings in the ``/libs/web_pdb/__init__.py`` file.\n\nIntroductory video (courtesy of Michele Lombardo):\nhttps://www.youtube.com/watch?v=6gMmeA7UY18\n\nMy video tutorial for debugging Python addons for Kodi with Web-PDB:\nhttps://youtu.be/OukjNpafNZU\n\n**Note**: Non-bundled front-end JavaScript/CSS source code is available in the\n``frontend`` directory.\n\nLicense\n=======\n\nMIT license, see ``LICENSE.txt``.\n\nThe debugger icon made by `Freepik`_ from `www.flaticon.com`_ is licensed by `CC 3.0 BY`_.\n\n.. _Web-PDB: https://github.com/romanvm/python-web-pdb\n.. _Kodi mediacenter: https://kodi.tv\n.. _PDB: https://docs.python.org/2/library/pdb.html\n.. _Releases: https://github.com/romanvm/kodi.web-pdb/releases\n.. _Freepik: http://www.freepik.com\n.. _www.flaticon.com: http://www.flaticon.com\n.. _CC 3.0 BY: http://creativecommons.org/licenses/by/3.0/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fromanvm%2Fkodi.web-pdb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fromanvm%2Fkodi.web-pdb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fromanvm%2Fkodi.web-pdb/lists"}