{"id":15042373,"url":"https://github.com/benzaria/runbash","last_synced_at":"2025-07-28T05:33:12.364Z","repository":{"id":255268467,"uuid":"843596917","full_name":"benzaria/RunBash","owner":"benzaria","description":"Run Bash and Linux Binaries on Windows","archived":false,"fork":false,"pushed_at":"2025-06-24T14:56:17.000Z","size":1242,"stargazers_count":14,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-24T15:48:35.318Z","etag":null,"topics":["bash","bash-script","binary","explorer","extension","linux","linux-binary","shell","shell-script","tool","windows"],"latest_commit_sha":null,"homepage":"","language":"Batchfile","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/benzaria.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,"zenodo":null}},"created_at":"2024-08-16T21:55:02.000Z","updated_at":"2025-06-24T14:56:21.000Z","dependencies_parsed_at":"2024-08-29T00:26:10.325Z","dependency_job_id":"938c4b53-ea56-4fbc-a24d-05c908cade6c","html_url":"https://github.com/benzaria/RunBash","commit_stats":null,"previous_names":["benzaria/runbash"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/benzaria/RunBash","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benzaria%2FRunBash","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benzaria%2FRunBash/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benzaria%2FRunBash/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benzaria%2FRunBash/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/benzaria","download_url":"https://codeload.github.com/benzaria/RunBash/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benzaria%2FRunBash/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267468390,"owners_count":24092334,"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","status":"online","status_checked_at":"2025-07-28T02:00:09.689Z","response_time":68,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["bash","bash-script","binary","explorer","extension","linux","linux-binary","shell","shell-script","tool","windows"],"created_at":"2024-09-24T20:47:11.429Z","updated_at":"2025-07-28T05:33:12.359Z","avatar_url":"https://github.com/benzaria.png","language":"Batchfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RunBash by Benzaria\r\n![](https://img.shields.io/badge/Windows-blue) ![](https://img.shields.io/badge/Linux-white?logo=linux\u0026logoColor=black) ![](https://img.shields.io/badge/Batch-blue) ![](https://img.shields.io/badge/Bash-white?logo=gnubash\u0026logoColor=black) ![](https://img.shields.io/badge/-blue?logo=c\u0026logoColor=white) ![](https://img.shields.io/github/repo-size/benzaria/runbash) \u003c!--[](https://img.shields.io/github/downloads/benzaria/runbash/total)--\u003e ![](https://img.shields.io/badge/RunBash_size-300KB-green) \u003c!--![](https://img.shields.io/github/size/benzaria/runbash/RunBash.exe) ![]() ![]() --\u003e\r\n\r\n## Overview\r\n\u003cimg src=\"https://raw.githubusercontent.com/benzaria/RunBash/main/images/bash.ico\" width=\"110px\" align=\"left\" style=\"margin-top: -5px\"\u003e\r\n\r\n**RunBash** is a handful utility that enables you to run your Bash Scripts and Linux Binarys directly from your Windows system, seamlessly integrating Linux commands into your Windows environment. Whether through Windows Explorer, Command Prompt, and PowerShell, RunBash offers a versatile and efficient way to execute Bash scripts and Binarys without the need for a separate terminal.\r\n\r\n## Table of Contents\r\n - [Features](#features)\r\n - [Getting Started](#getting-started)\r\n - [Installation](#installation)\r\n - [Usage](#usage)\r\n - [Arguments](#arguments)\r\n - [Details](#details)\r\n\r\n\r\n## Features\r\n- **Direct Seamless Execution:** Run Bash scripts and Linux binarys from Windows Explorer or the Command Prompt with ease.\r\n- **Linux Command Integration:** Easily link and manage Linux commands within your Windows environment.\r\n- **Context Menu Plugins:** Add Multiple Option to the context menu from: Open, Run as Root, Run as Admin, Edit, and New Bash File. [Details](#details)\r\n- **Customizable SourceCode:** add Any code you want to the main batchfile (\\ProgramData\\RunBash\\RunBash.bat) to adjust the execution into your needs.  \r\n- **Customizable Execution:** Use various parameters to control output, error handling, and execution behavior.\r\n- **Root/Admin Access:** Optionally run scripts with Root or Admin privileges.\r\n- **Error and Output Handling:** Fine-tune what outputs and errors are displayed or hidden.\r\n\u003e [!NOTE]\r\n\u003e The Batchfile Can Not Run on it's Own it needs the main exe ahead of it  \r\n\r\n## Getting Started\r\n### Prerequisites\r\n- **WSL (Windows Subsystem for Linux)** is required for RunBash to function. Please ensure that WSL is installed on your system.  \r\n  - Quick install : `wsl --install \u0026\u0026 shutdown /r` optional : `wsl --set-default-version 2` if supported !\r\n\r\n### Installation\r\n 1. Clone the Repository `Git Clone https://github.com/benzaria/RunBash.git` and build.  \r\nor  \r\n 2. Download the Latest Release [RunBash v1.3](https://github.com/benzaria/RunBash/archive/refs/tags/1.3.zip).  \r\n\r\n### Usage\r\nRunBash can be invoked directly from the Command Prompt. Here are the basic usage instructions:\r\n\r\nFirst run `setup.bat` it will do all the work to make sure RunBash is setup perfectly.  \r\n\\- else run `RunBash -Install \u0026 RunBash -GetBin` for Basic setup !  \r\n\r\n```\r\nUsage:\r\n RunBash [Wsl-Arguments] [RunBash-Arguments] \u003cFile-Path\u003e [File-Arguments]  \r\nor after setting up \r\n \u003cFile-Path\u003e [File-Arguments] [RunBash-Arguments]\r\n```\r\n\r\n#### Example:\r\n```\r\n RunBash -Std 1 -Exit 1 -Root C:\\Users\\benz\\sleepsort.sh\r\nor after setting up\r\n C:\\Users\\benz\\sleepsort.sh -Std 1 -Exit 1 -Root\r\n```\r\n\r\n### Arguments\r\n- **[Wsl-Arguments]:** Standard arguments passed to WSL. For more info, run `wsl --help`.\r\n- **[RunBash-Arguments]:**\r\n  - `-Install \u003cinstall-path\u003e \u003ceditor-path\u003e`: Install ContextMenu and RunBash Plugins to Explorer and Cmd. [Details](#details)\r\n  - `-GetBin \u003cdirs\u003e`: Gather all executable files from specified Linux directories and link them to Windows.\r\n  - `-AddBin \u003cname1\u003e \u003ccmd-para-1\u003e ; \u003cname2\u003e \u003ccmd-para-2\u003e ;...`: Add custom commands from Linux to Windows.\r\n  - `-RemBin \u003cname\u003e`: Remove specified or all linked commands from Windows.\r\n  - `-NoWait`: Do not wait for script execution to finish.\r\n  - `-Root`: Run the script as the root user.\r\n  - `-Std \u003c0-2\u003e`: Control output display:\r\n    - `0`: No output\r\n    - `1`: Display Standard output only\r\n    - `2`: Display Standard error only\r\n  - `-Exit \u003c0-2\u003e`: Control exit message display:\r\n    - `0`: No exit message\r\n    - `1`: Display error code on exit\r\n    - `2`: Display success message on exit\r\n\r\n#### Help\r\nFor a detailed guide on using RunBash, run: `RunBash -Help`\r\n\r\n### Details\r\n![Explorer/Context Menu](/images/ContextMenu.png)\r\n![RunBash in Action](/images/RunBash%20in%20Action%20(1).png)\r\n![RunBash in Action](/images/RunBash%20in%20Action%20(2).png)\r\n\u003e [!IMPORTANT]\r\n\u003e Make sure to run either the commands `runbash -addbin \u003cname\u003e \u003cpkg\u003e` or `runbash -getbin` after installing a new package  \r\n\u003e :bulb: Coming soon : Automatic Link after a new package install\r\n\r\n![RunBash in Action](/images/RunBash%20in%20Action%20(3).png)\r\n\r\n## LICENSE\r\nRunBash is licensed under the [MIT License](/LICENSE)\r\n\r\n## Contribution\r\nFeel free to contribute by submitting issues or pull requests. Any enhancements or bug fixes are welcome!\r\n\r\n## Acknowledgments\r\nSpecial thanks to the creators of WSL for making tools like RunBash possible.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenzaria%2Frunbash","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbenzaria%2Frunbash","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenzaria%2Frunbash/lists"}