network-avatar-picker

network-avatar-picker

A npm module that returns a user's avatar from his social networks as Buffer or as URL. You can choose among Facebook, Twitter, Instagram, Tumblr, Vimeo, Github, Gmail and Youtube provider. Then, you just need to pass a username without the need of token or API keys and retrieve user's social network profile picture!

Supported Providers

• Facebook
• Github
• Gmail
• Instagram
• Tumblr
• Twitter
• Vimeo
• Youtube

Usage

First, install network-avatar-picker as a dependency:

npm install --save network-avatar-picker

Then you should require in order to be able use it:

const AvatarPickerService = require('network-avatar-picker');
const avatarPicker = new AvatarPickerService();

Use the async methods of the avatarPicker instance to get user avatars:

Get avatar as Buffer:

• avatarPicker.facebook.getAvatar(username)
• avatarPicker.twitter.getAvatar(username)
• avatarPicker.instagram.getAvatar(username)
• avatarPicker.tumblr.getAvatar(username)
• avatarPicker.vimeo.getAvatar(username)
• avatarPicker.github.getAvatar(username)
• avatarPicker.youtube.getAvatar(username)
• avatarPicker.gmail.getAvatar(email)

Get avatar as URL:

• avatarPicker.facebook.getAvatarUrl(username)
• avatarPicker.twitter.getAvatarUrl(username)
• avatarPicker.instagram.getAvatarUrl(username)
• avatarPicker.tumblr.getAvatarUrl(username)
• avatarPicker.vimeo.getAvatarUrl(username)
• avatarPicker.github.getAvatarUrl(username)
• avatarPicker.youtube.getAvatarUrl(username)
• avatarPicker.gmail.getAvatarUrl(email)

Example

1. Fetch twitter's cnn user profile picture:

Buffer:

(async () => {
    try {
      const res = await avatarPicker.twitter.getAvatar('cnn');
    } catch (e) {
      // Deal with the fact the chain failed
    }
})();

URL:

(async () => {
    try {
      const res = await avatarPicker.twitter.getAvatarUrl('cnn');
    } catch (e) {
      // Deal with the fact the chain failed
    }
})();

1. Fetch facebook's zuck user profile picture:

Buffer:

(async () => {
    try {
      const res = await avatarPicker.facebook.getAvatar('zuck');
    } catch (e) {
      // Deal with the fact the chain failed
    }
})();

URL:

(async () => {
    try {
      const res = await avatarPicker.facebook.getAvatarUrl('zuck');
    } catch (e) {
      // Deal with the fact the chain failed
    }
})();

1. Fetch instagram's cnn user profile picture:

Buffer:

(async () => {
    try {
      const res = await avatarPicker.instagram.getAvatar('cnn');
    } catch (e) {
      // Deal with the fact the chain failed
    }
})();

URL:

(async () => {
    try {
      const res = await avatarPicker.instagram.getAvatarUrl('cnn');
    } catch (e) {
      // Deal with the fact the chain failed
    }
})();