Skip to main content

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

Project description

https://img.shields.io/pypi/v/last-shout.svg https://img.shields.io/pypi/pyversions/last-shout.svg Code coverage Status https://travis-ci.org/bpepple/last-shout.svg?branch=master https://img.shields.io/badge/code%20style-black-000000.svg

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

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 Python 3

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