{"id":23658955,"url":"https://github.com/soumyaprasadrana/vscode-java-debugx","last_synced_at":"2026-01-24T22:07:31.184Z","repository":{"id":261955274,"uuid":"885464875","full_name":"soumyaprasadrana/vscode-java-debugx","owner":"soumyaprasadrana","description":"Java DebugX enhances Java debugging in Visual Studio Code by providing advanced features such as macro recording, runtime insights, and dynamic method invocation.","archived":false,"fork":false,"pushed_at":"2024-11-11T02:17:54.000Z","size":10755,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-18T14:39:17.996Z","etag":null,"topics":["breakpoints","debug-automation","debugging-macros","debugging-tool","java-debugging","java-debugging-helper","java-development","macro-recording","productivity-tool","program-flow","replay-debugging","single-thread-debugging","visual-studio-code-extension","vscode-debugging","vscode-extension"],"latest_commit_sha":null,"homepage":"https://marketplace.visualstudio.com/items?itemName=soumyaprasadrana.vscode-java-debugx","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/soumyaprasadrana.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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":"2024-11-08T16:27:59.000Z","updated_at":"2024-11-13T11:07:47.000Z","dependencies_parsed_at":"2025-09-01T13:32:01.632Z","dependency_job_id":"3ed550e2-5aa1-4195-a4b3-a8454c0cfbce","html_url":"https://github.com/soumyaprasadrana/vscode-java-debugx","commit_stats":null,"previous_names":["soumyaprasadrana/vscode-java-debugx"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/soumyaprasadrana/vscode-java-debugx","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soumyaprasadrana%2Fvscode-java-debugx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soumyaprasadrana%2Fvscode-java-debugx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soumyaprasadrana%2Fvscode-java-debugx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soumyaprasadrana%2Fvscode-java-debugx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/soumyaprasadrana","download_url":"https://codeload.github.com/soumyaprasadrana/vscode-java-debugx/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soumyaprasadrana%2Fvscode-java-debugx/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28737949,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-24T21:19:41.845Z","status":"ssl_error","status_checked_at":"2026-01-24T21:13:38.675Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["breakpoints","debug-automation","debugging-macros","debugging-tool","java-debugging","java-debugging-helper","java-development","macro-recording","productivity-tool","program-flow","replay-debugging","single-thread-debugging","visual-studio-code-extension","vscode-debugging","vscode-extension"],"created_at":"2024-12-29T01:48:21.250Z","updated_at":"2026-01-24T22:07:31.169Z","avatar_url":"https://github.com/soumyaprasadrana.png","language":"TypeScript","readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"\" rel=\"noopener\"\u003e\n \u003cimg width=200px height=200px src=\"media/vscode-java-debugx.gif\" alt=\"Project logo\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch3 align=\"center\"\u003e \u003cb\u003eJava DebugX\u003c/b\u003e \u003c/h3\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[![Status](https://img.shields.io/badge/status-active-success.svg)]()\n[![GitHub Issues](https://img.shields.io/github/issues/soumyaprasadrana/vscode-java-debugx.svg)](https://github.com/soumyaprasadrana/vscode-java-debugx/issues)\n[![GitHub Pull Requests](https://img.shields.io/github/issues-pr/soumyaprasadrana/vscode-java-debugx.svg)](https://github.com/soumyaprasadrana/vscode-java-debugx/pulls)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](/LICENSE)\n\u003c/div\u003e\n\n---\n\n\n## 🌟 Overview\n\n**Java DebugX** is a powerful Visual Studio Code extension designed to enhance your Java debugging experience with advanced macro recording and playback features. 📽️✨ With Java DebugX, you can record essential debugging events—like **step-in**, **step-out**, and **breakpoints**—in a structured JSON format. \n\nThis feature enables you to capture intricate debugging sessions and replay them effortlessly, saving time and sparing you from manually redoing steps. ⏱️🔄 Perfect for complex Java applications, Java DebugX streamlines your workflow and boosts your productivity. ⚡\n\n## Features\n\n- 🎥 **Macro Recording \u0026 Playback**: Effortlessly record your debugging sessions, capturing all **step-ins**, **step-outs**, and **breakpoints**. Rewind and replay these recorded sessions anytime for quick and efficient troubleshooting! ⏪⏯️\n **Recording**\n![JavaDebugXMacroRecording](/media/vscode-java-debugx-macro-recording.gif)\n **Playback**\n![JavaDebugXMacro](/media/vscode-java-debugx-play-macro.gif)\n**🧵 Enhanced Multi-Threaded Compatibility**\nJava DebugX is designed to work seamlessly with **multi-threaded debugging**! 🎉 Now, you can record and replay debugging sessions even in complex, multi-threaded applications. This enhancement captures step-in, step-over, and other critical debugging events across threads, allowing you to efficiently review and trace through complex scenarios without retracing steps manually. 🚀\n![JavaDebugXMacroMultiThread](/media/vscode-java-debugx-play-macro-play-multithread.gif)\n\n- 🔧 **Customizable Bridge Configurations**: Set up custom bridge classes and methods to bring extra insights into your debugging process, tailored to your needs. 🌉\n- 🕵️‍♂️ **Advanced Debug Insights**: Access in-depth, real-time debugging details in the specialized **Insights** view for more informed problem-solving. 📊\n![DebugInsight](/media/vscode-java-debugx-bridge.gif)\n\n- 🔍 **Search External Files**: Seamlessly search and index external files during debugging to boost traceability and streamline your workflow. 📁\n- 🎛️ **Customizable File Patterns**: Tailor which files to include in indexing external files by defining custom file patterns for optimized debugging. 📝\n\n\n\n\n## 🚀 Installation\n\nTo install the **Java DebugX** extension in Visual Studio Code:\n\n1. Open **Visual Studio Code**.\n2. Go to the **Extensions** view by clicking on the Extensions icon in the Activity Bar or pressing `Ctrl+Shift+X`.\n3. 🔍 Search for **Java DebugX**.\n4. Click **Install** to add it to your editor.\n\n\u003e Alternatively, you can install it directly from the [Marketplace](https://marketplace.visualstudio.com/items?itemName=soumyaprasadrana.vscode-java-debugx) or from [Open VSX](https://open-vsx.org/extension/soumyaprasadrana/vscode-java-debugx).\n\n## 🎉 Getting Started\n\nAfter installing **Java DebugX**, it activates automatically whenever you open a Java project. You can now dive right in and start using its powerful features to record, play back, and analyze your debugging sessions for a more efficient development workflow! 🛠️\n\n### 🚀 Key Features and Commands\n\n- **🎬 Start Macro Recording**: Begin capturing your debugging session, including step-ins, step-outs, and breakpoints.\n- **⏹️ Stop Macro Recording**: End the recording and save the session data.  \n  ![MacroRecActions](/media/vscode-java-debugx-macro-start-stop.gif)\n- **▶️ Play Macro Recording**: Re-execute the captured debugging session.\n- **⏸️/▶️/⏹️ Pause, Resume, or Stop Playback**: Control the playback of your recorded debugging session.  \n  ![MacroRecPlayActions](/media/vscode-java-debugx-play-macro-action-buttons.gif)\n- **🛠️ Generate Sample Bridge Config**: Create a sample config file to define custom bridge commands and methods.\n- **🔍 Debug Insights**: Access detailed insights and bridge configurations in a dedicated panel for enriched debugging information.\n\nThese commands are accessible through the **Command Palette** (`Ctrl+Shift+P`). Happy debugging! 🎉\n\n## Configuration ⚙️\n\nYou can configure the extension by modifying the settings in your `settings.json`. The available settings are:\n\n- **java.debugx.filePatterns** 📂: Define file patterns to include when indexing external files (e.g., `*.java`, `*.js`, `*.xml`).\n- **java.debugx.externalFolder** 🗂️: Set the path to an external folder that you want to index.\n- **java.debugx.macro.stepDelayInSeconds** ⏱️: Configure the step delay during macro playback.\n- **java.debugx.bridgeConfigPath** 🔧: Set the absolute path to your custom bridge configuration file.\n\nYou can access and modify these settings in the **Settings** tab ⚙️ or directly in your `settings.json` file. \n\n## Views and Menus 🖥️\n\n- **Insights View** 📊: A dedicated view to show real-time debugging insights.  \n  ![DebugInsightView](/media/vscode-java-debugx-bridge-insights.gif)\n\n- **Debug Toolbar** 🛠️: Commands for controlling the macro recording and playback are available in the debug toolbar.\n\n## Example Usage 💡\n\n### Typical Scenario 🚀\n\nHere’s a typical scenario: You’re debugging a large Java application and find a potential root cause. But after stepping forward, you realize you need to repeat the process to verify something. In a real-life setting, this is where Java DebugX shines—you can record the session once, then replay it up to the exact point you need to examine again.\n\n**Java DebugX** even includes enhanced diagnostics to help when your macro takes a wrong path. If your playback reaches a point that differs from the expected line (like reaching an unexpected catch block or exception), DebugX will try to gather diagnostics and log them to a file, giving you a better understanding of potential issues. 📂🛠️\n\n### Generating a Sample Bridge Config ⚙️\n\nTo generate a sample bridge configuration file:\n\n1. Open the Command Palette (`Ctrl+Shift+P`) 🔍.\n2. Search for and select **Generate Sample Bridge Config** 📝.\n\nThis will generate a new bridge configuration file in your workspace, which you can modify to create your custom bridge logic. 🔧\n\n## Development 🛠️\n\nIf you'd like to contribute or develop the extension locally, follow these steps:\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/soumyaprasadrana/vscode-java-debugx.git\n   ```\n2. Install dependencies:\n   ```bash\n   npm install\n   ```\n3. Launch the extension in VS Code from the debug view ▶️\n\n## License 📜\n\nThis project is licensed under the [SEE LICENSE IN LICENSE](LICENSE).\n\n## Author ✍️\n\n**Soumya Prasad Rana**  \nEmail: soumyaprasad.rana@gmail.com 📧  \nGitHub: [soumyaprasadrana](https://github.com/soumyaprasadrana) 🐙\n\n## Support 🆘\n\nIf you encounter any issues or need help, please visit the [issues page](https://github.com/soumyaprasadrana/vscode-java-debugx/issues) and open a new issue or check for existing discussions.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoumyaprasadrana%2Fvscode-java-debugx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsoumyaprasadrana%2Fvscode-java-debugx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoumyaprasadrana%2Fvscode-java-debugx/lists"}