Shelles

Welcome to my growing collection of shell scripts. Each piece is designed to either 1. automate a task I perform often, 2. cut corners in the CLI, or 3. experiment with odd features I find interesting. There are quirky net tools and productivity enhancers in the mix, so you are sure to find something useful.

They are all written in Bash and have a certain number of dependencies. Gum, for instance, is necessary for every script to function, due to its interactive features primarily, but also their aesthetic counterpart.

Before I present the pieces, consider that some features may fail on MacOS and WSL is recommended for Windows users.

beam.sh

>> share files ephemerally via ngrok

Dependencies

• curl
• fzf
• gum
• jq
• ngrok
• python3
• qrencode
• ss

Workflow

1. Multi-file selection fzf
2. Automatic ngrok tunnel
3. QR code generation
4. Auto-cleanup

In addition to the dependencies above, beam.sh requires an authtoken, which can be obtained from here and defined as an environment variable, like so:

NGROK_AUTHTOKEN="your_ngrok_authtoken"

bjay.sh

>> sightly password/pin gen

Dependencies

• gum
• wl-copy

Workflow

1. Customize char sets and length
2. Pick from presets
3. Automatic copy to clipboard
4. Self-destruct with timer

goxi.sh

>> glamorous oxipng wrapper

Dependencies

• fzf
• gum
• oxipng

Workflow

1. Directory browsing with fzf
2. Multi-file selection interface
3. Progress reporting and stats
4. Detailed output
5. Safe optimization setts

grasp.sh

>> a fuzzy memory extension for the cli

Dependencies

• fzf
• gum
• jq

Workflow

1. Store commands with descriptions and tags
2. Search easily with fzf
3. One-key copy to clipboard
4. Edit and delete ops

obsera.sh

>> voguish IP geolocator

Dependencies

• curl
• dig
• gum
• jq
• nslookup

Workflow

1. 195+ countries with FLAGS!
2. Domain resolution
3. Private IP detection + public IP fallback
4. Comprehensive location data (ISP, ASN, timezone)
5. Automatic copy to clipboard

wallopt.sh

>> local wallpaper picker with preview

Dependencies

• gum
• hyprctl (hopefully you're on hyprland lol)

Workflow

1. Wallpaper list from local directory
2. Image preview in the terminal
3. Clean hyprland integration

reqx.sh, wallpull.sh, warp.sh, and more to come...

Enjoy!