last-shout 0.7.0

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

Quick Description

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

Installation

PyPi

Install it yourself:

$ pip install --user last-shout

GitHub

Installing the latest version from Github:

$ git clone https://github.com/bpepple/last-shout.git
$ cd last-shout
$ python3 setup.py install

Getting started

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

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

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

Help

usage: main.py [-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]
               [--version]

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

optional arguments:
  -h, --help            show this help message and exit
  -u USER, --user USER  Last.fm username (default: None)
  --last-access-key LAST_ACCESS_KEY
                        Last.fm access key (default: None)
  --set-lastfm          Set Last.fm credentials (default: False)
  -n NUMBER, --number NUMBER
                        Number of last.fm 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 Last.fm 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-app
                        Create mastodon application (default: False)
  --create-mastodon-user
                        Create Mastodon user token (default: False)
  --toot                Post Last.fm stats to Mastodon (default: False)
  --version             Show the version number and exit