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

Release history Release notifications

Download files

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

Files for schedule-tweet, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size schedule_tweet-1.0.0-py3-none-any.whl (8.5 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size schedule_tweet-1.0.0.tar.gz (6.1 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page