{"id":25914742,"url":"https://github.com/narnaud/natvis4qt","last_synced_at":"2026-04-12T21:30:31.077Z","repository":{"id":71560954,"uuid":"602692195","full_name":"narnaud/natvis4qt","owner":"narnaud","description":"Updated natvis files and cli tool to install them in different locations","archived":false,"fork":false,"pushed_at":"2025-04-07T06:24:57.000Z","size":795,"stargazers_count":10,"open_issues_count":4,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-07T07:27:47.166Z","etag":null,"topics":["cli","natvis","qt","qt5","qt6","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/narnaud.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":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-02-16T18:40:34.000Z","updated_at":"2025-04-07T06:24:49.000Z","dependencies_parsed_at":"2025-03-30T11:23:17.583Z","dependency_job_id":"f20e58c9-ce99-4d84-8023-75aa2801f779","html_url":"https://github.com/narnaud/natvis4qt","commit_stats":null,"previous_names":["narnaud/natvis4qt"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/narnaud/natvis4qt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/narnaud%2Fnatvis4qt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/narnaud%2Fnatvis4qt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/narnaud%2Fnatvis4qt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/narnaud%2Fnatvis4qt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/narnaud","download_url":"https://codeload.github.com/narnaud/natvis4qt/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/narnaud%2Fnatvis4qt/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276487462,"owners_count":25651133,"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","status":"online","status_checked_at":"2025-09-22T02:00:08.972Z","response_time":79,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["cli","natvis","qt","qt5","qt6","rust"],"created_at":"2025-03-03T11:36:28.436Z","updated_at":"2026-04-12T21:30:31.053Z","avatar_url":"https://github.com/narnaud.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Natvis4Qt - Install natvis files for Qt\n\nThis repository contains:\n\n- Up-to-date natvis files for Qt5 and Qt6\n- Command line tool to install or update them in different locations\n\n## Installation\n\n`natvis4qt` is a simple command line tool to install or update the natvis files in different locations.\n\n### Installation via [Scoop](https://scoop.sh/) (preferred)\n\n```batch\nscoop bucket add narnaud https://github.com/narnaud/scoop-bucket\nscoop install natvis4qt\n```\n\n### Installation via [Cargo](https://doc.rust-lang.org/cargo/)\n\n```\ncargo install natvis4qt\n```\n\n### Or via archive files\n\n1. Go to the [Releases](https://github.com/narnaud/natvis4qt/releases) page\n2. Download the latest `natvis-x86_64-pc-windows-msvc.zip` file\n3. Extract the files from it into a directory.\n\n## Usage\n\nJust run `natvis4qt install` on the command line and follow the instructions.\n\n![Demo](assets/demo.gif)\n\n```\nUsage: natvis4qt.exe [OPTIONS] \u003cCOMMAND\u003e\n\nCommands:\n  install  Install the natvis files\n  update   Update the natvis files\n  set      Adjust natvis4qt's settings\n  help     Print this message or the help of the given subcommand(s)\n\nOptions:\n      --dry-run  Install or update without copying the files\n  -h, --help     Print help (see more with '--help')\n  -V, --version  Print version\n```\n\n## Integration\n\n### Visual Studio\n\nSelect a version of `Visual Studio` when installing the natvis files.\n\nThis will install the natvis files in a central place that is used by Visual Studio. See documentation here: [Natvis file locations](https://learn.microsoft.com/en-us/visualstudio/debugger/create-custom-views-of-native-objects?view=vs-2022#BKMK_natvis_location)\n\nSome visualizers require debug symbols for Qt to be loaded. To load them, add the `bin` directory of your Qt installation (e.g. `C:\\Qt\\6.8.0\\msvc2022_64\\bin`) to the symbol search path under **Options \u003e Debugging \u003e Symbols**.\n\n\u003e [!CAUTION]\n\u003e The Qt VS Addin must be deactivated, as it is silently overwriting the natvis files in the Visualizers directory, see [QTVSADDINBUG-1308](https://bugreports.qt.io/browse/QTVSADDINBUG-1308).\n\n#### Image Watch\n\nIt is possible to visualize `QImage` and `QPixmap` using the [Image Watch](https://learn.microsoft.com/en-us/previous-versions/visualstudio/visual-studio-2015/debugger/image-watch/image-watch) extension from Microsoft.\n\n![Image Watch Example](assets/image-watch.png)\n\nInstall the extension, and click on the \"View\" button. It will open a new window with the image.\n\n\u003e [!WARNING]\n\u003e\n\u003e - It only supports images in RGB(A) with 32 bits/pixel.\n\u003e - The Qt natvis file must be in the default [Natvis file locations](https://learn.microsoft.com/en-us/visualstudio/debugger/create-custom-views-of-native-objects?view=vs-2022#BKMK_natvis_location).\n\n### Visual Studio Code\n\n#### Central Natvis file locations\n\nSelect `VS Code C/C++ Extension` when installing the natvis files.\n\nThis will install the natvis files in a central place that is used by the C/C++ extension. See available \"documentation\" here: [Natvis file locations](https://github.com/microsoft/vscode-cpptools/issues/925#issuecomment-591483777).\n\n\u003e [!WARNING]\n\u003e The files may disappear after an update of the [Microsoft C/C++ extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools).\n\n#### Per-project visualizer file\n\nAnother option is to install the natvis files in the different Qt directories, and set a `visualizerFile` in your launch configuration. Edit your `launch.json` file (or the `launch` section of your `*.code-workspace` file) and add something like this:\n\n```json\n    \"configurations\": [\n        {\n            \"name\": \"Current Target (VS)\",\n            \"type\": \"cppvsdbg\",\n            \"request\": \"launch\",\n            \"program\": \"${command:cmake.launchTargetPath}\",\n            \"visualizerFile\": \"${env:QTDIR}/natvis/qt6.natvis\",\n            \"cwd\": \"${workspaceFolder}\",\n            \"sourceFileMap\": {\n                \"C:/work/build/qt5_workdir/w/s\": \"${env:QTDIR}/../Src\",\n                \"Q:/qt5_workdir/w/s\": \"${env:QTDIR}/../Src\",\n                \"C:/Users/qt/work/install\": \"${env:QTDIR}/../Src\",\n                \"C:/Users/qt/work/qt\": \"${env:QTDIR}/../Src\"\n            },\n            \"symbolOptions\": {\n                \"searchPaths\": [\"${env:QTDIR}/bin\"],\n            }\n        }\n    ]\n```\n\n\u003e [!IMPORTANT]\n\u003e\n\u003e - The `QTDIR` environment variable must be set up before launching VS Code\n\u003e - You are limited to **only one** visualizer file with `cppvsdbg`, see related [issue](https://github.com/microsoft/vscode-cpptools/issues/10917).\n\n## Update\n\nIf you have installed `natvis4qt` using scoop, installed Natvis files will be automatically updated when updating via scoop.\nIf you don't want this mechanism, run:\n\n```cmd\nnatvis4qt set --autoupdate false\n```\n\nTo update them by hand, just run:\n\n```cmd\nnatvis4qt update\n```\n\n## Natvis files\n\nIf you are only interested in natvis files, you can find them here:\n\n- [qt5.natvis](https://github.com/narnaud/natvis4qt/blob/main/natvis/qt5.natvis)\n- [qt6.natvis](https://github.com/narnaud/natvis4qt/blob/main/natvis/qt6.natvis)\n\nYou can find the current support of the Natvis file here: [SUPPORT.md](SUPPORT.md)\n\n## License\n\nThe **natvis4qt** tool is licensed under the MIT license.\n\nThe natvis files are also licensed under the MIT license.\n\n## Contributions\n\n`qt5.natvis`:\n\n- [The Qt Company](https://www.qt.io/)\n\n`qt6.natvis`:\n\n- [The Qt Company](https://www.qt.io/)\n- [Klarälvdalens Datakonsult AB (KDAB)](https://www.kdab.com/)\n- [@nerixyz](https://github.com/Nerixyz)\n- [@nholthaus](https://github.com/nholthaus)\n- [@aleksey-nikolaev](https://github.com/aleksey-nikolaev)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnarnaud%2Fnatvis4qt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnarnaud%2Fnatvis4qt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnarnaud%2Fnatvis4qt/lists"}