https://github.com/bpepple/last-shout

A command line tool to tweet top artist statistics from Last.fm to Twitter
https://github.com/bpepple/last-shout

lastfm python3 twitter

Last synced: 23 days ago
JSON representation

A command line tool to tweet top artist statistics from Last.fm to Twitter

• Host: GitHub
• URL: https://github.com/bpepple/last-shout
• Owner: bpepple
• License: gpl-3.0
• Created: 2019-12-22T02:41:56.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2024-04-12T03:28:46.000Z (7 months ago)
• Last Synced: 2024-04-14T01:06:01.717Z (7 months ago)
• Topics: lastfm, python3, twitter
• Language: Python
• Homepage:
• Size: 294 KB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 4
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
==========

Last-Shout

==========

.. image:: https://img.shields.io/pypi/v/last-shout.svg

    :target: https://pypi.org/project/last-shout/

.. image:: https://img.shields.io/pypi/pyversions/last-shout.svg

    :target: https://pypi.org/project/last-shout/

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg

    :target: https://github.com/psf/black

Quick Description

-----------------

A command line tool to toot a user's top artist statistics from Last.fm to Mastodon.

Installation

------------

PyPi

~~~~

Install it yourself:

.. code:: bash

  $ pip install --user last-shout

GitHub

~~~~~~

Installing the latest version from Github:

.. code:: bash

  $ 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 Last.fm_ and Mastodon.

.. _Last.fm: https://www.last.fm

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)

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