mirror of https://github.com/alexanderepstein/Bash-Snippets synced 2018-11-08 02:59:35 +01:00

#Bash #Snippets

Find a file

Alex Epstein 26889fc6cc Check for openssl in crypt tool		2017-07-02 20:08:08 -04:00
crypt	Check for openssl in crypt tool	2017-07-02 20:08:08 -04:00
currency	Updating to 1.6.0	2017-07-01 00:09:57 -04:00
geo	Updating to 1.6.0	2017-07-01 00:09:57 -04:00
movies	Updating to 1.6.0	2017-07-01 00:09:57 -04:00
short	Updating to 1.6.0	2017-07-01 00:09:57 -04:00
stocks	Updating to 1.6.0	2017-07-01 00:09:57 -04:00
taste	Updating to 1.6.0	2017-07-01 00:09:57 -04:00
weather	Updating to 1.6.0	2017-07-01 00:09:57 -04:00
changelog.md	Updating to 1.6.0	2017-07-01 00:09:57 -04:00
CODE_OF_CONDUCT.md	Create CODE_OF_CONDUCT.md	2017-06-26 22:02:55 -04:00
CONTRIBUTING.md	Fix this	2017-06-28 00:08:43 -04:00
install.sh	Updating to 1.6.0	2017-07-01 00:09:57 -04:00
ISSUE_TEMPLATE.md	Adding issue template	2017-06-27 13:15:03 -04:00
LICENSE	Initial commit	2017-06-26 17:55:08 -04:00
README.md	Update README.md	2017-07-01 10:39:02 -04:00
uninstall.sh	Adding geo install and uninstall, fixing incorrect echo in uninstall	2017-06-30 12:47:19 -04:00

Bash-Snippets

A collection of small bash scripts for heavy terminal users with no dependencies

license

All of these scripts have only been tested on OSX and Linux and are not recommended for use with Windows

Weather

Provides a 3 day forecast

With no arguments it will grab the weather for your location as determined by you ip

With arguments you can pass in a city or country and get the weather in that area

Also can show the current moon phase

Stocks

Provides information about a certain stock symbol

Geo

Provides date for wan, lan, router, dns, mac, and ip geolocation

Written by: Jake Meyer

Currency

Converts currency based on realtime exchange rates

If you want to bypass to guided input you can pass in 3 arguments and it will run from there ex.currency [baseCurrency] [exchangeToCurrency] [amountBeingExchanged] so a valid use case would be currency USD EUR 12.35

Encryption & Decryption

A wrapper for openssl that allows for quickly encrypting and decrypting files

crypt -e [original file] [encrypted file] # encrypts files
crypt -d [encrypted file] [output file] # decrypts files

Encryption Details

Uses AES 256 level encryption
Key is salted before creation
Password is never in plain text, and OpenSSL generates key based on password
Data is encrypted in Base64, so it can be used as plain text in an email. (Not usually necessary if attached as a file)

Tested With .pdf, .txt, .docx, .doc, .png, .jpeg

CAUTION Make sure to use different filenames, otherwise your file will be overwritten!

Movies

Quick search that grabs relevant information about a movie

Taste

Recommendation engine that provides three similar items like the supplied item

Also can provide information on a given item

Valid items are: shows, books, music, artists, movies, authors, games

Needs an API Key

To get an API key visit https://tastedive.com/account/api_access
After getting the API key run the following command: export TASTE_API_KEY="yourAPIKeyGoesHere"
If issues occur first try setting the API key without quotations marks

Short

Gets the link that is being masked by a url shortner

API's Used

To get location based on ip address: ipinfo.io
To get and print weather based on a location: wttr.in
To grab the stock information in JSON format: alphavantage.co
To grab the latest exchange rate between currencies: api.fixer.io
To grab information on movies: omdbapi.com
To grab recommendations based on an item: tastedive.com
To determine masked link behind url shortner: x.datasig.io

Inspired by: Ruby-Scripts

Installing

First clone the repository: git clone https://github.com/alexanderepstein/Bash-Snippets
Then cd into the cloned directory: cd Bash-Snippets
Git checkout to the latest stable release git checkout v1.6.0
Run the guided install script with

./install.sh

this will let you choose which scripts to install

Install all the scripts

./install.sh all

Install an individual script

./install.sh stocks

Updating

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 Ex.

stocks update

stocks -u

This will clone the repository and install the new versions of scripts that were installed, if you didn't install a certain tool this script will not install the new version of that tool.

Uninstalling

If you don't have the Bash-Snippets folder anymore clone the repository: git clone https://github.com/alexanderepstein/Bash-Snippets
cd into the Bash-Snippets directory: cd Bash-Snippets

To uninstall all scripts

./uninstall.sh

To uninstall individual scripts

Ex. Weather

cd weather
./uninstall.sh

Donate

If this project helped you in any way and you feel like buying a broke college kid a cup of coffee

License

MIT License

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.

README.md