Emaily/README.md

# Emaily for Android

Emaily makes it easy to share shortened links (using [is.gd](https://is.gd/) or [bit.ly](https://bit.ly)) directly from your phone's options menu. 

<p align="center">
<a href='https://play.google.com/store/apps/details?id=net.thauvin.erik.android.emaily&pcampaignid=pcampaignidMKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1'><img alt='Get it on Google Play' src='https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png' width="25%"/></a>
</p>

## How to use Emaily:

When you find a page you want to share, simply follow these steps:

1. Select the `Options` menu:

    ![Options Menu](screenshots/steps/small/1-sm.png)

2. Select the `Share...` menu:

    ![Share Menu](screenshots/steps/small/2-sm.png)

3. Select `Emaily` from the `Share` sheet:

    ![Share Sheet](screenshots/steps/small/3-sm.png)

4. Select `Gmail` (or whichever application you want to share with):

    ![Share Gmail](screenshots/steps/small/4-sm.png) ![Share Gmail 2](screenshots/steps/small/4b-sm.png)

5. Compose & Send Email

    ![Compose Email](screenshots/steps/small/6-sm.png)

## Bitly

In order to use Bitly as Emaily's link shortner, you will need a [Bitly API Access Token](https://bitly.is/accesstoken).

To enable Bitly follow these steps:

1. Disable `is.gd` turning its switch off:

    ![Isgd Selected](screenshots/steps/small/isgd_selected-sm.png) ![Isgd Disabled](screenshots/steps/small/isgd_disabled-sm.png)

2. Click on the Bitly `API Access Token` preference option:

    ![Bitly Selected](screenshots/steps/small/bitly_selected-sm.png)

3. Enter your Bitly `API Access Token`, and click `OK`:

    ![Bitly Credentials](screenshots/steps/small/bitly_creds-sm.png)