{"id":13587235,"url":"https://github.com/proffapt/code-runner","last_synced_at":"2026-03-07T05:06:40.046Z","repository":{"id":40545682,"uuid":"474942567","full_name":"proffapt/code-runner","owner":"proffapt","description":"Implementation of code-runner in bash for compiling  code files and executing them with one and only command","archived":false,"fork":false,"pushed_at":"2024-04-12T13:22:00.000Z","size":1171,"stargazers_count":20,"open_issues_count":0,"forks_count":7,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-30T14:40:37.380Z","etag":null,"topics":["autmate-compilation","automate-execution","automation","bash","c-cpp","code","code-runner","compile-and-run","compile-and-run-code","compile-code","compile-run","execute-code","hacktoberfest","java-runner","python-version-selector","run-code","runner"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/proffapt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-03-28T09:57:49.000Z","updated_at":"2025-05-26T09:23:19.000Z","dependencies_parsed_at":"2024-10-27T17:26:38.070Z","dependency_job_id":"06dbc7b8-da91-45bd-9e4c-762162b1b40f","html_url":"https://github.com/proffapt/code-runner","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/proffapt/code-runner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/proffapt%2Fcode-runner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/proffapt%2Fcode-runner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/proffapt%2Fcode-runner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/proffapt%2Fcode-runner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/proffapt","download_url":"https://codeload.github.com/proffapt/code-runner/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/proffapt%2Fcode-runner/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30208730,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-07T03:24:23.086Z","status":"ssl_error","status_checked_at":"2026-03-07T03:23:11.444Z","response_time":53,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["autmate-compilation","automate-execution","automation","bash","c-cpp","code","code-runner","compile-and-run","compile-and-run-code","compile-code","compile-run","execute-code","hacktoberfest","java-runner","python-version-selector","run-code","runner"],"created_at":"2024-08-01T15:06:06.933Z","updated_at":"2026-03-07T05:06:39.685Z","avatar_url":"https://github.com/proffapt.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"\u003cdiv id=\"top\"\u003e\u003c/div\u003e\n\n\n\u003c!-- PROJECT SHIELDS --\u003e\n\u003c!-- https://www.markdownguide.org/basic-syntax/#reference-style-links--\u003e\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![MIT License][license-shield]][license-url]\n[![LinkedIn][linkedin-shield]][linkedin-url]\n\n\n  \u003ch3 align=\"center\"\u003ecode-runner\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    \u003ci\u003eexecute code files with ease\u003c/i\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/proffapt/code-runner#readme\"\u003e\u003cstrong\u003eExplore the docs »\u003c/strong\u003e\u003c/a\u003e\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/proffapt/code-runner/issues\"\u003eReport Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/proffapt/code-runner/issues\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n\u003cdetails\u003e\n  \u003csummary\u003eTable of Contents\u003c/summary\u003e\n  \u003col\u003e\n    \u003cli\u003e\n      \u003ca href=\"#about-the-project\"\u003eAbout The Project\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#why-this-code-runner\"\u003eWhy this Code Runner?\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\n      \u003ca href=\"#getting-started\"\u003eGetting Started\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#uninstallation\"\u003eUninstallation\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\n      \u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#examples\"\u003eExamples\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#integrating-with-vscode\"\u003eIntegrating with vscode\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#integrating-with-vim\"\u003eIntegrating with vim\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contact\"\u003eContact\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#acknowledgments\"\u003eAcknowledgments\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#miscelleneous\"\u003eMiscelleneous\u003c/a\u003e\u003c/li\u003e\n  \u003c/ol\u003e\n\u003c/details\u003e\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n## About The Project\n\nThis is a script, which compiles the code file and run it for you and delete other _junk_ files if created during the process of compilation, all this with one command for all the languages supported by it. No more remembering different arguments for different compilers to compile, execut and debug the code.\n\n### Why this Code Runner?\n\n- Can detect correct version of python with 90% accuracy.\n- Has inbuilt debugger support.\n- Custom made keybindings for [vim](#integrating-with-vim) and [vscode](#integrating-with-vscode).\n- Robust code, deals with all possible cases.\n\t- Can execute files with spaces in their names.\n\t- Can execute from any location.\n- Automatically cleans executable files by default.\n- Highest number of languages supported compared to its alternatives.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- GETTING STARTED --\u003e\n## Getting Started\n\n### Installation\n\n_To install and configure the project on your system locally, use suitable method:_\n\n- [Using curl](#install-using-curl)\n- [Using brew](#install-using-brew)\n\n#### Install using CURL\n\n1. Copy and run the following command to install the run binary on your system.\n\n   ```sh\n   curl https://raw.githubusercontent.com/proffapt/code-runner/main/.setup/install.sh | bash\n   ```\n2. Run the code\n   ```sh\n   run my_code.c\n   ```\n   OR\n   ```sh\n   run ~/path/to/my_code.c\n   ```\n\n#### Install using BREW\n\n   ```bash\n   brew tap proffapt/brewtap\n   brew install code-runner\n   ```\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n### Uninstallation\n\n_To uninstall the tool from your system execute the following command, depending upon your installation_\n\n- [Using curl](#uninstall-using-curl)\n- [Using brew](#uninstall-using-brew)\n\n#### Uninstall using CURL\n\n   ```sh\n   curl https://raw.githubusercontent.com/proffapt/code-runner/main/.setup/uninstall.sh | bash\n   ```\n   \n#### Uninstall using BREW\n   ```bash\n   brew uninstall code-runner\n   ```\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- USAGE EXAMPLES --\u003e\n## Usage\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/proffapt/code-runner\"\u003e\n  \t\u003cimg width=\"1278\" alt=\"image\" src=\"https://user-images.githubusercontent.com/86282911/204351618-f23628c7-83b1-4e44-9463-e89ad91f274e.png\"\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n### Examples \n\n* Compilation and Execution\n\n  \u003cimg width=\"500\" alt=\"image\" src=\"https://user-images.githubusercontent.com/86282911/204359570-7351d910-cbda-4d83-9d01-9a89e27b46fd.png\"\u003e \n* Debugging\n\n  \u003cimg width=\"600\" alt=\"image\" src=\"https://user-images.githubusercontent.com/86282911/204362397-881fd36e-c90d-426f-9130-3b6ca872ad88.png\"\u003e\n* Python\n\n  \u003cimg width=\"600\" alt=\"image\" src=\"https://user-images.githubusercontent.com/86282911/204361180-899b41b6-6101-40c6-94d6-99872111daf2.png\"\u003e\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003cdiv id=\"integrating-with-vscode\"\u003e\u003c/div\u003e\n\n## Integrating with vscode\n\nCreate custom keybindings for `vscode` to use this script more conveniently in vscode, you can copy my keybindings from [vscode-keybindings](https://github.com/proffapt/code-runner/blob/main/keybindings/vscode-keybindings) into your keybindings.json\n\n* `alt+space` \n\n\t- **If there is no instance of terminal**: Spawns a new terminal `\u003e` shifts the focus to it.\n\t- **If the instance already exists and focus is on editor pane**: Focuses the terminal.\n\t- **If the focus is on terminal**: Focuses the editor pane keeping the terminal at it's place.\n\n* `cmd+contextmenu` -- use twice for execution\n\n\t- **If there is no terminal instance**: Spawns a new terminal `\u003e` shifts focus to it(DOESN\"T EXECUTE THE CODE, press again to execute the code).\n\t- **If instance exists and focus is on editor pane**: Shifts focus to terminal(DOESN\"T EXECUTE THE CODE, press again to execute the code).\n\t- **If the focus is on terminal**: Executes the code.\n\n\t^ **NOTE**: Code execution is also possible even if the code file is not directly inside the folder opened in vscode.\n\n\u003e\u003e _Stores previous execution history, as there is no new terminal created everytime, it's created only when not present else uses the same terminal_\n\nhttps://user-images.githubusercontent.com/86282911/204466533-977280fc-a1a7-492f-bf91-9090d5c70cf4.mp4\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003cdiv id=\"integrating-with-vim\"\u003e\u003c/div\u003e\n\n## Integrating with vim\n\nCreate custom keybindings for `{Neo}vim` to use this script more conveniently in `{Neo}vim`, you can copy my keybindings from the following files to your vim configuration file.\n\n- [For .{n}vimrc type configs](https://github.com/proffapt/code-runner/blob/main/keybindings/vim-keybindings-rc)\n- [For lua type configs](https://github.com/proffapt/code-runner/blob/main/keybindings/vim-keybindings-lua)\n\n* `rr` \n\n\t- In NORMAL mode: Saves the file `\u003e`  creates a new floaterm buffer `\u003e` shifts focus to it `\u003e` runs the code(CLOSE the buffer with any key after completion of execution).\n\n\u003e\u003e _Doesn't store previous execution history, as there is a new buffer created everytime_\n\n* `ff` \n\n\t- **In NORMAL mode with no existing floaterm buffer**: Saves the file `\u003e` creates a new floaterm buffer `\u003e` shifts focus to it `\u003e` runs the code.\n\t- **In NORMAL mode with existing floaterm buffer but focus on code buffer**: Saves the file `\u003e` shifts focus to floaterm buffer `\u003e` runs the code.\n\t- **In NORMAL mode with existing floaterm buffer and focus on flaoterm buffer**: Hides the floaterm buffer `\u003e` focuses on the working file's buffer.\n\t- **In TERMINAL mode**: Hides active floaterm buffer `\u003e` focuses on the working file's buffer. \n\n\u003e\u003e _Stores previous execution history, as there is no new buffer created everytime, it's created only when not present else uses the same buffer_\n\nhttps://user-images.githubusercontent.com/86282911/204343876-fa160388-ba4c-47be-88a0-16c6f7e7c1cb.mp4\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- CONTACT --\u003e\n## Contact\n\n\u003cp\u003e\n📫 Arpit Bhardwaj ( aka proffapt ) -   \n\n\u003ca href=\"https://twitter.com/proffapt\"\u003e\n  \u003cimg align=\"center\" alt=\"proffapt's Twitter \" width=\"22px\" src=\"https://raw.githubusercontent.com/edent/SuperTinyIcons/master/images/svg/twitter.svg\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://t.me/proffapt\"\u003e\n  \u003cimg align=\"center\" alt=\"proffapt's Telegram\" width=\"22px\" src=\"https://raw.githubusercontent.com/edent/SuperTinyIcons/master/images/svg/telegram.svg\" /\u003e\n\u003c/a\u003e\n\u003ca href=\"https://www.linkedin.com/in/proffapt/\"\u003e\n  \u003cimg align=\"center\" alt=\"proffapt's LinkedIn\" width=\"22px\" src=\"https://raw.githubusercontent.com/edent/SuperTinyIcons/master/images/svg/linkedin.svg\" /\u003e\n\u003c/a\u003e \n\u003ca href=\"mailto:proffapt@pm.me\"\u003e\n  \u003cimg align=\"center\" alt=\"proffapt's mail\" width=\"22px\" src=\"https://raw.githubusercontent.com/edent/SuperTinyIcons/master/images/svg/mail.svg\" /\u003e\n\u003c/a\u003e \n\u003ca href=\"https://cybernity.group\"\u003e\n  \u003cimg align=\"center\" alt=\"proffapt's forum for cybernity\" width=\"22px\" src=\"https://cybernity.group/uploads/default/original/1X/a8338f86bbbedd39701c85d5f32cf3d817c04c27.png\" /\u003e\n\u003c/a\u003e \n\u003c/p\u003e\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\n\u003c!-- ACKNOWLEDGMENTS --\u003e\n## Acknowledgments\n\n* [Choose an Open Source License](https://choosealicense.com)\n* [Img Shields](https://shields.io)\n* [Bash filename manipulation](https://stackoverflow.com/a/965069)\n\u003c!-- UPDATE --\u003e\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## Miscelleneous\n\nDo consider looking at other paradigms of this documentation\n  - [Change-logs](CHANGELOG.md)\n  - [License used](LICENSE.txt)\n  - [Code Of Conduct](CODE_OF_CONDUCT.md)\n  - [How to contribute?](CONTRIBUTING.md)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n\n[contributors-shield]: https://img.shields.io/github/contributors/proffapt/code-runner.svg?style=for-the-badge\n[contributors-url]: https://github.com/proffapt/code-runner/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/proffapt/code-runner.svg?style=for-the-badge\n[forks-url]: https://github.com/proffapt/code-runner/network/members\n[stars-shield]: https://img.shields.io/github/stars/proffapt/code-runner.svg?style=for-the-badge\n[stars-url]: https://github.com/proffapt/code-runner/stargazers\n[issues-shield]: https://img.shields.io/github/issues/proffapt/code-runner.svg?style=for-the-badge\n[issues-url]: https://github.com/proffapt/code-runner/issues\n[license-shield]: https://img.shields.io/github/license/proffapt/code-runner.svg?style=for-the-badge\n[license-url]: https://github.com/proffapt/code-runner/blob/master/LICENSE.txt\n[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge\u0026logo=linkedin\u0026colorB=555\n[linkedin-url]: https://linkedin.com/in/proffapt\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fproffapt%2Fcode-runner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fproffapt%2Fcode-runner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fproffapt%2Fcode-runner/lists"}