Skip to main content

Schedules tweets using TweetDeck

Project description

Automated tweet scheduling using TweetDeck. Uses Selenium to spawn a browser, log in to TweetDeck with your credentials, and schedule a tweet on your behalf by clicking on things in the app.


Install geckodriver. On macOS with Homebrew you can use brew install geckodriver. Then…

..code:: shell

$ pip install schedule_tweet

Only Python 3.6 and higher is supported.


..code:: python

>>> import os
>>> from datetime import datetime, timedelta
>>> import schedule_tweet
>>> username = 'schedule_tw'
>>> password = os.getenv('PASSWORD')
>>> now_dt =
>>> with schedule_tweet.session(username, password) as session:
...     dt = now_dt + timedelta(minutes=2)
...     session.tweet(dt, f'First Tweet 🚀 {dt.isoformat()}')
...     dt = now_dt + timedelta(minutes=3)
...     session.tweet(dt, f'Second Tweet 💥 {dt.isoformat()}')


Obviously, TweetDeck authors can change anything anytime, which may or may not break this tool. That’s why it is tested by a regular nightly Travis CI build. If it’s able to schedule a tweet in the sample @schedule_tw <>_ account, it assumes the tool still works and the build will pass. If the build badge is red, it means the tool doesn’t work anymore and it needs to be updated.


Twitter doesn’t provide scheduling tweets in their API. It is provided only as a feature of TweetDeck, their advanced official client. Unlike other clients which support scheduling tweets, TweetDeck is free of charge, it is an official tool made by Twitter themselves, and it supports teams.

The schedule-tweet tool was originally built to save precious volunteering time of the PyCon CZ 2017 social media team.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

schedule_tweet-1.0.0.tar.gz (6.1 kB view hashes)

Uploaded source

Built Distribution

schedule_tweet-1.0.0-py3-none-any.whl (8.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page