{"id":33899693,"url":"https://github.com/midouest/vscode-playdate-debug","last_synced_at":"2026-03-27T04:31:56.165Z","repository":{"id":42560819,"uuid":"470437034","full_name":"midouest/vscode-playdate-debug","owner":"midouest","description":"Unofficial Playdate debug extension for Visual Studio Code on macOS, Windows and Ubuntu","archived":false,"fork":false,"pushed_at":"2025-11-21T04:58:38.000Z","size":1681,"stargazers_count":50,"open_issues_count":0,"forks_count":5,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-03-12T21:15:51.235Z","etag":null,"topics":["debugger","playdate","playdate-console","vscode","vscode-extension"],"latest_commit_sha":null,"homepage":"https://marketplace.visualstudio.com/items?itemName=midouest.playdate-debug","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/midouest.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-03-16T04:54:17.000Z","updated_at":"2025-11-14T22:10:48.000Z","dependencies_parsed_at":"2025-04-07T04:22:44.592Z","dependency_job_id":"fa83fbcc-4605-4b56-ac41-49e066bf584d","html_url":"https://github.com/midouest/vscode-playdate-debug","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/midouest/vscode-playdate-debug","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/midouest%2Fvscode-playdate-debug","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/midouest%2Fvscode-playdate-debug/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/midouest%2Fvscode-playdate-debug/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/midouest%2Fvscode-playdate-debug/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/midouest","download_url":"https://codeload.github.com/midouest/vscode-playdate-debug/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/midouest%2Fvscode-playdate-debug/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31019450,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-27T03:51:26.850Z","status":"ssl_error","status_checked_at":"2026-03-27T03:51:09.693Z","response_time":164,"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","playdate","playdate-console","vscode","vscode-extension"],"created_at":"2025-12-11T22:05:58.424Z","updated_at":"2026-03-27T04:31:56.121Z","avatar_url":"https://github.com/midouest.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Playdate Debug\n\n[![tests](https://github.com/midouest/vscode-playdate-debug/actions/workflows/tests.yaml/badge.svg)](https://github.com/midouest/vscode-playdate-debug/actions/workflows/tests.yaml)\n\nUnofficial Playdate debug extension for Visual Studio Code on macOS, Windows and Ubuntu\n\n## Features\n\n- Debug Lua code running in the Playdate Simulator\n- Compile games to `.pdx` using `pdc`\n- Problem matchers for `pdc`\n- Open the Playdate Simulator\n- Run and debug current Lua file in the Playdate Simulator from the editor toolbar\n\n## Requirements\n\n- The [Playdate SDK](https://play.date/dev/) must be installed separately\n\n## Quick setup\n\n### Tasks and debug launcher\n\nCopy the following `.vscode/tasks.json` and `.vscode/launch.json` configuration:\n\n```json\n// .vscode/tasks.json\n{\n  \"version\": \"2.0.0\",\n  \"tasks\": [\n    {\n      \"type\": \"pdc\",\n      \"problemMatcher\": [\"$pdc-lua\", \"$pdc-external\"],\n      \"label\": \"Playdate: Build\"\n    },\n    {\n      \"type\": \"playdate-simulator\",\n      \"problemMatcher\": [\"$pdc-external\"],\n      \"label\": \"Playdate: Run\"\n    },\n    {\n      \"label\": \"Playdate: Build and Run\",\n      \"dependsOn\": [\"Playdate: Build\", \"Playdate: Run\"],\n      \"dependsOrder\": \"sequence\",\n      \"problemMatcher\": [],\n      \"group\": {\n        \"kind\": \"build\",\n        \"isDefault\": true\n      }\n    }\n  ]\n}\n```\n\n```json\n// .vscode/launch.json\n{\n  \"version\": \"0.2.0\",\n  \"configurations\": [\n    {\n      \"type\": \"playdate\",\n      \"request\": \"launch\",\n      \"name\": \"Playdate: Debug\",\n      \"preLaunchTask\": \"${defaultBuildTask}\"\n    }\n  ]\n}\n```\n\nThe debugger can be launched from the \"Run and Debug view\" by selecting the \"Playdate: Debug\" launch configuration and then clicking the \"Start Debugging\" button.\n\n![Run and Debug view](/images/run-and-debug-view.png)\n\n![Start Debugging](/images/start-debugging.png)\n\nA [cookiecutter project template](https://github.com/midouest/cookiecutter-playdate) is available for quickly generating new projects with the above configuration from the command line.\n\nSee the [basic configuration example](/fixtures/workspace/basic-configuration) for more information.\n\n### Run and debug current Lua file\n\n**NOTE:** The \"Run/Debug file in Playdate Simulator\" command is intended to be a shortcut for prototyping and learning. It is recommended to use the [task and launch configuration above](#tasks-and-debug-launcher).\n\nThe extension can build, run and debug the current Lua file in the editor with zero configuration as long the [automatic configuration conditions](#automatic) are met.\n\nWhen you open a Lua file in the editor after installing the extension, you will now see a\nlaunch icon and dropdown menu in the editor toolbar. Clicking the launch icon or selecting an item from the dropdown menu will build and run the current Lua file in the Playdate Simulator. The \"Debug file in Playdate Simulator\" option will enable breakpoints to be hit.\n\n![Tooltip](/images/tooltip.png)\n\n![Dropdown Menu](/images/dropdown-menu.png)\n\n## Configuration\n\n### Automatic\n\nThe tasks and debugger will attempt to automatically resolve the correct configuration using the environment. One of the following conditions must be met for this to work:\n\n- The `PLAYDATE_SDK_PATH` environment variable is set to the Playdate SDK path\n- `~/.Playdate/config` exists and the `SDKRoot` property is set to the Playdate SDK path (macOS only)\n\n### Workspace settings override\n\nThe default behavior can be overridden by setting the SDK path, game source path, compiled game path or game name in your workspace's `settings.json` file. The extension will fall back to the default behavior for any configuration fields that are not set.\n\n```json\n// .vscode/settings.json\n{\n  \"playdate-debug.sdkPath\": \"/path/to/PlaydateSDK\",\n  \"playdate-debug.sourcePath\": \"/path/to/MyGame/source\",\n  \"playdate-debug.outputPath\": \"/path/to/MyGame\",\n  \"playdate-debug.productName\": \"My Game\"\n}\n```\n\nSee the [override configuration example](/fixtures/workspace/override-configuration) for more information about these properties.\n\n### PDC task\n\nSee the [pdc configuration example](/fixtures/workspace/pdc-configuration/) for additional `pdc` task properties.\n\n### Playdate Simulator task\n\nSee the [playdate simulator configuration example](/fixtures/workspace/playdate-simulator-configuration/) for additional `playdate-simulator` task properties.\n\n### Debugger\n\nSee the [debugger configuration example](/fixtures/workspace/debugger-configuration/) for additional `playdate` debugger properties.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmidouest%2Fvscode-playdate-debug","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmidouest%2Fvscode-playdate-debug","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmidouest%2Fvscode-playdate-debug/lists"}