Metadata-Version: 1.1
Name: GPM-Playlist-Generator
Version: 1.0.1
Summary: Google Play Music - Playlist Generator
Home-page: https://gitlab.com/hugoh/gpm-playlistgen
Author: Hugo Haas
Author-email: hugoh@hugoh.net
License: UNKNOWN
Description-Content-Type: UNKNOWN
Description: Google Play Music - Playlist Generator
        ======================================
        
        |build status|
        
        This is a command-line tool to generate a set of standard playlists for
        Google Play Music libraries.
        
        It's currently in beta, and some knowledge of Python and comfort with
        the command line is required. Depending on interest, I will make it more
        user friendly. The author is using the tool and care is being taken not
        to make a mess in the library manipulated (I care about mine too), but
        USE AT YOUR OWN RISK.
        
        Authentication information
        --------------------------
        
        Copy ``config.sample.yaml`` into ``config.yaml``, and add your account
        name under ``auth.user`` and your password (or an application-specific
        password if you have 2-factor authentication enabled) under
        ``auth.password``.
        
        Installation
        ------------
        
        You can either do a:
        
        .. code:: sh
        
            pip install GPM-Playlist-Generator
        
        or if you've cloned this repo:
        
        .. code:: sh
        
            python setup.py install
        
        Running the tool
        ----------------
        
        Simply run:
        
        .. code:: sh
        
            gpm-playlistgen.py config.yaml
        
        What it does
        ------------
        
        The default configuration captured in ``config.sample.yaml`` will log
        into your account, download the list of tracks and playlists in your
        library, and do the following as per the ``playlist`` section in the
        configuration:
        
        -  Generate a set of playlists grouping your tracks by month in which
           they've been added to your library (``monthly_added``)
        -  Generate a sorted list of your most frequently played tracks
           (``most_played``)
        
        The playlist generated will all have a name starting with "[PG]". This
        is configurable.
        
        If you rerun the tool, it will only regenerate the playlists that are
        needed (new tracks in monthly added, and most played).
        
        I need help
        -----------
        
        Try:
        
        .. code:: sh
        
            gpm-playlistgen.py config.yaml
        
        I want to report a problem or I have a cool idea for this tool
        --------------------------------------------------------------
        
        Please use the `issue
        tracker <https://gitlab.com/hugoh/gpm-playlistgen/issues>`__.
        
        FAQ
        ---
        
        I don't trust this tool
        ~~~~~~~~~~~~~~~~~~~~~~~
        
        "No problem". You can run it with the ``--dry-run`` option. It will not
        write anything to your account, simply show you what it would do.
        
        I want to get rid of all those generated playlists
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        You can run:
        
        .. code:: sh
        
            gpm-playlistgen.py --delete-all-playlists config.yaml
        
        The description field is used to check that this is a generated list,
        but I strongly advise to the the following first to see what it's going
        to do:
        
        .. code:: sh
        
            gpm-playlistgen.py --delete-all-playlists config.yaml --dry-run
        
        Credits
        -------
        
        The heavy lifting is done by `Simon Weber's
        gmusicapi <https://github.com/simon-weber/gmusicapi>`__.
        
        .. |build status| image:: https://gitlab.com/hugoh/gpm-playlistgen/badges/master/build.svg
           :target: https://gitlab.com/hugoh/gpm-playlistgen/commits/master
        
Keywords: google music,google play music,playlist,playlist generator
Platform: UNKNOWN
Classifier: Environment :: Console
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Multimedia :: Sound/Audio
