# Some useful bash scripts
Here are some little bash scripts I coded along the way.

You can install all of them or just some individually. Be sure to check the script description in this README for additional instructions. (This could be critical. Please,
read them.)

Generally, all of these scripts can be copied into your user's binary folder:
```shell
$ cp script_name ~/.local/bin/
$ chmod +x ~/.local/bin/script_name
```
You can check whether your shell looks for binaries in this path by running:
```shell
$ echo $PATH | grep ~/.local/bin
```
If there's text, you're good to go. If not, edit your shell's init file and add the following line:
```sh
export PATH=~/.local/bin:$PATH
```

## Table of contents
- battery-warn
- hotspot
- update-cargo-clif
- mount-nextcloud
- check-system-update

## battery-warn
> Periodically query the battery level and play a sound if the level is low.

**This script does not provide a help text!**

I originally coded this because my display driver broke and I only had the console. Unfortunately the console doesn't come with any way to notify me when my battery is dying.

You can run `battery-warn` in the background:
```shell
$ battery-warn &
```

It would be useful to add this line to your shell's init file if you need it regularly.

To check the battery level yourself run this:
```shell
$ battery-warn check
```

## hotspot
> Quickly start a wifi hotspot using NetworkManager.

**This script does not provide a help text!**

Starting/stopping the simple hotspot is as easy as:
```shell
$ hotspot
```
This will also show the SSID, password, and a QR-code.

In order to reduce power consumption it will also disable Wifi when disabling the hotspot. This behavior can be changed inside of the script (`turn_off_wifi=0`). Or you can
only turn the hotspot off manually:
```shell
$ hotspot off
```

If you want to be sneaky, you can start a hidden hotspot with a different randomly generated password each time:
```shell
$ hotspot random
```

To show the SSID, password, and QR-code again without changing the hotspot:
```shell
$ hotspot show
```

## update-cargo-clif
> Download and install the latest build artifact for `rustc_codegen_cranelift`.

**This script does not provide a help text!**

This script also needs `jq` to be installed.

Before using this script be sure to replace the `$username` and `$access_token` variables with your own GitHub username and an [access
token](https://github.com/settings/tokens/) with scope `workflow`. (This will also enable the scope `repo`.)

After the initial setup, run without arguments to download the latest GitHub Action build artifact for linux and install to /opt/cargo-clif:
```shell
$ update-cargo-clif
```
It will symlink the new `cargo` command to `/usr/local/bin/cargo-clif` (i.e. use with `cargo-clif` when building your projects).

The script uses `sudo` internally, so there is no need to run `sudo update-cargo-clif`.

## mount-nextcloud
> Mount your Nextcloud account automatically using `gio` and `pinentry`.

**This script does not provide a help text!**

Before using this script be sure to replace the `$server` and `$user` variables with your Nextcloud server and account.

If you are not using GNOME, replace `pinentry-gnome3` with the correct `pinentry` binary for your desktop environment.

You _could_ run `mount-nextcloud` manually (e.g. without a graphical UI in the console):
```shell
$ mount-nextcloud
```
But I recommend installing the autostart file. Assuming you are in the directory where you downloaded this repo:
```shell
$ cp mount-nextcloud.desktop ~/.config/autostart/
```

## check-system-update
> Update AUR and Flatpak packages directly and install Arch Linux packages from the repos at next boot.

**This script does not provide a help text!**

This script only works on distributions based on Arch Linux. You will also need to install `systemd-system-update-pacman` from the AUR (e.g. with `yay`):
```shell
$ yay -S systemd-system-update-pacman
```

Because the script downloads the packages into a special cache directory, you have to patch the updater script from that package. Assuming you are in the directory where
you downloaded this repo:
```shell
$ sudo patch /usr/lib/systemd-system-update-pacman/perform-system-update{,.patch}
```

To check for any updates - be it from the AUR, Flatpak, or the repos - run:
```shell
$ check-system-update
```
This will update AUR packages and Flatpaks directly (i.e. now), and repo packages later at the next time you boot up you system, so you can go on with your work like nothing
happened. If you have any critical system packages (e.g. drivers, kernels, etc.) installed from the AUR, installing them now could be a problem though. In order to check
which packages come from non-repo sources, run:
```shell
$ pacman -Qm
```

The script uses `sudo` internally, so there is no need to run `sudo check-system-update`.

## Contribution
Issues and Pull Requests are welcome. Please describe your problems or feature requests as detailed as possible.