{"id":24905940,"url":"https://github.com/renzocastillo/wslscriptrunner","last_synced_at":"2026-04-11T14:36:03.898Z","repository":{"id":275040058,"uuid":"924876491","full_name":"renzocastillo/WSLScriptRunner","owner":"renzocastillo","description":"🚀 WSL Script Runner - A Flow Launcher plugin that lets you instantly find and execute WSL shell scripts from anywhere in Windows. Seamlessly integrates your Linux scripts into your Windows workflow with fuzzy search, VS Code integration, and context menu actions.","archived":false,"fork":false,"pushed_at":"2025-03-25T20:49:53.000Z","size":1650,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-25T21:31:09.689Z","etag":null,"topics":["developer-tools","flow-launcher","flow-launcher-plugin","linux","productivity","shell-scripts","windows","wsl"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/renzocastillo.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}},"created_at":"2025-01-30T20:01:45.000Z","updated_at":"2025-03-25T20:49:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"3e5b4e58-3d47-45af-b6db-ca053372d736","html_url":"https://github.com/renzocastillo/WSLScriptRunner","commit_stats":null,"previous_names":["renzocastillo/wslscriptrunner"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/renzocastillo%2FWSLScriptRunner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/renzocastillo%2FWSLScriptRunner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/renzocastillo%2FWSLScriptRunner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/renzocastillo%2FWSLScriptRunner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/renzocastillo","download_url":"https://codeload.github.com/renzocastillo/WSLScriptRunner/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245931755,"owners_count":20695959,"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":["developer-tools","flow-launcher","flow-launcher-plugin","linux","productivity","shell-scripts","windows","wsl"],"created_at":"2025-02-02T00:26:15.064Z","updated_at":"2025-12-30T23:21:54.248Z","avatar_url":"https://github.com/renzocastillo.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WSL Script Runner for Flow Launcher\n\nA Flow Launcher plugin that allows you to quickly find and execute your WSL shell scripts from anywhere in Windows.\n\n![WSL Script Runner Demo](Images/app.png)\n\n## Features\n\n- 🔍 Quickly find your shell scripts using fuzzy search\n- ⚡ Execute WSL scripts directly from Flow Launcher\n- 📝 Open scripts in VS Code for editing\n- 📁 Configurable scripts directory\n- 🖱️ Right-click menu for additional actions\n- 🚀 No need to open WSL terminal manually\n\n## Installation\n\n### Method 1: Flow Launcher Plugin Manager\n```\npm install WSL Script Runner\n```\n\n### Method 2: Manual Installation\n1. Download the latest release from the [releases page](https://github.com/YourRepo/releases)\n2. Extract the zip file to `%APPDATA%\\FlowLauncher\\Plugins`\n3. Restart Flow Launcher\n\n## Requirements\n\n- Windows 10/11 with WSL installed\n- Flow Launcher\n- VS Code with WSL extension (for editing scripts)\n\n## Usage\n\n1. Type `wsr` in Flow Launcher to activate the plugin\n2. Start typing to search for your scripts\n3. Press Enter to execute the selected script\n4. Right-click or Shift+Enter for additional options:\n   - Open script in editor (VS Code)\n   - Open scripts directory\n   - Configure scripts directory\n\n## Configuration\n\nBy default, the plugin looks for scripts in `~/scripts` in your WSL home directory. You can change this by:\n\n1. Type `wsr` in Flow Launcher\n2. Right-click on any result\n3. Select \"Configure Scripts Directory\"\n4. Edit the `settings.json` file that opens\n\nExample `settings.json`:\n```json\n{\n    \"scripts_dir\": \"~/my-scripts\"\n}\n```\n\n## Development\n\n### Prerequisites\n- Python 3.8 or higher\n- Windows 10/11 with WSL\n- Flow Launcher\n\n### Setup\n1. Clone the repository\n```bash\ngit clone https://github.com/renzocastillo/WSLScriptRunner\n```\n\n2. Create a symbolic link in Flow Launcher's plugin directory\n```powershell\nmklink /D \"%APPDATA%\\FlowLauncher\\Plugins\\Flow.Launcher.Plugin.WSLScriptRunner\" \"path\\to\\your\\clone\"\n```\n\n### Project Structure\n```\nFlow.Launcher.Plugin.WSLScriptRunner/\n├── main.py              # Main plugin code\n├── plugin.json          # Plugin metadata\n├── README.md           # This file\n├── Images/\n│   └── app.png         # Plugin icon\n└── lib/\n    └── flowlauncher.py # Flow Launcher interface\n```\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request. By contributing to this project, you agree to license your work under the GNU General Public License v3.0.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## License\n\nThis project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details. This means you are free to use, modify, and distribute this software, but any derivative work must also be licensed under the GPL v3.0.\n\n## Acknowledgments\n\n- Flow Launcher team for creating an amazing launcher\n- WSL team for making Linux integration possible on Windows\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frenzocastillo%2Fwslscriptrunner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frenzocastillo%2Fwslscriptrunner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frenzocastillo%2Fwslscriptrunner/lists"}