Skip to main content

A program to post statistics to Twitter and/or Mastodon

Project description


Quick Description

A command line tool to tweet a user's top artist statistics from to Twitter.


  • PyPi

    Install it yourself:

      $ pip install --user last-shout
  • GitHub

    Installing the latest version from Github:

      $ git clone
      $ cd last-shout
      $ python3 install

Getting started

In order to use Last-Shout, you need at a minimum to get authentication keys for Twitter and

  • To get the necessary authenticaton keys for Twitter, refer to the documentation here.

  • To get the necessary authentication keys for, refer to their documentation here.


usage: last-shout [-h] [-u USER] [--last-access-key LAST_ACCESS_KEY]
                  [--set-lastfm] [-n NUMBER] [-p PERIOD] [-t]
                  [--consumer-key CONSUMER_KEY]
                  [--consumer-secret CONSUMER_SECRET]
                  [--access-key ACCESS_KEY] [--access-secret ACCESS_SECRET]
                  [--set-twitter] [--version]

A program to post statistics to Twitter and/or Mastodon.

optional arguments:
  -h, --help            show this help message and exit
  -u USER, --user USER username (default: None)
  --last-access-key LAST_ACCESS_KEY
               access key (default: None)
  --set-lastfm          Set credentials (default: False)
  -n NUMBER, --number NUMBER
                        Number of top artists (default: 10)
  -p PERIOD, --period PERIOD
                        The time period over which to retrieve top artists.
                        Options are: overall | 7day | 1month | 3month | 6month
                        | 12month (default: 7day)
  -t, --tweet           Post stats to Twitter (default: False)
  --consumer-key CONSUMER_KEY
                        Twitter consumer key (default: None)
  --consumer-secret CONSUMER_SECRET
                        Twitter consumer secret (default: None)
  --access-key ACCESS_KEY
                        Twitter access token key (default: None)
  --access-secret ACCESS_SECRET
                        Twitter access secret (default: None)
  --set-twitter         Set Twitter credentials (default: False)
  --version             Show the version number and exit

Project details

Download files

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

Files for last-shout, version 0.5.0
Filename, size File type Python version Upload date Hashes
Filename, size last_shout-0.5.0-py3-none-any.whl (19.5 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size last-shout-0.5.0.tar.gz (6.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page