https://github.com/unixorn/jpb.zshplugin
ZSH plugin to load some of my tools.
https://github.com/unixorn/jpb.zshplugin
hacktoberfest hacktoberfest2020 shell-scripts zgen zsh zsh-plugin zsh-plugins
Last synced: about 1 month ago
JSON representation
ZSH plugin to load some of my tools.
- Host: GitHub
- URL: https://github.com/unixorn/jpb.zshplugin
- Owner: unixorn
- License: apache-2.0
- Created: 2014-02-24T02:15:16.000Z (about 11 years ago)
- Default Branch: main
- Last Pushed: 2025-03-10T17:54:34.000Z (about 1 month ago)
- Last Synced: 2025-03-10T18:38:42.393Z (about 1 month ago)
- Topics: hacktoberfest, hacktoberfest2020, shell-scripts, zgen, zsh, zsh-plugin, zsh-plugins
- Language: Shell
- Homepage:
- Size: 369 KB
- Stars: 23
- Watchers: 2
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://opensource.org/license/Apache-2.0)
[](https://actions-badge.atrox.dev/unixorn/jpb.zshplugin/goto?ref=main)
# jpb.zshplugin
This is a ZSH plugin usable with [zgenom](https://github.com/jandamm/zgenom) and other frameworks compatible with [oh-my-zsh](https://github.com/ohmyzsh/ohmyzsh) to easily load some of my tool scripts.
This contains miscellaneous tool scripts and aliases that are not specific enough for one of my more targeted ZSH plugins.
These scripts are personal collection of helper scripts, so while I try to make them useful for other people, they're in a constant state of flux as I make them suit my needs.
## Table of Contents
- [Installing](#installing)
- [Antigen](#antigen)
- [Zgenom](#zgenom)
- [Without using a framework](#without-using-a-framework)
- [Credits](#credits)
- [Other useful ZSH plugins](#other-useful-zsh-plugins)
## Installing
### Antigen
add `antigen bundle unixorn/jpb.zshplugin` to your `.zshrc`
### Zgenom
add `zgenom load unixorn/jpb.zshplugin` to your `.zshrc` with your other `zgenom load` commands.
### Without using a framework
1. `git clone` this repository, then add its bin directory to your `$PATH`.
2. Add `source /path/to/here/jpb.plugin.zsh` to your `.zshrc` file.
The scripts in this collection don't actually require you to be using ZSH as your login shell, they're being distributed as a plugin compatible with [oh-my-zsh](https://github.com/ohmyzsh/ohmyzsh) because it's convenient for me.
## Credits
| Script | Original Source | Description |
| ------ | --------------- | ----------- |
| `$` | Jordan Sissel's [dotfiles](https://github.com/jordansissel/dotfiles/blob/master/.zshrc) | A shim so that pasting a command example with a leading `$` will just work instead of failing. |
| `ansi2html` | Mislav Marohnić's [dotfiles](https://github.com/mislav/dotfiles) | Convert terminal color ANSI escape sequences to HTML. |
| `ascii-bar` | Wookayin's [dotfiles](https://github.com/wookayin/dotfiles/blob/master/bin/ascii-bar) | Draw an ascii bar figure from the percentage value read from `STDIN` |
| `bindiff` | [email protected] | Hexdumps two files and diffs the output |
| `change-extension` | ? | Changes file extensions |
| `clean-whiteboard-picture` | [https://gist.github.com/lelandbatey/8677901](https://gist.github.com/lelandbatey/8677901) | Cleans up pictures of whiteboards and pumps up contrast |
| `cursor-hide` | [email protected] | Hides cursor in iTerm2 |
| `cursor-show` | [email protected] | Enables cursor visibility in iTerm2 if a program exits without setting it visible again |
| `datauri` | Alrra's [dotfiles](https://github.com/alrra/dotfiles/blob/main/src/shell/bash_functions) | Converts a file to a data URI |
| `dedupe-in-order` | `awk` oneliner | Use awk to dedupe a file, outputting the lines in order. Unlike `uniq`, doesn't only dedupe adjacent lines. |
| `diff-summary` | Gary Bernhardt's [dotfiles](https://github.com/garybernhardt/dotfiles/blob/main/bin/gn) | Prints a summary of piped diff files or `git diff` output |
| `dumpdns` | ? | Dump DNS records for a domain |
| `exiftool` | [email protected] | Shows or removes a file's exif metadata |
| `explainshell` | [email protected] | Uses https://explainshell.com to explain shell commands. |
| `extractFromRPM` | [email protected] | Extracts files from an rpm |
| `find-in-files` | [Boost Your Command Line Productivity With fzf](https://betterprogramming.pub/boost-your-command-line-productivity-with-fuzzy-finder-985aa162ba5d) | Combines `ripgrep` and `fzf` |
| `fix-zsh-history` | [email protected] | Fixes a corrupted `.zsh_history` file |
| `get-distro` | [https://github.com/blueyed/dotfiles/](https://github.com/blueyed/dotfiles/blob/master/usr/bin/get_distro) | Dumps info about the distro of the linux system you're on |
| `get-site-cert` | ? | Download the SSL cert from a site |
| `gxpr` | [brutasse's dotfiles](https://github.com/brutasse/dotfiles/blob/master/bin/gxpr). | Uses Google and or Wolfram Alpha to evaluate expressions. Requires `URI::Escape` to be installed with `cpan`. |
| `headers` | Zach Holman's [dotfiles](https://github.com/holman/dotfiles/blob/master/bin/headers) | Gets the HTTP headers from a server |
| `hex-to-bin` | [email protected] | Converts a hexstring to a binary stream |
| `html2markdown` | [https://github.com/realpython/python-scripts/](https://github.com/realpython/python-scripts/blob/master/scripts/14_html_to_markdown.sh) | Convert all HTML files in a single directory to Markdown |
| `http_debug` | | Dump debug info for a URL |
| `http_headers` | | Dump http headers for a URL |
| `human-path` | coffeeops slack `#commandline-fu` channel | Print `$PATH` with one entry per line to make it easier for humans to tell if something is missing |
| `human-time` | | Converts integer seconds into human-understandable time. `human-time 88000` will print `1d 26m 40s` |
| `iflip` | [twirrim/iflip](https://github.com/twirrim/iflip/blob/master/iflip) | Tableflips a text string |
| `ipaddresses` | [email protected] | Dumps all the ip addresses for the host |
| `is-remote-session` | [email protected] | Exits 0 if you're in an `ssh` remote session, 1 otherwise |
| `jira` | [email protected] | Opens a jira ticket from the command-line |
| `jmemstat` | [majk1's shellrc](https://github.com/majk1/shellrc/blob/master/utils/jmemstat.sh) | Displays a memory information summary for a java process |
| `json2yaml` / `json-to-yaml` | [email protected] | Converts JSON to YAML |
| `jsondiff` | ? | Diff JSON files and cope with key-order differences by processing with json.tool |
| `lineprof` | Mislav Marohnić's [dotfiles](https://github.com/mislav/dotfiles) | Annotates each line of input with the number of milliseconds elapsed since the last line. Useful for figuring out slow points of output-producing programs. |
| `local-ip-address` | [email protected] | Print local IP v4 address |
| `local-ipv6-address` | [email protected] | Print local IP v6 address |
| `ls-open-ports` | [email protected] | List open ports |
| `ls-sockets` | [email protected] | List open sockets |
| `ls-tcp-sockets` | [email protected] | List open tcp sockets |
| `ls-udp-sockets` | [email protected] | List open udp sockets |
| `lsof-unlinked` | [ludios/ubuntils/](https://github.com/ludios/ubuntils/blob/master/bin/lsof-unlinked) | List all open files (but not mapped files) that have been unlinked. |
| `memcached-tool` | Brad Fitzpatrick | stats/management tool for memcached |
| `memcached-top` | [http://code.google.com/p/memcache-top/](http://code.google.com/p/memcache-top/) | Dumps basic `memcached` stats similarly to `top` |
| `middle` | [@Hefeweizen](https://github.com/Hefeweizen) | Snips lines out of the the middle of a file and dumps them to stdout |
| `mtr-url` | ? | Parses hostname from a URL, then does a `mtr` to it. |
| `murder` | [Anonymous Gist](https://gist.github.com/anonymous/32b1e619bc9e7fbe0eaa#!/bin/bash) | Takes a list of PIDs and ends the processes through increasingly rude means. |
| `name-window` | [email protected] | Names a terminal window/tab by sending escape codes. |
| `nanotime` | [email protected] | Times a process and gives you results in milliseconds |
| `newscript` | [email protected] | Creates a new script from a template and does `chmod 755` on it. |
| `openports` | [email protected] | Wraps `ss` and makes a prettier list of open ports. |
| `pidpwd` | [email protected] | Find the pwd of a given pid. Only works on linux since it requires `/proc` |
| `pjson` | [https://coderwall.com/](https://coderwall.com/p/hwu5uq?i=9&p=1&q=sort%3Ascore+desc&t%5B%5D=zsh) | Prettify json files |
| `plot` | katef's [gist](https://gist.github.com/katef/fb4cb6d47decd8052bd0e8d88c03a102) | Draw a graph in the terminal |
| `port-listeners-ipv{4,6}` | [email protected] | Show what programs are listening to a given port |
| `port-listened-by}` | [email protected] | Show what programs are listening to a given port |
| `pydoc` | Hangops Slack | Look something up on [docs.python.org](https://docs.python.org) and opens it in your default browser |
| `random-password` | [email protected] | Generate a random password. If no argument, assume 32 character length |
| `randsleep` | [email protected] | Sleep a random number of seconds |
| `relocate-virtualenv` | Gary Josack's [scripts](https://github.com/gmjosack/scripts) repository | This is a simple script to clean up links and references in a python virtualenv that has been relocated. |
| `remote-packet-capture` | [email protected] | Run `tcpdump` on a remote host and pipe it to local `wireshark` |
| `retry` | [email protected] | Re-run a command until it exits successfully. Waits `$DELAY` seconds between attempts. |
| `seq` | Dave Taylor's [blog](https://www.askdavetaylor.com/step_through_count_numeric_values_bash_shell_script/) | Generates integer values from low...high similar to `range` in better programming languages |
| `snag-dl` | ? | Moves the most recent file in `~/Downloads` into the current directory |
| `solo` | Timothy Kay's `solo` script | Prevents a program from running more than one copy at a time. |
| `ssh-remove-known-host` | [email protected] | Helper script to remove a known hosts entry. I can never remember the command for removing a known_hosts entry, and the new format makes it more pain in the ass than just editing and searching for the ip/hostname. |
| `steal` | [email protected] | Helper for quickly resetting ownership of files you created with the wrong userid |
| `strip-ansi-codes` | [email protected] | Strips the ANSI codes from STDIN. Makes grepping through things like jenkins logs considerably less painful |
| `tableflip` | [hangops](https://hangops.slack.com) slack | Prints a tableflip animation. |
| `title-text` | [email protected] | Set the terminal title in any application (like iTerm 2 or Terminal on macOS) that supports VT100 escape sequences. |
| `urldecode` | [email protected] | Decode an url string |
| `urlencode` | [email protected] | Encode a string to an url parameter |
| `vbox` | [email protected] | Opens VirtualBox |
| `wtfis` | [email protected] | Looks something up on [cheat.sh](http://cheat.sh) |
| `yaml2json` / `yaml-to-json` | [email protected] | Converts yaml to json |
| `yq` | [email protected] | Run `yq` in a container to minimize the things directly installed locally |
## Other useful ZSH plugins
I also maintain the [awesome-zsh-plugins](https://github.com/unixorn/awesome-zsh-plugins) list of ZSH frameworks, plugins and themes.