Skip to content

Latest commit

 

History

History
74 lines (48 loc) · 2.53 KB

PublishersAndProviders.md

File metadata and controls

74 lines (48 loc) · 2.53 KB
Raw

Providers and Publishers that are currently supported

Providers (The Platform From where the information is coming from)

  • Github

Publishers (The Platform where the information will be posted)

  • Twitter
  • Github
  • Mastodon

Before running the bot, you must configure it so that it can connect to the current supported platforms

Environment variables need for Providers and Publishers

Github

  • GITHUB_ACCESS_TOKEN

Note: If you want the content to be published in a README file on a repo, you also need these variables_

  • GITHUB_PUBLISH_REPO_OWNER (Your Github username)
  • GITHUB_PUBLISH_REPO_NAME (The name of the repo where your README is. It has to be public)
  • GITHUB_PUBLISH_REPO_FILE (By default is README)

Twitter

  • TWITTER_CONSUMER_KEY
  • TWITTER_CONSUMER_SECRET
  • TWITTER_ACCESS_TOKEN
  • TWITTER_ACCESS_SECRET

Mastodon

  • MASTODON_SERVER (the instance for your (bot) account)
  • MASTODON_CLIENT_ID (the application's client id)
  • MASTODON_CLIENT_SECRET (the application's secret)
  • MASTODON_ACCESS_TOKEN (the access token)
  • MASTODON_ACCOUNT (optional, without access token)
  • MASTODON_PASSWIRD (optional, without access token)

How to setup the environment variables for the platforms

Github

To generate the github access tokens follow the given steps

  1. Verify your email address, if it hasn't been verified yet.
  2. In the upper-right corner of your github profile, click your profile photo, then click Settings.
  3. In the left sidebar, click Developer settings.
  4. In the left sidebar, click Personal access tokens.
  5. Click Generate new token.
  6. Give your token a descriptive name.
  7. To give your token an expiration, select the Expiration drop-down menu, then click a default or use the calendar picker.
  8. Select the scopes, or permissions, you'd like to grant this token. To use your token to access repositories from the command line, select repo.
  9. Click Generate token.

For further information click here

Twitter

For getting Twitter keys and secrets click here.

Note: You will have to generate both consumer and access pair of keys/tokens and secrets.

Mastodon

Register an application on your instance:

  • Redirect URI: urn:ietf:wg:oauth:2.0:oob
  • Scopes: read:statuses, write:statuses

Capture: ID, Client ID, Client Secret and Access Token.