BASH-SNIPPETS(1)

📦 version 1.23.0, in nixos 26.05, nixpkgs unstable

💖 NAME 💖

okay so bestie, first things first: this page is bash-snippets(1) — a collection of small bash scripts for heavy terminal users. that's it, that's the whole vibe. a whole lil squad of tiny bash scripts for people who basically live in their terminal 🫶

like, if you're the kind of person whose tmux has tabs, this is your page. slay. let's go ✨

🎀 TOOLS 🎀

🧠 Cheat

Description: cheatsheets for quick information about multiple programming languages, plus terminal commands. it's giving "I forgot the syntax but I refuse to open a browser" 💅

Usage: cheat [flags] [command] or cheat [flags] [programming language] [subject]

  • -s — does a search for the last argument rather than looking for an exact match 🔍
  • -i — case insensitive search (we love a forgiving queen)
  • -b — word boundaries in search
  • -r — recursive search
  • -u — update Bash-Snippet Tools
  • -h — show the help
  • -v — get the tool version

🌟 Special Pages

  • hello — describes building the hello world program written in the language
  • list — lists all cheatsheets related to the previous arg; if there's none, it lists all cheatsheets
  • learn — shows a learn-x-in-minutes language cheat sheet, perfect for getting started with the language (literally the icon of "just start" 👑)
  • 1line — a collection of one-liners in this language
  • weirdness — a collection of examples of weird things in this language 💀

🌸 Examples

  • cheat rust hello
  • cheat -r -b -i go
  • cheat julia Functions
  • cheat -i go operators

☁️ Cloudup

Description: backs up a user's github repositories to your bitbucket account. with no flags, cloudup will guide you through backing up a single repository 🦋

Usage: cloudup [flags] or cloudup [flags] [listOfGHRepoNamesSplitBySpaces]

  • -p — upload the repositor(y)(ies) as private to bitbucket (you must have private repo ability on bitbucket for this one, no cap)
  • -a — backup all github repositories
  • -s — only backup repositories that you have created (no forks) — heads up, this only works in conjunction with the -a flag
  • -t — backup the repository with a timestamp added to the repostiory name (this will always create a new unique bitbucket repo)
  • -u — update Bash-Snippet Tools
  • -h — show the help
  • -v — get the tool version

🌸 Examples

  • cloudup
  • cloudup -p -a
  • cloudup -p nameOfRepo1 nameOf Repo2
  • cloudup nameOfRep

🔐 Crypt

Description: a wrapper around openssl that facilitates encrypting and decrypting files. keeping your secrets secret, periodt 🤫

Usage: crypt [flag] [inputFile] [outputFile]

  • -e — encrypt the inputFile and store it in the outputFil
  • -d — decrypt the inputFile and store it in the outputFil
  • -u — update Bash-Snippet Tools
  • -h — show the help
  • -v — get the tool version

🌸 Examples

  • crypt -e mySecretFile.txt myEncryptedFile.jpg (change the filetype so the default program is incorrect 👀)
  • crypt -d myEncryptedFile.jpg thisIsNowDecrypted.txt (change the filetype back so now the default program is correct ✨)

🪙 CryptoCurrency

Description: a realtime cryptocurrency converter. with no flags it will pull down the latest stats of the top 10 cryptos. main character energy for your portfolio 📈

Usage: cryptocurrency or cryptocurrency [flag] or cryptocurrency [flag] [arg]

  • -o — utilize the old functionality of the tool
  • -f — fiat currency for conversions
  • -u — update Bash-Snippet Tools
  • -h — show the help
  • -v — get the tool version

🌸 Examples

  • cryptocurrency -o
  • cryptocurrency -f eur

💱 Currency

Description: a realtime currency converter. with no flags it will guide you through the currency exchange, hand-holding included 🫶

Usage: currency or currency [flag] or currency [base] [exchangeTo] [amount]

  • -u — update Bash-Snippet Tools
  • -h — show the help
  • -v — get the tool version

💸 Supported Currencies

all 32 of them, iconically:

AUD BGN BRL CAD CHF CNY CZK DKK EUR GBP HKD HRK
HUF IDR ILS INR JPY KRW MXN MYR NOK NZD PHP PLN
RON RUB SEK SGD THB TRY USD ZAR

🌸 Examples

  • currency EUR USD 12.35
  • currency

🌍 Geo

Description: provides quick access for wan, lan, router, dns, mac, and ip geolocation data. it knows where you are. always. 🙈

Usage: geo [flag]

  • -w — returns WAN IP
  • -l — returns LAN IP(s)
  • -r — returns Router IP
  • -d — returns DNS Nameserver
  • -m — returns MAC address for interface. ex. eth0
  • -g — returns Current IP Geodata

🌸 Examples

  • geo -g
  • geo -wlrdgm eth0

Custom Geo Output => [all] [query] [city] [region] [country] [zip] [isp]

Example: geo -a 8.8.8.8 -o city,zip,isp

  • -o [options] — returns specific geodata
  • -a [address] — for a specific ip in -s
  • -v — returns version
  • -h — returns help screen
  • -u — updates Bash-Snippets

🎤 Lyrics

Description: fetch lyrics for a certain song. karaoke night but make it terminal 🎶

Usage: lyrics [flags] or tool [-a] [arg] [-s] [arg]

  • -a — artist of the song to fetch lyrics for
  • -s — song of the artist to fetch lyrics for
  • -f — export the lyrics to file rather than outputting to stdout
  • -u — update Bash-Snippet Tools
  • -h — show the help
  • -v — get the tool version

🌸 Examples

  • lyrics -a logic -s run it
  • lyrics -a logic -s run it -f ~/runItLyrics.txt

😹 Meme

Description: a lightning fast meme generator. lightning. fast. ⚡

Usage: tool [flags] or tool [flags] [arguments]

  • -u — update Bash-Snippet Tools
  • -h — show the help
  • -f — choose the output filename
  • -v — get the tool version

🌸 Examples

  • meme -f dogeMeme

🎬 Movies

Description: provides relevant information about a certain movie. letterboxd could never 🍿

Usage: movies [flag] or movies [movieToSearch]

  • -u — update Bash-Snippet Tools
  • -h — show the help
  • -v — get the tool version
  • -d — show detailed information

🌸 Examples

  • movies Argo
  • movies Inception

🍎 Newton

Description: performs numerical calculations all the way up to symbolic math parsing. math girlies rise 🧮✨

Usage: newton [operation] [expression] or newton [flag]

  • -u — update Bash-Snippet Tools
  • -h — show the help
  • -v — get the tool version

Valid Symbols:

  • + add
  • - subtract
  • [ left parenthesis (you must use brackets, bash has a bultin for parenthesis)
  • ] right parenthesis (you must use brackets, bash has a bultin for parenthesis)
  • * multiply
  • / divide
  • ^ power
  • : between the range of left and right side (only for area under curve)
  • ~ parameter on right side (only for area, tangent line and log)

🌸 Examples

  • newton simplify [[2x]+7]*[4x]
  • movies derive x+2x
not me pointing out that the second example literally says movies 💀 that's what the page says, bestie, I don't make the rules.

🕵️ Pwned

Usage: pwned [email]

Description: checks where an email account has been breached. it's giving "your data is out there and we're gonna tell you where" 😭

  • -u — update Bash-Snippet Tools
  • -h — show the help
  • -v — get the tool version

🌸 Examples

  • pwned emailtocheck@email.com

🔳 Qrify

Usage: qrify [stringtoturnintoqrcode]

Description: converts strings or urls into a qr code. little squares, big power 🎀

  • -u — update Bash-Snippet Tools
  • -m — enable multiline support
  • -f — save the QRCode to a file
  • -d — decode the QR code from a PNG/GIF/JP(E)G file
  • -h — show the help
  • -v — get the tool version

🌸 Examples

  • qrify this is a test string
  • qrify -m two \n lines
  • qrify -f fileNameHere Insert what you want to encode here
  • qrify github.com # notice no http:// or https:// this will fail
  • qrify -d fileName.png

🔗 Short

Description: unmasks shortended urls. detective mode: activated 🔍💅

Usage: short [shortURL] or short [flag]

  • -e — expand the following URL
  • -s — shorten the following URL
  • -u — update Bash-Snippet Tools
  • -h — show the help
  • -v — get the tool version

🌸 Example

🔒 Siteciphers

Description: checks the available ciphers for the SSL of an https site. cipher check, but make it cute 🦋

Usage: siteciphers [flag] or siteciphers [optionalDFlag] [website]

  • -u — update Bash-Snippet Tools
  • -h — show the help
  • -v — get the tool version
  • -d — set the delay between requests sent to the site (default is 1 sec)

🌸 Examples

  • siteciphers github.com
  • siteciphers -d 0.75 google.com

📊 Stocks

Description: finds the latest information on a certain stock. finance bestie reporting for duty 📈👑

Usage: stocks [flag] or stocks [company/ticker]

  • -u — update Bash-Snippet Tools
  • -h — show the help
  • -v — get the tool version

🌸 Examples

  • stocks AAPL
  • stocks Tesla

🎨 Taste

Description: a recommendation engine that provides 3 similar items based on some input topic. Taste also has the ability to provide information on the item of interest. supports: shows, books, music, artists, movies, authors, games 🎧📚

Usage: taste [flag] [item]

  • -i — get more information on similar items
  • -s — get information on the item itself
  • -u — update Bash-Snippet Tools
  • -h — show the help
  • -v — get the tool version

🌸 Examples

  • taste -i Kendrick Lamar
  • taste Catcher in the Ry
  • taste -s Red Hot Chili Peppers

✅ Todo

Description: a simplistic commandline todo list. productivity era 🎀✨

Usage: todo [flags] or todo [flags] [arguments]

  • -c — clear all the current tasks
  • -r — remove the following task number
  • -g — get the current tasks
  • -a — add the following task
  • -u — update Bash-Snippet Tools
  • -h — show the help
  • -v — get the tool version

🌸 Examples

  • todo -a My very first task
  • todo -r 1
  • todo -g
  • todo -c

📤 Transfer

Description: quickly transfer files from the command line. drop it and go 💨

Usage: transfer [flags] or transfer [flag] [args] or transfer [filePathToUpload]

  • -d — download a single file
    • first arg: output file directory
    • second arg: file url id
    • third arg: file name
  • -o — onetime file upload
  • -u — update Bash-Snippet Tools
  • -h — show the help
  • -v — get the tool version

🌸 Examples

  • transfer ~/fileToTransfer.txt
  • transfer ~/firstFileToTransfer.txt ~/secondFileToTransfer.txt # upload multiple files at once
  • transfer -d ~/outputDirectory fileID fileName
  • transfer -o ~/fileToTransfer.txt

🌦️ Weather

Description: provides a 3 day forecast on your current location or a specified location. with no flags, Weather will default to your current location. checking the vibes, meteorologically 🌈

Usage: weather or weather [flag] or weather [country] or weather [city] [state]

  • weather [optionalLocation] [i][M] — get weather in imperial units, optional M means windspeed in m/s
  • weather [optionalLocation] [m][M] — lowercase m gets weather in metric units, optional M means windspeed in m/s
  • weather [Moon] — grabs the phase of the moon 🌙
  • -u — update Bash-Snippet Tools
  • -h — show the help
  • -v — get the tool version

okay that's this batch of tools bestie — and there's literally more where that came from, so keep reading 👑

Okay so, examples — because seeing it in action is literally the whole vibe check:

  • weather
  • weather Paris m
  • weather Tokyo
  • weather Moon
  • weather mM

🌈 Ytview

Description: Search and play youtube videos right from the terminal. Yes bestie, your terminal is a media player now, we love a multitasking icon. 💅

Usage: ytview [flag] [string] or ytview [videoToSearch]

  • -s — searches youtube for you 🔍
  • -c — shows the latest videos of a channel, so you can stalk your faves (respectfully) 👀
  • -u — Update Bash-Snippet Tools
  • -h — Show the help
  • -v — Get the tool version

Examples:

  • ytview -s Family Guy Chicken Fight
  • ytview -c Numberphile

🔄 Updating

Okay so here's the cute part: with any of the installed tools you can automate the update by running it with the -u option or passing in update as the arguments. Two ways to do the exact same slay:

  • stocks update

or

  • stocks -u

This will clone the repository and install the new versions of scripts that were installed. And here's the important bit — if you didn´t install a certain tool, this script will not install the new version of that tool. So no surprise guests in your $PATH, periodt. ✨

🧹 Uninstalling

If you don´t have the Bash-Snippets folder anymore, clone the repository first:

git clone https://github.com/alexanderepstein/Bash-Snippets`

Then cd into the Bash-Snippets directory:

cd Bash-Snippets

Then, to go through a guided uninstall:

  • ./uninstall.sh

It walks you through it, so you're not out here guessing. We love a guided moment. 🫶

👑 AUTHOR

Alexander Epstein Github: https://github.com/alexanderepstein

💜 Contributors

📜 License

MIT License

Copyright (c) 2017 Alex Epstein

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Fr fr, that's a wrap — this whole page comes from the Bash-Snippets source, version ff, dated December 2017, in the BASH-SNIPPETS(1) manual. Go forth and be iconic with it 🦋💖
📦 where this page comes from