{"id":13505571,"url":"https://github.com/stemoretti/qt-desktop-template","last_synced_at":"2025-03-30T00:31:11.033Z","repository":{"id":159751759,"uuid":"212286942","full_name":"stemoretti/Qt-Desktop-Template","owner":"stemoretti","description":"Template for creating applications for Linux, Windows and MacOS using the Qt widgets framework","archived":false,"fork":false,"pushed_at":"2023-07-25T13:56:26.000Z","size":163,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-01T03:32:34.066Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stemoretti.png","metadata":{"files":{"readme":"README.rst","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}},"created_at":"2019-10-02T08:11:14.000Z","updated_at":"2024-07-08T21:01:46.000Z","dependencies_parsed_at":"2023-12-24T10:00:20.648Z","dependency_job_id":null,"html_url":"https://github.com/stemoretti/Qt-Desktop-Template","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stemoretti%2FQt-Desktop-Template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stemoretti%2FQt-Desktop-Template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stemoretti%2FQt-Desktop-Template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stemoretti%2FQt-Desktop-Template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stemoretti","download_url":"https://codeload.github.com/stemoretti/Qt-Desktop-Template/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246262490,"owners_count":20749170,"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":[],"created_at":"2024-08-01T00:01:09.954Z","updated_at":"2025-03-30T00:31:06.024Z","avatar_url":"https://github.com/stemoretti.png","language":"C++","funding_links":[],"categories":["AppImage developer tools"],"sub_categories":["Templates"],"readme":".. .. image:: https://travis-ci.com/stemoretti/qt-desktop-template.svg?branch=master\n  :target: https://travis-ci.com/stemoretti/qt-desktop-template\n\n.. image:: https://github.com/stemoretti/qt-desktop-template/actions/workflows/appimage.yml/badge.svg\n  :target: https://github.com/stemoretti/qt-desktop-template/actions?query=workflow%3AAppImage\n\n.. image:: https://github.com/stemoretti/qt-desktop-template/actions/workflows/flatpak.yml/badge.svg\n  :target: https://github.com/stemoretti/qt-desktop-template/actions?query=workflow%3AFlatpak\n\n.. image:: https://github.com/stemoretti/qt-desktop-template/actions/workflows/snap.yml/badge.svg\n  :target: https://github.com/stemoretti/qt-desktop-template/actions?query=workflow%3ASnap\n\n.. image:: https://github.com/stemoretti/qt-desktop-template/actions/workflows/windows.yml/badge.svg\n  :target: https://github.com/stemoretti/qt-desktop-template/actions?query=workflow%3AWindows\n\n.. image:: https://github.com/stemoretti/qt-desktop-template/actions/workflows/macos.yml/badge.svg\n  :target: https://github.com/stemoretti/qt-desktop-template/actions?query=workflow%3AMacOS\n\nQt Desktop Template\n===================\n\nTemplate for creating applications for Linux, Windows and macOS with\nthe Qt Widgets framework.\n\nHow to build\n------------\n\nRequirements\n^^^^^^^^^^^^\n\nThe following software is required to compile this application:\n\n* A compiler that supports C++17\n* CMake \u003e= 3.19\n* Qt \u003e= 6.2\n\nCompiling and installing under Linux\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n.. code:: console\n\n  git clone https://github.com/stemoretti/qt-desktop-template.git\n  cd qt-desktop-template\n  mkdir build\n  cd build\n  cmake ..\n  make\n  make install\n\nThe default CMake installation prefix is ``/usr/local``. You can change it by\nredefining the option CMAKE_INSTALL_PREFIX in the configuration stage.\n(e.g. ``cmake -DCMAKE_INSTALL_PREFIX=/usr ..``)\n\nCompiling and running under Windows\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\nClone the repository with git software like `Github Desktop \u003chttps://desktop.github.com/\u003e`__.\n\nIt's easier to compile the program using an IDE such as Qt Creator.\nInstructions on how to download and install it can be found\n`here \u003chttps://doc.qt.io/qt-6/qt-intro.html\u003e`__.\nInformation on how to use it to build and run programs can be found\n`here \u003chttps://doc.qt.io/qtcreator/index.html\u003e`__.\n\nCompiling and creating a bundle under macOS\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n.. code:: console\n\n  git clone https://github.com/stemoretti/qt-desktop-template.git\n  cd qt-desktop-template\n  cmake -B build -G \"Ninja\"\n  cmake --build build\n\nThe bundle directory is automatically created inside the build directory.\nHowever, it doesn't contain the libraries that the program needs to run.\nTo deploy the required Qt libraries into the bundle, run the following command.\n\n.. code:: console\n\n  macdeployqt \"Qt Desktop Template.app\" [-dmg]\n\nThe optional `-dmg` option is for creating a dmg disk image file.\n\nTranslations\n------------\n\nTranslations are stored in ``.ts`` files inside the ``translations`` folder.\nTheir name contains the language code of the translation they provide.\n\nTo add languages, follow the steps below.\n\n* Add the translation's file path of the language you wish to support to the\n  variable ``TS_FILES`` inside the file\n  `CMakeLists.txt \u003chttps://github.com/stemoretti/qt-desktop-template/blob/master/CMakeLists.txt#L107\u003e`__.\n\n* Configure the project by running CMake.\n\n* Run the following command to generate the ``.ts`` file of each language:\n\n  .. code:: console\n\n    make update_translations\n\n* Open the newly created file with the Qt tool ``linguist``.\n  Translate the program's texts and save the file.\n\nThe binary translation files will be created automatically during the compilation.\n\nCredits\n-------\n\nSoftware used for CI deployment:\n\n* `aqtinstall \u003chttps://github.com/miurahr/aqtinstall\u003e`__\n\n* `linuxdeployqt \u003chttps://github.com/probonopd/linuxdeployqt\u003e`__\n\nSee also\n--------\n\nOther similar templates:\n\n* `QtApp-Template \u003chttps://github.com/alex-spataru/QtApp-Template\u003e`__\n\n* `mini-cmake-qt \u003chttps://github.com/euler0/mini-cmake-qt\u003e`__\n\n* `cmake-init \u003chttps://github.com/cginternals/cmake-init\u003e`__\n\n* `cpp_starter_project \u003chttps://github.com/cpp-best-practices/cpp_starter_project\u003e`__\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstemoretti%2Fqt-desktop-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstemoretti%2Fqt-desktop-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstemoretti%2Fqt-desktop-template/lists"}