Qt Project Launcher

Overview

A simple launcher application to quickly open Qt projects in Qt Creator. You can place it directly in a project folder or select from a list of multiple projects to launch.

Qiita Article (Japanese)

Article explaining this tool (Qiita)

Introduction Video (Japanese)

Key Features

• Single Project Mode: Simply place the executable in the project folder to launch that project directly.
• Multi Project Mode: Define multiple project paths in a configuration file and select which one to launch from a list.
• Auto Launch: Directly launches Qt Creator without showing the GUI if launch conditions are met (e.g., only one project is registered).
• Auto Detect Qt Creator: Automatically searches for qtcreator in the system PATH environment variable. If not found, it uses a default path.

Usage

1. Single Project Mode

1. Copy the built executable (appmakeQtProjectLink) to the root folder of the Qt project you want to open (where CMakeLists.txt or .pro files are located).
2. Run the executable, and it will open that project in Qt Creator.

Tip: It is convenient to rename the executable to the project name (e.g., MyAwesomeProject) or create a shortcut.

2. Multi Project Mode

1. Create a configuration file named qtProjectList.txt.

2. Write the full path of the projects you want to open in the file, one per line.

   Example:

   /home/user/dev/project-a
   /home/user/dev/project-b
   C:\Users\user\Documents\Qt\project-c

3. Place the created qtProjectList.txt in the application data folder specific to your OS.

   • Linux: ~/.local/share/makeQtProjectLink/qtProjectList.txt
   • Windows: C:\Users\<Username>\AppData\Local\makeQtProjectLink\qtProjectList.txt
   • macOS: ~/Library/Application Support/makeQtProjectLink/qtProjectList.txt

4. You can run appmakeQtProjectLink from anywhere.

   • If there is only one project in the list, that project opens directly.
   • If there are multiple projects in the list, a selection window appears. Use the number keys on your keyboard to open the corresponding project.

Build Instructions

This project uses CMake and Qt 6.

1. Ensure that Qt 6, a C++ compiler, and CMake are installed.

2. Run the following commands in the project's root directory:

   # Create build directory
   mkdir build && cd build
   
   # Run CMake (Adjust the Qt path according to your environment)
   cmake .. -DCMAKE_PREFIX_PATH=/path/to/your/Qt/6.x.x/gcc_64
   
   # Build
   cmake --build .

3. Once the build is complete, the executable file will be generated in the build directory.