{"id":22691452,"url":"https://github.com/lleny/vkhandybug","last_synced_at":"2025-04-12T23:10:05.118Z","repository":{"id":148710471,"uuid":"620194853","full_name":"LLeny/VkHandybug","owner":"LLeny","description":"Atari lynx debugger","archived":false,"fork":false,"pushed_at":"2024-02-29T08:41:40.000Z","size":1116,"stargazers_count":6,"open_issues_count":5,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-02-29T09:41:37.000Z","etag":null,"topics":["atari","emulator-development","emulator-frontend","glfw","imgui","lynx","vulkan"],"latest_commit_sha":null,"homepage":"","language":"C++","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/LLeny.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}},"created_at":"2023-03-28T08:00:35.000Z","updated_at":"2023-09-10T15:31:08.000Z","dependencies_parsed_at":"2024-02-29T09:48:35.582Z","dependency_job_id":null,"html_url":"https://github.com/LLeny/VkHandybug","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LLeny%2FVkHandybug","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LLeny%2FVkHandybug/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LLeny%2FVkHandybug/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LLeny%2FVkHandybug/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LLeny","download_url":"https://codeload.github.com/LLeny/VkHandybug/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228986991,"owners_count":18002227,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["atari","emulator-development","emulator-frontend","glfw","imgui","lynx","vulkan"],"created_at":"2024-12-10T01:11:10.943Z","updated_at":"2024-12-10T01:11:11.518Z","avatar_url":"https://github.com/LLeny.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VkHandybug\n\nDebugger for the Atari Lynx emulator [Handy](https://handy.sourceforge.net/).\n\nBased on ImGui, GLFW/Vulkan, reasonably cross platform (Linux - GCC 12.1, Windows - Visual Studio 2022, macOS - Xcode 14.2).\n\n![](/assets/screen1.jpg)\n\n# Binaries\nLatest Windows binaries and Linux Flatpak can be found on the [releases](https://github.com/LLeny/VkHandybug/releases) page.\n\n# Usage\n## First run\nYou will first need to set the Lynx ROM image path, please use the ```MAIN -\u003e Settings...``` menu to do so.\n\n## Breakpoint condition\nThe breakpoint condition uses [Lua](https://www.lua.org/), please refer to [Lua's documentation](https://www.lua.org/docs.html) for more information on the syntax.\nYou can access the Lynx memory by using the different accessors ```RAM, ROM, MIKEY, SUZY, CPU, CART, EEPROM``` by simply using them as arrays, for example ```RAM[0x0012], MIKEY[0xFD02]```.\nYou can also access the CPU state by using the ```REGS``` accessor, it has the following properties: ```A, X, Y, PC, PS, SP```, for example ```REGS.X```. \n\nThe condition can be edited by simply clicking on the condition cell of the corresponding breakpoint.\n```\nRAM[0x50FD] \u003e 12 and REGS.X ~= 0\n```\n\nIf you need the breakpoint condition to be able to trigger at any ```PC```, use a breakpoint address of ```0```.\n\n## Symbols\nTo load symbols create a file with the same name as the cart but with the .lbl extension.\nThe *lbl* file can be a Vice label file (generated by [cl65](https://cc65.github.io/doc/cl65.html) -Ln option) or simply be a list of \"addr label\".\n\n```\n  0034 here\n  4ADE andhere\n```\n\n# Building\n## Dependencies\n\n- [Vulkan SDK](https://www.lunarg.com/vulkan-sdk/), please refer to your system's [vulkan \"Getting Started\"](https://www.lunarg.com/vulkan-sdk/) page for installation.\n- [CMake](https://cmake.org/) is required as the build files generator.\n\n## Compiling\n### Linux\n```\ngit clone https://github.com/LLeny/VkHandybug.git\ncd VkHandybug\nmkdir build\ncd build\ncmake -DCMAKE_BUILD_TYPE=Release ..\ncmake --build .\n```\n\n#### AppImage\n```\ncmake --build . --target=vkhandybug.AppImage\n```\n\nThe binary should be created in the folder ```./bin```   \n\n### OSX\n```\ngit clone https://github.com/LLeny/VkHandybug.git\ncd VkHandybug\nmkdir build\ncd build\ncmake -G Xcode -DCMAKE_BUILD_TYPE=Release ..\n```\nOpen the generated ```vkhandybug.xcodeproj``` with XCode   \nSelect ```vkhandybug``` scheme  \nRun / build   \n\n# Dependencies\n- [cereal](https://uscilab.github.io/cereal/)\n- [Dear ImGui](https://github.com/ocornut/imgui)\n- [GLFW](https://www.glfw.org/)\n- [hash-library](https://create.stephan-brumme.com/hash-library/)\n- [ImGuiFileDialog](https://github.com/aiekick/ImGuiFileDialog)\n- [imgui_memory_editor](https://github.com/ocornut/imgui_club)\n- [Lua](https://www.lua.org/)\n- [miniaudio](https://miniaud.io/)\n- [sol2](https://github.com/ThePhD/sol2)\n- [vk-bootstrap](https://github.com/charles-lunarg/vk-bootstrap)\n- [Vulkan Memory Allocator](https://gpuopen.com/vulkan-memory-allocator/)\n- [Vulkan SDK](https://www.lunarg.com/vulkan-sdk/)\n- [zlib](https://github.com/madler/zlib)\n- [{fmt}](https://fmt.dev/latest/index.html)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flleny%2Fvkhandybug","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flleny%2Fvkhandybug","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flleny%2Fvkhandybug/lists"}