{"id":25417915,"url":"https://github.com/trkako/executecpp","last_synced_at":"2025-05-05T21:33:44.826Z","repository":{"id":255606644,"uuid":"851678661","full_name":"TRKako/executeCPP","owner":"TRKako","description":"Shortcut console \"\"\"app\"\"\" to compile and run your program with just opening it","archived":false,"fork":false,"pushed_at":"2025-03-11T16:24:53.000Z","size":671,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-11T17:33:08.638Z","etag":null,"topics":["compiler","console-application","cpp"],"latest_commit_sha":null,"homepage":"https://github.com/TRKako/","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/TRKako.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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":"2024-09-03T14:26:52.000Z","updated_at":"2025-03-11T16:24:56.000Z","dependencies_parsed_at":"2024-09-06T09:15:24.811Z","dependency_job_id":"8018b325-5bd0-4c91-ac36-d246329e8881","html_url":"https://github.com/TRKako/executeCPP","commit_stats":null,"previous_names":["trkako/executecpp"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TRKako%2FexecuteCPP","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TRKako%2FexecuteCPP/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TRKako%2FexecuteCPP/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TRKako%2FexecuteCPP/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TRKako","download_url":"https://codeload.github.com/TRKako/executeCPP/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252579995,"owners_count":21771248,"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":["compiler","console-application","cpp"],"created_at":"2025-02-16T18:02:06.425Z","updated_at":"2025-05-05T21:33:44.820Z","avatar_url":"https://github.com/TRKako.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"###### note: this script assumes that you have installed on your system MSYS2 and MinGW, if not, you can get it by following the [Vscode tutorial to get MinGW](https://code.visualstudio.com/docs/cpp/config-mingw#_installing-the-mingww64-toolchain), also, this program will only work with command line if you have \"autorun\" enabled, to compile programs without this error you have to set autorun to false\n# executeCPP\nExecute and compile your cpp file on small console window at the same time\n\n# How to use it?\nJust download the rar binary from the [Releases tab](https://github.com/TRKako/executeCPP/releases), decompress it and throw it on your project, something like this:\n```\nExample Project/\n│\n├───test.cpp //This is your cpp file that you want to test\n│\n└───executeCPP/    //This is the folder that the rar drops, throw it inside the folder in which your cpp file is\n    ├───ExecuteCPP.exe\n    ├───cppConf.json\n    │\n    └───Icons/\n        └───default.ico\n```\nThen you just run `ExecuteCPP.exe` and your program will show up there.\n\n# Can I customize this?\nYes!, you can customize:\n\u003e - The Window Title\n\u003e - The path to your cpp file if you want to put this thing somewhere else\n\u003e - The path to the Icon that you wanna use on your Window (Make sure it's an ICO file, I recommend [This website](https://redketchup.io/icon-converter) to convert whatever picture to ICO)\n  \nOn `cppConf.json`.\n\n\u003cbr\u003e\n\n# Basic use explanation\n```JSON\n{\n\t\"program_name\":\"Test Window\",\n  // The name of the output program.exe (you can specify the extension if you want, it's not neccesary tho)\n\n  \t\"cpp_name\":\"test\",\n     // The name of your cpp file, it must not have the .cpp extension or it's not going to work\n\n\t\"rute\":\"C:/Users/\u003cyour_username_here\u003e/Desktop/Example Project/\",\n   // The path to the folder where your cpp file is located\n\n\t\"icon\":\"C:/Users/\u003cyour_username_here\u003e/Desktop/Example Project/cute icon I really like/griffith.ico\",\n  // The path to your ICO file\n\n\t\"arguments\": [\n\t\t\"-static\",\n\t\t\"-static-libstdc++\"\n\t],\n  // Optional arguments, in this case I put by default those two, you can use as much arguments as you want, even replace this two, you can also set nothing there, like this\n\n  // \"arguments\": []\n\n\t\"customCompile\":[\n\t\t\"false\",\n    // you can turn ON and OFF this option by setting this to \"true\" or \"false\"  \n\t\t\"g++ -static -static-libstdc++ -o YOUR_EXE_PROGRAM_NAME_HERE.exe YOUR_FILE_NAME_HERE.cpp \u0026\u0026 YOUR_EXE_PROGRAM_NAME_HERE.exe\"\n\t],\n  // CustomCompile it's in case you don't want to use the default settings of the program and you want to run your own command, using this will ignore all the other options but \"rute\", \"icon\" and \"autorun\"; Only one line of command its allowed, tho you can add more and more commands by just typing \u0026\u0026\n\n\t\"autorun\":\"true\"\n  // This option it's for running your program on the console or not, set this to false if you are using customCompile or if you are not compiling a command line program\n}\n\n```\n\n\u003cp align=\"center\"\u003e\u003csub\u003e\u003csup\u003enote: you can also use relatives paths like \"../desktop/some folder here/\" or \"./my project folder/src/\"\u003c/sup\u003e\u003c/sub\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003eand it would look like this:\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://i.imgur.com/UOvQ79X.png\" title=\"Example\"/\u003e\n\u003c/p\u003e\u003cbr\u003e\n\n\n# Detailed json documentation\n\u003cp align=\"center\"\u003e\u003csub\u003e\u003csup\u003ethis is the first time I do one\u003c/sup\u003e\u003c/sub\u003e\u003c/p\u003e\n\n| Parameter | Description                       | Type     |Required| \n| :-------- | :-------------------------------- | :------- |:--------|\n| `program_name`        |  Name of the output executable | `string` |False|\n| `cpp_name`            |  Name of the CPP file you're compiling / running | `string`|**Required**|\n| `ruteCPP`             |  Path to your CPP file | `string` |False|\n| `icon`                |  Path to your ICO file (this parameter must have **.ico** in the end)| `string`|False|\n| `arguments`           |  Arguments for compiling| `string` |False|\n| `customCompile`       |  One line custom command| `boolean \u0026 string` |**Boolean Required**|\n| `autorun`             |  Run program on compiling| `boolean` | **Required**|\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n#### program_name\n| Parameter | default state                | Required     |\n| :-------- | :------------------------- | :--------|\n| `program_name` |`YOUR_EXE_PROGRAM_NAME_HERE` | False |\n\nThe parameter \"`program_name`\" it's the name of the executable of your cpp, if for example this parameter is set to \"helloWorld\" or \"byeWold.exe\" the output file will be that name\n\nIn this parameter, typing .exe in the end it's completly optional and it will work either way; This parameter can be omitted but it will output your file with the name \"`program name.exe`\".\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n#### cpp_name\n| Parameter | default state                | Required     |\n| :-------- | :------------------------- | :--------|\n| `cpp_name` |`YOUR_FILE_NAME_HERE` | **True** |\n\nThe parameter \"`cpp_name`\" it's the name of your cpp file\n\nIn this parameter, typing .cpp in the end it's completly optional and it will work either way; This parameter can NOT be omitted.\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n#### ruteCPP\n| Parameter | default state                | Required     |\n| :-------- | :------------------------- | :--------|\n| `ruteCPP` |   `../` | False |\n\nThe parameter \"`ruteCPP`\" it's the path to the cpp file you're working on\n\nIn this parameter, typing a path it's completly optional, if this parameter it's left on blank it will use the path of the folder \"ExecuteCPP\", it's recommended to use a relative path or the default path for more comfort but you can change it as much as you want; This parameter can be omitted.\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n#### icon\n| Parameter | default state                | Required     |\n| :-------- | :------------------------- | :--------|\n| `icon` |    | False |\n\nThe parameter \"`icon`\" it's the path to the icon you want to use\n\nIn this parameter, typing a path it's completly optional, if this parameter it's left on blank it will use the default path to it's icon on \"**`./ExecuteCPP/Icons/default.ico`**\", if you do put your icon on this parameter, you have to make sure it does end with **`your_ico_name.ico`**, if it doesn't ends with \".ico\" it will fail.\n\nIf you want to use your own icon make sure it's a proper ICO file, I suggest [redketchup.io](https://redketchup.io/icon-converter) to convert your images to a good ICO file\n\nThe icon setted for this will be only so it displays on the console window, it does not set an Icon to the executable, for that I suggest using [Resource Hacker](https://www.google.com/search?q=resource+hacker)\n\nThis parameter can be omitted.\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n#### arguments\n| Parameter | default state                | Required     |\n| :-------- | :------------------------- | :--------|\n| `arguments` | `-static`, `-static-libstdc++`   | False |\n\nThe parameter \"`arguments`\" is the arguments used for compiling your cpp file\n\nIn this parameter, typing an arguments it's completly optional, if this parameter it's left on blank nothing will happend and it will compile without any arguments. if you do type arguments this parameter, you have to make a new row for each one, like this:\n```json\n\"arguments\": [\n\t\t\"-static\",\n\t\t\"-static-libstdc++\",\n        \t\"XXXXXXXXXX\",\n        \t\"YYYYYYYYYY\",\n        \t\"ZZZZZZZZZZ\",\n        \t\"you_get_the_idea...\"\n\t],\n```\nif you want to leave this on blank it has to be like this\n```json\n\"arguments\": [],\n```\n\nThis parameter can be omitted.\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n#### customCompile\n| Parameter | default state                | Required     |\n| :-------- | :------------------------- | :--------|\n| `customCompile` |boolean: **`false`**, string: **`g++ -static -static-libstdc++ -o YOUR_EXE_PROGRAM_NAME_HERE.exe YOUR_FILE_NAME_HERE.cpp \u0026\u0026 YOUR_EXE_PROGRAM_NAME_HERE.exe`** | **Boolean Required** / False |\n\nThe parameter \"`customCompile`\" it's both a boolean and string, you can enable this option by setting the boolean of `customCompile` from false to \"`True`\", once you enable this parameter you can use whatever command you like\n\nby default the command there it's a compile one, but you can actually use whatever you want, try using the command \"`ping google.com`\" on it, it would look like this\n```json\n\"customCompile\":[\n\t\t\"true\",\n\t\t\"ping google.com\"\n\t],\n```\n\nEnabling the parameter `customCompile` will make the program ignore these previous parameters:\n- `program_name`\n- `cpp_name`\n- `arguments`\n- `autorun`\n\nThe `ruteCPP` argument will define on which directory the command will execute, `icon` stays being optional, and `autorun` will be ignored, but it if it's enabled it will pop up a warning on the console;\n\nThis parameter can be omitted.\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n#### autorun\n| Parameter | default state                | Required     |\n| :-------- | :------------------------- | :--------|\n| `autorun` |   `true` | **True** |\n\nThe parameter \"`autorun`\" it's a boolean switch that allows you to run your output executable on the same console window at the same moment it ends compiling, useful for debugging purposes\n\nif you set this parameter to false, ExecuteCPP will just compile your cpp and then it will end there;\n\nThis parameter can NOT be omitted.\n\n\n\n\u003cbr\u003e\n\n---------------------------------------------\n---------------------------------------------\n---------------------------------------------\n\n# How is this better than just compile C++ the normal way?\nWell, this is more for people that don't like using the compile button everytime, or if you are using Vscode and you don't want to set up everything there just to compile \"hello world\", this is just an alternative\n\n\u003cbr\u003e\n\n# I have to enter the folder everytime I want to compile?\n\nNo, you don't, in fact I did this with the idea in mind of using it with the taskbar since you only have to do \"Windows key + number\" to run it, something like this \n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://i.imgur.com/JnWoxvP.png\" title=\"Taskbar Example\"/\u003e\n\u003c/p\u003e\u003cbr\u003e\n\nIn this example you have to do \"Windows key + 2\" to compile the file, that's all\n\n\u003cbr\u003e\n\n# Can I get rid of the whole folder and just use the program alone?\n\nYes, you can, but you need to have \"`cppConf.json`\" on the same folder as \"`ExecuteCPP.exe`\" and a path to an icon, if you don't want to put one, then bring the folder \"`Icons`\" into the same folder as \"`ExecuteCPP.exe`\" and let the value of the icon on \"`cppConf.json`\" in blank \n\n\n----\n  \u003cp align=\"center\"\u003e-Kako\u003c/sup\u003e\u003c/sub\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/TRKako/TRKako/main/files/Marina.svg\" title=\"Evil Kako\"/\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/TRKako/TRKako/main/files/Arusu2.svg\" title=\"Kako\"/\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrkako%2Fexecutecpp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftrkako%2Fexecutecpp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrkako%2Fexecutecpp/lists"}