{"id":13773214,"url":"https://github.com/patrickelectric/qhot","last_synced_at":"2025-05-08T00:23:31.056Z","repository":{"id":50281272,"uuid":"192014830","full_name":"patrickelectric/qhot","owner":"patrickelectric","description":"Hot reload for nested qml files","archived":false,"fork":false,"pushed_at":"2024-04-21T16:25:44.000Z","size":5198,"stargazers_count":169,"open_issues_count":11,"forks_count":20,"subscribers_count":8,"default_branch":"master","last_synced_at":"2024-04-21T21:41:14.092Z","etag":null,"topics":["debug","hot-reload","qhot","qml","qt","reload","test"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/patrickelectric.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}},"created_at":"2019-06-14T23:07:36.000Z","updated_at":"2024-08-03T17:07:03.615Z","dependencies_parsed_at":"2024-08-03T17:17:26.936Z","dependency_job_id":null,"html_url":"https://github.com/patrickelectric/qhot","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patrickelectric%2Fqhot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patrickelectric%2Fqhot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patrickelectric%2Fqhot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/patrickelectric%2Fqhot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/patrickelectric","download_url":"https://codeload.github.com/patrickelectric/qhot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":231468021,"owners_count":18381174,"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":["debug","hot-reload","qhot","qml","qt","reload","test"],"created_at":"2024-08-03T17:01:12.855Z","updated_at":"2024-12-27T10:07:44.028Z","avatar_url":"https://github.com/patrickelectric.png","language":"C++","funding_links":[],"categories":["Uncategorized","Development"],"sub_categories":["Uncategorized"],"readme":"# QHot\n\nLive preview of your qml modifications. It works with nested qml components !\n\nCheck the online version [qmlonline](https://patrickelectric.work/qmlonline/) (Now as an official KDE project) !\n\n## Install\n\n### Downloads :package:\n\n- Qt6:\n  - :computer: [Windows](https://github.com/patrickelectric/qhot/releases/download/qt6-1.0.0/qhot-Windows.zip)\n  - :apple: [MacOS](https://github.com/patrickelectric/qhot/releases/download/qt6-1.0.0/qhot.dmg)\n  - :penguin: [Linux](https://github.com/patrickelectric/qhot/releases/download/qt6-1.0.0/qhot.AppImage)\n\n- Qt5:\n  - :computer: [Windows](https://github.com/patrickelectric/qhot/releases/download/qt5-1.0.0/qhot_release.zip)\n  - :apple: [MacOS](https://github.com/patrickelectric/qhot/releases/download/qt5-1.0.0/qhot.dmg)\n  - :penguin: [Linux](https://github.com/patrickelectric/qhot/releases/download/qt5-1.0.0/qhot.AppImage)\n\n### Arch Linux :zap:\n\n- AUR: `qhot-git`\n\n### Build for local Qt kit\n\nBuild qhot from sources for your specific Qt kit, and install it alongside the\nother Qt tools. This way qhot will find all the Qt plugins that you already\nhave installed on your local system. No need for a large package.\n\n```sh\ngit clone https://github.com/patrickelectric/qhot.git\ncd qhot\n# Configure\ncmake -B build -DCMAKE_BUILD_TYPE=Release\n# Or use CMAKE_PREFIX_PATH where QTDIR should point to a Qt kit, e.g. C:/Qt/5.15.2/msvc2019_64\ncmake -S . -B my-build -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH=\"$Env:QTDIR\"\n# Compile\ncmake --build build --parallel --config Release\n\n# Install qhot in the bin folder, e.g. C:/Qt/5.15.2/msvc2019_64/bin\ncmake --build build --target install\n```\n\n## How to use\n\nTo run qhot:\n  `./qhot.exe myFile.qml` or `./qhot.dmg myFile.qml` or `./qhot.AppImage myFile.qml`\n\n![example](/doc/example.gif)\n\n### Supported commands\n\n```sh\n--help, -h, -?           Give this friendly help message for our confort\n--desktop                Force use of desktop GL (AA_UseDesktopOpenGL)\n--gles                   Force use of GLES (AA_UseOpenGLES)\n--software               Force use of software rendering (Qt::AA_UseSoftwareOpenGL)\n--scaling                Enable High DPI scaling (AA_EnableHighDpiScaling)\n--no-scaling             Disable High DPI scaling (AA_DisableHighDpiScaling)\n--import-path, -I        Add list of **import** paths (path:path)\n--plugin-path, -P        Add list of **plugin** paths (path:path)\n--translation            Set the translation file (file)\n--style                  Change style\n--profile-path           Path (including filename) to qhot-profile.json (file)\n--background             Set the background color (color)\n--quick-controls-conf    Path (including filename) to qtquickcontrols2.conf (file)\n--app-name               Name of the application running inside qhot (name)\n```\n\n### Store options in a profile\n\nAll the command line options can also be set in a ```qhot-profile.json``` file. For\nexample:\n\n```json\n{\n    \"import-path\": [\n        \"lib/qml/modules\",\n        \"src/qml\"\n    ],\n    \"background\": \"#808080\",\n    \"quick-controls-conf\": \"src/qml/qtquickcontrols2.conf\"\n}\n```\n\nThe import paths in the example above are relative to the file itself, but can\nalso be absolute. The relative paths make it more convenient to add it to a\nvcs repository.\n\n### Integrate in QtCreator\n\nIntegrating qhot in QtCreator makes it very easy to quickly prototype within\nthe IDE. See [Using External Tools](https://doc.qt.io/qtcreator/creator-editor-external.html).\nExample configuration:\n\n1. Executable: `C:\\Qt\\5.15.2\\msvc2019_64\\bin\\qhot.exe`\n2. Arguments: `%{CurrentDocument:FilePath} --profile-path \"%{ActiveProject:Path}/qhot-profile.json\"`\n3. Environment: `QT_ASSUME_STDERR_HAS_CONSOLE=1` (This will append stdout to the console)\n\nIt is also quite handy to add a shortcut in QtCreator to launch qhot. See\n[Keyboard Shortcuts](https://doc.qt.io/qtcreator/creator-keyboard-shortcuts.html).\n\n### Shortcuts\n\n- **Ctrl+Meta+F1** Launch popup to change background\n- **Ctrl+Meta+Q** Quit application\n\n### Loading Test Data\n\nQHot has the same functionality as qmlscene to load dummy test data and it\nworks exactly the same way:\n[load test data](https://doc.qt.io/qt-5/qtquick-qmlscene.html#loading-test-data).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpatrickelectric%2Fqhot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpatrickelectric%2Fqhot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpatrickelectric%2Fqhot/lists"}