summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--.scripts/SCRIPTS.md140
1 files changed, 112 insertions, 28 deletions
diff --git a/.scripts/SCRIPTS.md b/.scripts/SCRIPTS.md
index 42a866e..1a92c81 100644
--- a/.scripts/SCRIPTS.md
+++ b/.scripts/SCRIPTS.md
@@ -1,142 +1,226 @@
# Directory of Scripts
## `audio`
+
The audio recording script run by `dmenurecord` (bound to `mod+Print`).
## `bottomleft`
-Makes the currently selected window float in the bottom left of screen. Bound to `mod+B`.
+
+Makes the currently selected window float in the bottom left of screen. Bound
+to `mod+B`.
## `camtoggle`
+
Starts/kills /dev/video0 webcam. Placed in bottom right by default.
## `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.
+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.
## `crontog`
+
Turns off/on all user cronjobs.
## `displayselect`
+
Select which displays to use. Bound to `mod+F3`.
## `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.
+
+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.
## `dmenumount`
-Detect available partitions with `lsblk` and offer to mount them. Bound to `mod+F9`. Will do nothing if none are available.
+
+Detect available partitions with `lsblk` and offer to mount them. 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.
+
+Gives a list of recording commands: `audio`, `video` and `screencast` (both) in
+dmenu for selection.
## `dmenuumount`
-Unmount a mounted non-essential partition. Bound to `mod+F10`. Will do nothing if none are mounted.
+
+Unmount a mounted non-essential partition. Bound to `mod+F10`. Will do nothing
+if none are mounted.
## `dropdowncalc`
-The command initially run in the `math` window (toggeable with `mod+a`). Runs `r` if available, else `python`.
+
+The command initially run in the `math` window (toggeable with `mod+a`). Runs
+`r` if available, else `python`.
## `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.
+
+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.
## `i3battery`
-i3blocks module. Shows available power remaining with icon indicating battery status. Colors indicate different levels of charge.
+
+i3blocks module. Shows available power remaining with icon indicating battery
+status. Colors indicate different levels of charge.
## `i3mail`
-i3blocks module for use with mutt-wizard. Shows unread mail and if `mailsync.sh` is running.
+
+i3blocks module for use with mutt-wizard. Shows unread mail and if
+`mailsync.sh` is running.
## `i3mpd`
+
i3blocks module. Shows current song; if paused, name will be grayed and italic.
## `i3mpdupdate`
+
A daemon running by default that will update the i3mpd block on mpd change.
## `i3pacman`
-i3blocks module. Detects new installable upgrades. Only works if you use cronjobs to automatically sync repositories.
+
+i3blocks module. Detects new installable upgrades. Only works if you use
+cronjobs to automatically sync repositories.
## `i3resize`
+
A script that allows intuitive resizing of windows. Mapped to `mod+Y/U/I/O`.
## `i3torrent`
-i3blocks module. Shows torrents idle (⌛️), downloading (⬇️) or finished (🌱).
+
+i3blocks module. Shows torrents idle (⌛️), downloading (⬇️) or
+finished (🌱).
## `i3volume`
+
i3blocks module. Shows volume percentage or mute notification.
## `i3weather`
-i3blocks module. Gets weather forcast from wttr.in and returns today's precipitation chance (☔), daily low (❄️) and daily high (☀️).
+
+i3blocks module. Gets weather forcast from wttr.in and returns today's
+precipitation chance (☔), daily low (❄️) and daily high (☀️).
+
+## `i3wifi`
+
+A modified version of the i3blocks wifi module. Clicked, it brings up wifi-menu
+and also appears when there is no wifi connection.
## `kb-lights.py`
+
A Python 3 script which will increase or decrease keyboard lights when given
either a `+` or `-` argument.
## `killrecording`
+
End a recording started by `dmenurecord` the proper way.
## `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.
+
+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.
+
+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.
## `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.
+be paused and the screen will be distorted and locked and screen will soon time
+out. User must insert password to unlock.
## `musstuff`
+
Some old notes and commands on deleted music shortcuts.
## `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.
+`.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.
## `polybar_launch`
-For `polybar` users. Launches `polybar` on every screen. Should be run in the i3 config.
+
+For `polybar` users. Launches `polybar` on every screen. Should be run in the
+i3 config.
## `popweather`
+
The script called by clicking on the i3 weather module. Brings up the forecast
from `http://wttr.in` and waits for input to prevent immediate closing of
spawned window.
## `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`.
+
+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`.
## `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.
+
+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.
## `samedir`
-Opens a terminal window in the same directory as the window currently selection. Bound to `mod+shift+enter`.
+
+Opens a terminal window in the same directory as the window currently
+selection. Bound to `mod+shift+enter`.
## `screencast`
+
A script for `dmenurecord`. Records default audio and the screen.
+## `shortcuts.sh`
+
+For updating bash and ranger shortcuts. Reads `~/.scripts/folders` and
+`~/.scripts/configs` for pairs of keypresses and directories and configfiles,
+then autoproduces bash aliases and ranger shortcuts for them. See the
+`README.md` at
+[https://github.com/LukeSmithxyz/shortcu-sync](https://github.com/LukeSmithxyz/shortcu-sync)
+for the specifics.
+
## `texclear`
-Remove all `.tex` related build files. This is run by my vim when I stop editing any `.tex` file.
+
+Remove all `.tex` related build files. This is run by my vim when I stop
+editing any `.tex` file.
## `tmuxinit`
-The startup script for the dropdown terminal (toggleable with `mod+u`). Either attaches to an existing tmux session or begins a new one.
+
+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`.
## `tpb`
+
Search Pirate Bay for the certain search terms given as arguments.
## `tutorialvids`
-A dmenu prompt that gives some options of tutorial videos to watch. Bound to `mod+shift+e`.
+
+A dmenu prompt that gives some options of tutorial videos to watch. Bound to
+`mod+shift+e`.
## `video`
+
A script for `dmenurecord`. Records the screen with no audio.