Shorten-anonymize-url NPM

shorten-anonymize-url

Commandline Usage

Installation

$ npm install --global shorten-anonymize-url

Usage

$ shorten-anonymize-url "<url>"

⚠️ Enclose URLs in quotes to handle special characters like as question marks ⚠️

Show Help and Options

$ shorten-anonymize-url --help

Example

$ shorten-anonymize-url "https://www.google.de/?gfe_rd=cr&ei=WDE4We-3BcfPXr7dpdgH&gws_rd=ssl"
>> http://bit.ly/2sglJKg

Right-Click URL Shortener (macOS only)

screenshot-macos

The module includes a global Service for macOS Automator, as well as an automated installation and uninstallation routine.

Features

The global shortener service does the following:

It takes any marked url within macOS,
shortens and anonymizes it,
copies the resulting shortened and anonymized URL to the macOS clipboard.

This enables global url shortening and anonymizing.

Compatibility

The global nature of macOS Services makes this module available to nearly all macOS apps, such as Safari, Finder, Google Chrome or Microsoft Office for Mac.

Requirements for the macOS Service

Install the commandline module.

Install the macOS Service

Run the commandline module with the --service-install argument:

$ shorten-anonymize-url --service-install

Uninstall the macOS Service

Run the commandline module with the --service-uninstall argument:

$ shorten-anonymize-url --service-uninstall

Use the macOS Service

Mark any URL (or any text),
right-click,
open the 'Services' menu,
Click 'shorten-anonymize-url'

The clipboard now contains the shortened and anonymized URL.

Programmatic Usage

Installation

$ npm install --save shorten-anonymize-url

API

The module returns a Function which takes 3 arguments and returns a Promise:

const shortenAnonymizeUrl = require('shorten-anonymize-url')
shortenAnonymizeUrl(url, bitlyKey, googlKey)
.then((shorturl) => {
    console.log(shorturl);
})

url String - Bundle identifier for the callback function
bitlyKey optional String - bit.ly API key
googlKey optional String - goo.gl API key

The Promise resolves with:

shorturl String - Shortened anonymised bit.ly url

Example

const shortenAnonymizeUrl = require('shorten-anonymize-url')
shortenAnonymizeUrl('reddit.com')
.then((url) => {
    console.log(url);
    // http://bit.ly/2qWTDzM
})
.catch((err) => {
    console.error(err);
})