Hilbish/README.md

119 lines
3.4 KiB
Markdown
Raw Normal View History

<div align="center">
<h1>Hilbish</h1>
<blockquote>
🎀 a nice lil shell for lua people made with go and lua
2021-04-08 18:55:37 +00:00
</blockquote><p align="center">
<a href="https://github.com/Hilbis/Hilbish/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22"><img src="https://img.shields.io/github/issues/Hilbis/Hilbish/help%20wanted?color=green" alt="help wanted"></a>
<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg"></a>
</p>
</div>
2021-03-20 05:45:17 +00:00
Hilbish is an interactive Unix-like shell written in Go, with the config
and other code written in Lua.
It is sort of in a stable state currently, usable as a daily shell,
but there may still be breaking changes in Lua modules.
# Screenshots
<div align="center">
<img src="gallery/default.png"><br><br>
<img src="gallery/terminal.png"><br><br>
<img src="gallery/pillprompt.png">
</div>
2021-03-21 22:19:26 +00:00
# Links
- **[Documentation](https://github.com/Hilbis/Hilbish/wiki)**
- **[Gallery](https://github.com/Hilbis/Hilbish/discussions/36)** - See
more screenshots of Hilbish in action
2021-03-21 22:19:26 +00:00
# Installation
2021-03-20 05:45:17 +00:00
**NOTE:** Hilbish is currently only officially supported and tested on Linux
### Prebuilt binaries
Binaries are provided for the latest commit.
**Note that these use Hilbiline, not readline, and may be missing functionality
(moving the cursor, proper unicode support and backspace working properly)**
Click on the checkmark (or x) near the commit hash, then details for your platform
<br><img src="https://modeus.is-inside.me/dyr8UGGq.png"><br>
Then click on the artifacts drop down, and download artifact for your platform,
like what is highlighted in the screenshot.
<br><img src="https://modeus.is-inside.me/KJ0Puceb.png"><br>
### Manual Build
#### Prerequisites
2021-04-04 17:15:55 +00:00
- [Go 1.16](https://go.dev)
- GNU Readline
On Fedora, readline can be installed with:
```
sudo dnf install readline-devel
```
On Debian/Ubuntu and distros based on them, it can be installed with:
```
sudo apt install libreadline-dev
```
2021-03-20 05:45:17 +00:00
2021-04-29 14:02:04 +00:00
On OpenSUSE, it can be installed with:
```
sudo zypper install readline-devel
```
2021-05-20 23:21:28 +00:00
#### Build
First, clone Hilbish:
```sh
git clone --recursive https://github.com/Hilbis/Hilbish
2021-03-20 05:45:17 +00:00
cd Hilbish
2021-05-20 23:21:28 +00:00
# If you want the latest stable release, run this following command
git checkout $(git describe --tags `git rev-list --tags --max-count=1`)
```
2021-05-20 23:21:28 +00:00
And get dependencies and build:
```sh
2021-06-03 23:18:51 +00:00
go get -d all
make dev
2021-05-20 23:21:28 +00:00
# If you want to use latest stable release,
make build
2021-05-20 23:21:28 +00:00
# or want to use Hilbiline,
make hilbiline
2021-03-20 05:45:17 +00:00
```
2021-05-20 23:21:28 +00:00
#### Install
`sudo make install`
2021-05-03 10:20:52 +00:00
Alternatively, if you use Arch Linux, you can compile Hilbish with an **(unofficial)** AUR package:
```sh
yay -S hilbish
```
2021-05-03 10:20:52 +00:00
If you want the latest and greatest, you can install and compile from latest git commit:
```sh
yay -S hilbish-git
```
### Uninstall
```sh
sudo make uninstall
```
2021-03-20 05:45:17 +00:00
# Contributing
Any kind of contributions to Hilbish are welcome!
Make sure to read [CONTRIBUTING.md](CONTRIBUTING.md) before getting started.
### Special Thanks To
Everyone here who has contributed:
<a href="https://github.com/Hilbis/Hilbish/graphs/contributors">
<img src="https://contrib.rocks/image?repo=Hilbis/Hilbish" />
</a>
*Made with [contributors-img](https://contrib.rocks).*
### Credits
- [This blog post](https://www.vidarholen.net/contents/blog/?p=878) which
is how Hilbish now inserts a newline even if output doesn't have one.
2021-03-20 05:45:17 +00:00
# License
Hilbish is licensed under the MIT license.
[Read here](LICENSE) for more info.