depau/shcrt
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity

Update README with into on WinZenity and emojis

Browse source
This commit is contained in:
Davide Depau 2019-09-10 01:25:34 +02:00
parent 2e966378ca
commit 50dee0105b
1 changed files with 24 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

29
README.md
View file

@ -49,19 +49,38 @@ At the time of writing, supported modes are:
- `dialog`: ncurses terminal based GUI (good for WSL) - `dialog`: ncurses terminal based GUI (good for WSL)
- `whiptail`: another terminal based GUI (good for WSL) - `whiptail`: another terminal based GUI (good for WSL)
- `none`: uses internal shell-based EBG GUI, which uses `echo` and `read` - `none`: uses internal shell-based EBG GUI, which uses `echo` and `read`
- `zenity`, `yad`, `gtkdialog`, `xdialog`: GTK-based GUIs for GNOME-based desktops - `zenity`: GTK-based GUI for GNOME-base desktops, with a Windows port (see below)
- `yad`, `gtkdialog`, `xdialog`: other GTK-based GUIs for GNOME-based desktops
- `kdialog`: Qt5-based GUI for KDE or Qt-based desktops - `kdialog`: Qt5-based GUI for KDE or Qt-based desktops
Needless to say, unless you're using `none` the desired GUI back-end needs to be installed. Needless to say, unless you're using `none`, the desired GUI back-end needs to be installed.
The script includes an experimental wrapper for [native Windows Zenity](https://github.com/kvaps/zenity-windows/) on WSL. If you're using WSL and you don't want to use a terminal-based GUI, you need an X11 server such as [VcXsrv](https://sourceforge.net/projects/vcxsrv/).
It displays but it doesn't actually work, probably due to Windows line endings needing to be fixed. Otherwise you can use Zenity for Windows.
#### Zenity on Windows
The script includes an experimental wrapper for [native Windows Zenity](https://github.com/maravento/winzenity) on WSL.
To make it work, you need to:
- Download WinZenity: https://github.com/maravento/winzenity
- Place it somewhere in your Windows drive (i.e. `C:\Program Files\zenity.exe`)
- Add this line to your `~/.shcrtrc`:
```bash
alias zenity.exe="'/mnt/c/path/to/your/zenity.exe'"
# for example
alias zenity.exe="'/mnt/c/Program Files/zenity.exe'"
```
- Notice how you need to put double quotes to take into account for the spaces in the file path.
### Emojis ### Emojis
```bash ```bash
export emojis=YOUR_CHOIC export emojis=YOUR_CHOICE
``` ```
Force enable/disable emojis. Emojis are enabled by default on GNU/Linux, and disabled on WSL.
If you're using a custom terminal that supports emojis you can force-enable them on Windows too.
- `auto`: always display emojis on GNU/Linux, disabled on WSL because of crappy terminal - `auto`: always display emojis on GNU/Linux, disabled on WSL because of crappy terminal
- `yes`, `no`: force enable/disable - `yes`, `no`: force enable/disable