Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ariary/wslight
Unix command translator on Windows cmd
https://github.com/ariary/wslight
bash cmd linux pentest pentest-tool translate windows wsl
Last synced: 2 days ago
JSON representation
Unix command translator on Windows cmd
- Host: GitHub
- URL: https://github.com/ariary/wslight
- Owner: ariary
- Created: 2021-08-12T12:18:04.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2021-09-27T07:16:43.000Z (over 3 years ago)
- Last Synced: 2024-11-11T03:36:22.002Z (2 months ago)
- Topics: bash, cmd, linux, pentest, pentest-tool, translate, windows, wsl
- Language: Go
- Homepage:
- Size: 63.5 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# WSLight
Unix command translator on Windows cmd (CLi)
----
🔦 Idea
|
💺 Installation
|
🚀 Usage
|
📝 Commands
|
💭Limits/improvements
----
## 🔦 Idea
**Aim?**
Providing equivalent of bash (Unix cmd) on Window
> Powershell & cmd already exist!
Exactly, but if you are not very comfortable with it and you have more references with unix commands
> [WSL](https://itsfoss.com/install-bash-on-windows/) already exists and provides more utilities!
Yes but it requires admin privileges to enable it.
If the command you want to launch is not available [see](#limitsimprovements)
**Use cases?**
- CTF, pentest etc with remote shell on windows device
- Learn some `cmd.exe` command (by enabling debug with `+x`)
## 💺 Installation
Clone the repo and download the dependencies locally:
```
git clone https://github.com/ariary/wslight.git
make before.build
```
To build wslight :
```
make build.wslight
```
## 🚀 Usage
Move `wslight.exe` binary on the windows machine on which you have a shell
### Launch the cli
```
wslight.exe
```
### Launch equivalent of unix command in `cmd.exe`
Once the cli is launched
```
>
```
As simple as that!
see [available commands](#-commands--features) or Type `help` to get available commands
### Activate debug mode
Debug mode is useful to see which command is in fact launch on cmd (to see the translation). It is useful to debug your behaviour or just learn some command
```
> +x
```
Disable (by default) it with (`-x`)
## 📝 Commands & Features
- `wslight` could understand pipe commands
List of available commands
| Unix command | flag accepted|
|:--|:--|
| hostname ||
| pwd||
| rm |-r,-f|
| cp|-r |
|grep| -R, -i|
|ls|-l, -R, -a|
|tree||
|env||
|cd| -, ~|
*flags must be separated with spaces to be correctly parsed correctly*
If the command you want to launch is not available [see](#limitsimprovements)
## 💭Limits/improvements
**⚠️ Only a set of Unix command is available. I will provide more as things progress. Do not hesitate to let me know which one you will be interested in**
*(Or a make a PR it is **simple**, just add a line in the `suggestions` slice (`cmd/wslight/main.go`) explaining what is the command, and apply the command behavior in the `Translate` function (in `pkg/command/translate.go`)*