voidrice/.scripts/SCRIPTS.md

# Directory of Scripts

I keep all my user-created scripts here in `~/.scripts/`.  Scripts are sorted
into sub-directories for easy management, and all are seamlessly added to
`$PATH` with the command below in `~/.profile`:

```
export PATH="$(du $HOME/.scripts/ | cut -f2 | tr '\n' ':')$PATH"
```

## `statusbar/`

For modules used in i3blocks.

### `battery`

i3blocks module. Shows available power remaining with icon indicating battery
status. Colors indicate different levels of charge.

### `clock`

Shows time and date. If clicked, brings up calender or coming calcuse events.

### `cpu`

Shows CPU temperature. If clicked, shows most processor-intensive processes.

### `help`

Module which appears as a question mark. Brings up readme if clicked.

### `internet`

Shows whether machine is connected to wifi and ethernet. If clicked, brings up `nmtui`.

### `mailbox`

i3blocks module for use with mutt-wizard. Shows unread mail and if
`mailsync.sh` is running.

### `mem`

Shows memory usage. If clicked, shows most memory-intensive processes.

### `music`

i3blocks module. Shows current song; if paused, name will be grayed and italic.

### `mpdupdate`

A daemon running by default that will update the i3mpd block on mpd change.

### `news`

Shows unread newsboat articles. Brings up newsboat or refreshes RSS feeds.

### `pacpackages`

i3blocks module. Detects new installable upgrades. Only works if you use
cronjobs to automatically sync repositories.

### `popupgrade`

Called by clicking on the update icon if there are new packages. Spawns a `yay`
upgrade of the main Arch repos and AUR packages, updates the i3blocks module
once complete.

### `torrent`

i3blocks module. Shows torrents idle (⌛️), downloading (⬇️) or
finished (🌱).

### `volume`

i3blocks module. Shows volume percentage or mute notification.

### `weather`

i3blocks module. Gets weather forcast from wttr.in and returns today's
precipitation chance (☔), daily low (❄️) and daily high (☀️).

## `cron/`

For scripts meant to be cronjobs. None are active by default on LARBS.

### `checkup`

If connected to internet, syncs package repositories and downloads (but does
not install) any potential updates. Gives `notify-send` notifications of when
it is active since other `pacman` install commands cannot be run
simultaneously.

You may need to grant your user the ability to run `pacman -Syyuw --noconfirm`
without a password (done in `/etc/sudoers`).

### `cronbat`

Gives a dunst notification if the battery is less than 25%.

### `crontog`

Not actually a cronjob, but just turns off/on all user cronjobs.

### `getforecast`

Updates the weather forecast. This is automatically run by `weather` if there hasn't been a new forecast today.

### `newsup`

Updates newsboat RSS feeds if connected to internet. Will also display a
newspaper update icon on i3blocks if it has not be user disabled.

## `tools/`

Scripts intended to be run either manually by the user or linked to a shortcut
in vim or another program.

### `compiler`

Compiles a markdown, R markdown or LaTeX document with the approriate command.
Will also run `make && sudo make install` if in a `config.h` file.  Otherwise
it will create a sent presentation.  This can be thought of a general output
handler.  I have it bound to `<leader>c` in vim.

### `dmenuhandler`

Give this script a url and it will offer dmenu options for opening it. Used by
`newsboat` and some other programs as a link handler.

### `extract`

Will detect file type of archive and run appropriate extraction command.

### `getbib`

Use crossref.org to automatically detect bibtex entry of a .pdf. Attempts to
search for the .pdf's DOI. Returns nothing if none detected.

### `getkeys`

Get the LARBS documentation on what bindings exist for main programs.

### `linkhandler`

The automatic link handler used by `newsboat` and other programs. Urls of video
sites or of video files are opened in `mpv`, images are downloaded/opened in
`feh`, music files are downloaded with `wget` and all other urls are opened in
the default browser.

### `lmc`

A music controller that simplifies music/audio management and improves the
interface with i3blocks. Check inside to see what it does. This is what i3
audio/music commands run by default. If you use a difference music system or
ALSA, you can change this script rather than changing all the shortcuts in
different places.

### `note`

Give this script some text/a message as an argument. It will print it to the
terminal, and if `dunst` is running, display a notification.

### `opout`

"Open output", opens the corresponding `.pdf` file if run on a `.md`, `.tex` or
`.rmd` file, or if given an `.html` file, will open it in the browser.  Bound
to `<leader>p` in my vim config to reveal typical output.

### `pauseallmpv`

Pauses all mpv instances by sending the `,` key to each. Used by several
scripts, but can be used alone as well. It will not pause an audio only mpv
instance. If you know how to add a hack to do this, feel free to PR it or email
me an addition.

### `remaps`

Remaps capslock to escape when pressed and super/mod when held. Maps the menu
key to super as well. Runs the US international keyboard setup. If you want
another keyboard setup, edit this fine.

### `shortcuts`

For updating bash and ranger shortcuts. Reads `~/.key_directories` and
`~/.key_files` for pairs of keypresses and directories and files, then
autoproduces bash aliases and ranger shortcuts for them which output to
`~/.shortcuts` and `~/.config/ranger/shortcuts.conf` respectively. These are
read automatically by my bash and ranger configs. You don't have to run this
script manually though, as it's run by vim whenever you edit one of the
`~/.key_*` files.

### `speedvid`

Speed up a given video file (`$1`) by a given ammount (`$2`).

### `tpb`

Search Pirate Bay for the certain search terms given as arguments.

### `texclear`

Remove all `.tex` related build files. This is run by my vim when I stop
editing any `.tex` file.

### `transadd`

The mimeapp default script for handling torrent magnet links. Starts
`transmission-daemon` if not running and adds the link.

## `i3cmds`

These are scripts linked to bindings in i3. They typically perform
user-interface actions or involve dmenu.

### `bottomleft` and `bottomright`

Makes the currently selected window float in one of the bottom corners of the
screen. `bottomleft` is bound to `mod+B` by default.

### `camtoggle`

Starts/kills /dev/video0 webcam. Placed in bottom right by default.

### `ddspawn`

This is the script called to create, show and hide the dropdown tmux terminal
mapped to `mod+u`, but also the dropdown calculator mapped to `mod+a`. Give the
script an argument that is a script the window will run. If a window does not
already exist, `ddspawn` creates it, if it does, `ddspawn` will toggle its
visibility. The the script itself for usage.

### `displayselect`

Select which displays to use. Bound to `mod+F3`.

### `dmenumount`

Gives a dmenu prompt for mounting USB drives or Android devices. Bound to
`mod+F9`. Will do nothing if none are available.

### `dmenurecord`

Gives a list of recording commands: `audio`, `video` and `screencast` (both) in
dmenu for selection. Bound to `mod+PrintScreen` by default. Should be killed by
`killrecording`.

### `dmenuumount`

Unmount a mounted non-essential partition. Bound to `mod+F10`. Will do nothing
if none are mounted. It will not try to unmount essential system partitions.

### `dmenuunicode`

Shows a searchable dmenu prompt of emoji characters. The selected emoji is
copied to the system clipboard, while its character code is copied to primary
selection (middle mouse button).

### `dropdowncalc`

The dropdown calculator script called by `ddspawn` and bound to `mod+a` by
default. Will run an R calculator if installed, otherwise python.

### `ducksearch`

Show a dmenu prompt and search for the inputed text in DuckDuckGo. Can take
bangtags as expected, i.e. typing in `!aw Arch Linux` will search the Arch Wiki
for "Arch Linux" or `!yt Luke Smith` will search YouTube for "Luke Smith", etc.

### `i3resize`

A script that allows intuitive resizing of windows. Mapped to `mod+Y/U/I/O`.

### `killrecording`

End a recording started by `dmenurecord` the proper way without file trucation
or lingering background processes, mapped to `mod+Delete` by default.

### `lockscreen`

The screen locker. Gives a confirm prompt and if user says yes, all audio will
be paused and the screen will be distorted and locked and screen will soon time
out. User must insert password to unlock. Mapped to `mod+x` by default.

### `newspod`

A silly line that has a script all to itself due to i3's idiosyncracies. Starts
`newsboat`, if `newsboat` cannot open because of another instance being open,
opens `podboat`.

### `prompt`

Gives a Yes/No prompt to a question given as an argument. Used by numerous
bindings like `mod+shift+x`, `mod+shift+backspace` and `mod+shift+escape`.

### `samedir`

Opens a terminal window in the same directory as the window currently
selection. Bound to `mod+shift+enter`.

### `td-toggle`

Gives a dmenu prompt to start `transmission-daemon` if not running, or the kill
it if it is. Obviously you need `transmission-cli` installed for this to work.
Mapped to `mod+F7` by default.

### `tmuxdd`

The startup script for the dropdown terminal (toggleable with `mod+u`). Either
attaches to an existing tmux session or begins a new one.

### `toggletouchpad`

As the name suggests, turns off TouchPad if on, and turns it on if off.
Requires `xf86-input-synaptics`. If your laptop has a special button for this,
it will be mapped by default.

### `tutorialvids`

A dmenu prompt that gives some options of tutorial videos to watch. Bound to
`mod+shift+e`.