https://github.com/kevgathuku/top40

Simple command line that displays the songs in the current UK Top 40 charts
https://github.com/kevgathuku/top40

Last synced: about 1 month ago
JSON representation

Simple command line that displays the songs in the current UK Top 40 charts

• Host: GitHub
• URL: https://github.com/kevgathuku/top40
• Owner: kevgathuku
• License: mit
• Created: 2014-11-27T08:23:53.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2014-12-23T15:22:42.000Z (about 10 years ago)
• Last Synced: 2024-04-16T04:06:59.597Z (8 months ago)
• Language: Python
• Homepage:
• Size: 281 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE.md

Awesome Lists containing this project

README

        
Top 40

======

A simple command line program that displays songs in the current UK Top

40 Charts This also displays their YouTube links for convenience.

Install

-------

``pip install top40``

Setup

-----

| If you just need to display the songs without the YouTube links, no

  additional action is required.

| You can skip ahead to the Usage section.

If you require to view the songs and their YouTube links:

Obtain a developer key from `Google`_ This is required for accessing the

YouTube API.

| Set the developer key as an environment variable:

|  ``export DEVELOPER_KEY="Your developer key"``

Usage

-----

There is just one basic command to display the songs:

``top40 display [OPTIONS]``

Displaying Songs

~~~~~~~~~~~~~~~~

Example usage:

::

    `top40 display`                   No arguments given. Displays the top 10 songs in the Charts.

    `top40 display -n 30`             This displays the top 30 songs in the chart

    `top40 display -n 30  --links`    This displays the top 30 songs in the chart and their YouTube links

OPTIONS

^^^^^^^

::

    -h, --help                        print this help text and exit

    -n, --num                         Specify the number of songs to display. Maximum of 40

Help

----

``top40 --help``

.. _Google: https://developers.google.com/youtube/registering_an_application