Hilbish/README.md

93 lines
3.5 KiB
Markdown
Raw Normal View History

<div align="center">
2021-10-12 20:01:17 +00:00
<img src="./assets/hilbish-flower.png" width=128><br>
<img src="./assets/hilbish-text.png" width=256><br>
<blockquote>
2021-10-12 20:01:17 +00:00
🌺 The flower shell. A comfy and nice little shell for Lua users and fans!
</blockquote>
2021-10-12 20:01:17 +00:00
<p align="center">
<img alt="GitHub commit activity" src="https://img.shields.io/github/commit-activity/m/Rosettea/Hilbish?style=flat-square">
<img alt="GitHub commits since latest release (by date)" src="https://img.shields.io/github/commits-since/Rosettea/Hilbish/latest?style=flat-square">
<img alt="GitHub contributors" src="https://img.shields.io/github/contributors/Rosettea/Hilbish?style=flat-square"><br>
<a href="https://github.com/Rosettea/Hilbish/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22"><img src="https://img.shields.io/github/issues/Hilbis/Hilbish/help%20wanted?style=flat-square&color=green" alt="help wanted"></a>
<a href="https://github.com/Rosettea/Hilbish/blob/master/LICENSE"><img alt="GitHub license" src="https://img.shields.io/github/license/Rosettea/Hilbish?style=flat-square"></a>
<a href="https://discord.gg/3PDdcQz"><img alt="Discord" src="https://img.shields.io/discord/732357621503229962?color=blue&style=flat-square"></a>
2021-04-08 18:55:37 +00:00
</p>
</div>
2021-03-20 05:45:17 +00:00
Hilbish is a Unix-y shell which uses Lua for scripting. Things like the prompt,
general configuration and such are done with Lua.
For interactive use, it uses a library to run sh which works on all
platforms Hilbish can be compiled for. It can also act as a Lua REPL if you want
it to be.
# Screenshots
<div align="center">
<img src="gallery/default.png"><br><br>
<img src="gallery/terminal.png"><br><br>
<img src="gallery/pillprompt.png">
</div>
# Installation
## Prebuilt binaries
Go [here](https://nightly.link/Rosettea/Hilbish/workflows/build/master) for
builds on the master branch.
## AUR
2021-12-20 02:41:04 +00:00
[![AUR maintainer](https://img.shields.io/aur/maintainer/hilbish?logo=arch-linux&style=flat-square)](https://aur.archlinux.org/packages/hilbish)
2021-10-12 20:01:17 +00:00
Arch Linux users can install Hilbish from the AUR with the following command:
2021-06-09 22:18:23 +00:00
```sh
yay -S hilbish
```
2021-12-20 02:41:04 +00:00
[![AUR maintainer](https://img.shields.io/aur/maintainer/hilbish?logo=arch-linux&style=flat-square)](https://aur.archlinux.org/packages/hilbish-git)
2021-10-12 20:01:17 +00:00
Or from the latest `master` commit with:
2021-06-09 22:18:23 +00:00
```sh
yay -S hilbish-git
```
## Nixpkgs
Nix/NixOS users can install Hilbish from the central repository, nixpkgs, through the usual ways.
2021-10-18 02:36:42 +00:00
If you're new to nix you should probably read up on how to do that [here](https://nixos.wiki/wiki/Cheatsheet).
## Manual Build
### Prerequisites
- [Go 1.17+](https://go.dev)
2021-05-20 23:21:28 +00:00
#### Build
First, clone Hilbish. The recursive is required, as some Lua libraries
are submodules.
```sh
2021-10-12 20:01:17 +00:00
git clone --recursive https://github.com/Rosettea/Hilbish
2021-03-20 05:45:17 +00:00
cd Hilbish
2021-10-12 20:01:17 +00:00
go get -d ./...
```
2021-10-12 20:01:17 +00:00
To build, run:
2021-03-20 05:45:17 +00:00
```
2021-10-12 20:01:17 +00:00
make dev
```
2021-06-09 22:16:04 +00:00
2021-10-12 20:01:17 +00:00
Or, if you want a stable branch, run these commands:
```
2021-10-12 20:01:17 +00:00
git checkout $(git describe --tags `git rev-list --tags --max-count=1`)
make build
```
2021-03-20 05:45:17 +00:00
2021-10-12 20:01:17 +00:00
After you did all that, run `sudo make install` to install Hilbish globally.
2021-10-12 20:01:17 +00:00
# Contributing
Any kind of contributions to Hilbish are welcome!
Read [CONTRIBUTING.md](CONTRIBUTING.md) before getting started.
**Thanks to everyone below who's 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).*
2021-03-20 05:45:17 +00:00
# License
Hilbish is licensed under the [MIT license](LICENSE).
[Images and assets](assets/) are licensed under CC-BY-SA 4.0