Skip to content
A framework to manage, monitor and deploy marketing in social-media by re-posting content from one place to the another.
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.


A framework to manage, monitor and deploy marketing in social-media by re-posting content from one place to the another.


I wanted a setup that could be give me an entire control over content creation in a programmable automated way. With this framework, I can add as many as content retrievers and submitters as possible and create any kind of dynamic programmable workflow between them.

So for example, I could have reddit -> multiple facebook pages, twitter, instagram pages content submission, or tumblr, reddit, custom website -> Multiple facebook pages, twitter, etc. without really worrying about the underlying integration part.

Consider it like a free zapier across social media handle content management.


  1. Declarative setup to control the submission of re-posts.
  2. Out of the box support for Reddit -> Facebook re-posts.
  3. Super simple API to add new social media handles for retrieval or submission of content.
  4. Super clean logging with logic to ensure duplicate posts don't get posted.
  5. Add support of many-to-many reposts for as many handles, pages you want.
    • Like Reddit -> Facebook, Instagram, Twitter.
    • Like Tumblr -> Facebook, Reddit, HackerNews.
    • Reddit (multiple subreddits), Tumblr -> Facebook (Multiple Pages), Twiiter (Multiple Handles)
  6. Remember its just the boilerplate allowing you to come up with any kind of imagination of its use-cases and social media handles.



  1. Python3
  2. pip
  3. virtualenv

Application Setup

  1. Clone the repository: git clone
  2. Cd into the directory: cd reposter
  3. Create a virtualenv for python: python -m venv reposter-env
  4. Activate the virtualenv:
    • Linux: source reposter-env/bin/activate
    • Windows: source reposter-env/Scripts/activate
  5. Upgrade your pip to latest version: pip install --upgrade pip
  6. Install the application level dependencies: pip install -r requirements.txt

Authentication Setup

  1. Create a Reddit bot and add in the credentials at: config.ini under [REDDIT] section.
    • allowed_domain: Enter the domains that you want to parse for content retrieval.
  2. Add in your page information at config.ini as a section like [STEPHANIE] shown in the example.
    • Next add in your credentials after creating a page at facebook.
      • You don't need to add long_token that will be done by a script below.
    • Run python to get a permanent token which will be printed on the screen. Save it as we'll use it later on.
  3. Write the workflow logic in declarative syntax of json at information.json as follows:
    • There is already an example to showcase the working.
    • facebook tag encapsulates all of the information needed for Facebook workflow.
      • Name: Name of the facebook page.
      • page_id: ID of the facebook page.
      • token: *The token retrieved from the result above.
      • message: If you'd wanna write the message retrieved from the posts (from Reddit or any other content aggregator).
    • subreddits tag allows you to mention the subreddits from where you'd wanna retrieve the posts from.
  4. Now you must be able to run python to automate the process of re-posting from one social media handle to another.


class Reposter:
    def __init__(self):
        self.infoparser = infoparser

    def main(self):
        for job in
            except Exception:

    def execute(self, job, tries=0, max_tries=5):
        posts = self.get_posts(job.subreddits)
        tries += 1
        if not posts and tries < max_tries:
            return self.execute(job, tries)
            self.submit_posts(job.facebook, posts)

    def get_posts(subreddits):
        posts = []
        for subreddit in subreddits:
            pg = PostGetter(
            post = pg.get_any_post()
            print("Got my post as %s from %s subreddit." % (post.url,
        return posts

    def submit_posts(social_media, posts):
        ps = PostSubmitter(social_media.page_id, social_media.token, social_media.message)
        for post in posts:
            print("Posted my post as %s for %s page." % (post.title,

Periodic Posting

  1. Use a crontab to schedule your posts: crontab -e
  2. Add this entry 0 */3 * * * /<path-to-repository>/reposter/reposter-env/bin/python /<path-to-repository>/reposter/ >/dev/null 2>&1
  3. The above added entry creates Facebook posts every 3 hours retrieved from Reddit.

Advanced Setup

  1. Throughout the code you can abstract a lot of entries to the information.json like which posts to choose from Reddit (currently its the top rated one.)
  2. Adding new social media handles for retrieval and submission is super easy:
    • Create their own module and add the hooks at information.json
    • Regulate their separate logic in a much more modular way.


Its one of the first pieces of software I wrote (back in 2017) when I was introduced to Python and wanted to manage social media handles of one of my Open Source Project - Stephanie which was programmed to make automated posts in its Facebook Page at Stephanie - Facebook Page.

More Pages using the program:

  1. Earthian
  2. Otterance

So in the process of checking out my previous project - I just thought to make it open-source for anyone to use.

Its super simply and doesn't require any fancy programming to get started with.

You can’t perform that action at this time.