Skip to main content

A program to post statistics to Twitter and/or Mastodon

Project description Code coverage Status

Quick Description

A command line tool to tweet a user’s top artist statistics from to Twitter and Mastodon.



Install it yourself:

$ pip install --user last-shout


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.


usage: [-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]
               [--create-mastodon-app] [--create-mastodon-user] [--toot]

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)
                        Create mastodon application (default: False)
                        Create Mastodon user token (default: False)
  --toot                Post stats to Mastodon (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.

Source Distribution

last-shout-0.7.0.tar.gz (8.1 kB view hashes)

Uploaded source

Built Distribution

last_shout-0.7.0-py3-none-any.whl (20.6 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