Metadata-Version: 2.1
Name: spotify-videos
Version: 1.7
Summary: Simple tool to show Youtube music videos and lyrics for the playing Spotify songs
Home-page: https://github.com/marioortizmanero/spotify-music-videos
Author: Mario O.M.
Author-email: marioortizmanero@gmail.com
License: MIT
Description: # Spotify Music Videos
        ![travis](https://travis-ci.com/marioortizmanero/spotify-music-videos.svg?branch=master)
        
        A simple tool to show Youtube **music videos** and **lyrics** for the currently playing Spotify songs with VLC.
        
        ![example](screenshots/screenshot.png)
        
        
        ## Requirements
        * Python 3.6+
        
        For **Linux** users:
        
        * [PyGI](https://pygobject.readthedocs.io/en/latest/) (not packaged on PyPi, you need to install it from your distribution's repository - it's usually called python-gi, python-gobject or pygobject). Here's a quick [tutorial](https://pygobject.readthedocs.io/en/latest/getting_started.html) on how to install it on most systems.
        
        * [GLib](https://developer.gnome.org/glib/). You most likely have it installed already.
        
        
        ## How to install
        You can use pip to install it:
        
        `pip3 install spotify-videos`
        
        Or download the latest [release](https://github.com/marioortizmanero/spotify-music-videos/releases). Uncompress the .tar.gz file and run inside the folder:
        
        `python3 ./setup.py install`
        
        *Note: you can add the --user flag to install it locally.*
        
        Or you can just run it without installing it with:
        
        `python3 -m spotify_videos`
        
        
        ## Compatibility
        
        For Windows and Mac users, the Spotify Web API will be used. This means that:
        
        * You have to sign in and set it up manually
        * Only Spotify Premium users are able to use some functions
        * API calls are limited to 1 per second so there is more lag
        
        **How to obtain your client ID and your client secret:**
        1. Go to the [Spotify Developers Dashboard](https://developer.spotify.com/dashboard/applications)
        2. Create a new client ID. You can fill the descriptions as you like. Click `No` when asked if it's a commercial integration and accept the Terms and Conditions in the next step.
        3. Go to `Edit Settings` and type `http://localhost:8888/callback/` in the Redirect URIs field.
        4. You can now copy your Client ID and Client Secret and add them when you call `spotify-videos` by passing them as arguments or by exporting the enviroment variables so that you don't have to type them again:
             * `spotify-videos --username your_username --client-id your_client_id --client-secret your_client_secret`
             * `export SPOTIPY_CLIENT_ID='your-spotify-client-id'; export SPOTIPY_CLIENT_SECRET='your-spotify-client-secret'`
        
        You may be prompted to paste the resulting link that was opened in your browser into the program. After doing it, the authorization process will be complete. The auth info should be kept in a cache file named `.cache-[your_username]`
        
        
        ## How to use
        You can use these flags to modify the behavior of the program:
        
        ```
        usage: spotify-videos [-h] [-v] [--debug] [-n] [-f] [-a VLC_ARGS]
                              [--width MAX_WIDTH] [--height MAX_HEIGHT] [-w]
                              [--username USERNAME] [--client-id CLIENT_ID]
                              [--client-secret CLIENT_SECRET]
        
        Windows and Mac users must pass --username, --client-id and --client-secret to
        use the web API. Read more about how to obtain them in the README
        (https://github.com/marioortizmanero/spotify-music-videos).
        
        optional arguments:
          -h, --help            show this help message and exit
          -v, --version         show program's version number and exit
          --debug               display debug messages
          -n, --no-lyrics       do not print lyrics
          -f, --fullscreen      play videos in fullscreen mode
          -a VLC_ARGS, --args VLC_ARGS
                                other arguments used when opening VLC. Note that some
                                like args='--fullscreen' won't work in here
          --width MAX_WIDTH     set the maximum width for the played videos
          --height MAX_HEIGHT   set the maximum height for the played videos
          -w, --use-web-api     forcefully use Spotify's web API
          --username USERNAME   your Spotify username. Mandatory if the web API is
                                being used. Example: --username='yourname'
          --client-id CLIENT_ID
                                your client ID. Mandatory if the web API is being
                                used. Check the README to see how to obtain yours.
                                Example: --client-
                                id='5fe01282e44241328a84e7c5cc169165'
          --client-secret CLIENT_SECRET
                                your client secret ID. Mandatory if the web API is
                                being used. Check the README to see how to obtain
                                yours. Example: --client-
                                secret='2665f6d143be47c1bc9ff284e9dfb350'
        ```
        
        ---
        
        ## Current limitations:
        * Spotify doesn't currently (15/07/19) support the MPRIS property `Position` so the starting offset is calculated manually and may be a bit rough.
        * Spotify's Web API doesn't allow function calls on updates like DBus, meaning that the metadata has to be manually updated every second and checked in case of changes.
        
        
        ## Documentation
        Helpful documentation links for contributing:
        * [DBus](https://dbus.freedesktop.org/doc/dbus-specification.html), [DBus python module](https://dbus.freedesktop.org/doc/dbus-python/tutorial.html)
        * [MPRIS](https://specifications.freedesktop.org/mpris-spec/latest/Player_Interface.html#Property:Position)
        * [python-vlc](https://www.olivieraubert.net/vlc/python-ctypes/doc/)
        
        Running module locally:
        
        `python -m spotify_videos`
        
        Running tests with unittest:
        
        `python -m unittest` or `python -m unittest discover -s tests`
        
        
Keywords: spotify music video videos lyrics
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Multimedia :: Sound/Audio :: Players
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Python: >=3.6
Description-Content-Type: text/markdown
