Metadata-Version: 2.1
Name: spotify-ws
Version: 0.0.3
Summary: A python wrapper for spotify web sockets
Home-page: https://github.com/jacopo-degattis/spotifyws
Author: Jacopo
Author-email: liljackx0@gmail.com
License: MIT
Download-URL: https://github.com/jacopo-degattis/spotifyws/archive/refs/tags/v0.0.3.tar.gz
Description: # Spotify Web Sockets
        
        ## Description
        
        The main purpose of this project is to let the users interact with
        spotify web socket events. Right now the project is still in an alpha version therefore is not complete and may have some bugs.
        Feel free to contribute is any way.
        
        ## Basic library usage
        
        Example using chrome cookies
        
        ```python
        
        from spotifyws.spotify import SpotifyWs
        
        client = SpotifyWs()
        
        # Triggered on track change
        @client.on('track')
        def on_track_change(data):
            print('Track changed => ', data)
        
        # Triggered on volume change
        @client.on("volume")
        def on_volume_change(data):
            print("Volume changed => ", data)
        
        # Triggered on options change, such as shuffle etc.
        @client.on("playback_options")
        def on_playback_options_change(data):
            print("Options changed => ", data)
        
        # Triggered playback state is resumed
        @client.on("resume")
        def on_play():
            print("Playback resumed")
        
        # Triggered playback state is paused
        @client.on("pause")
        def on_pause():
            print("Playback paused")
        
        ```
        
        Example using cookies from custom file
        
        ```python
        
        from spotifyws.spotify import SpotifyWs
        
        client = SpotifyWs(cookie_file="./cookie_file.json")
        
        # Triggered on track change
        @client.on('track')
        def on_track_change(data):
            print('Track changed => ', data)
        
        # Triggered on volume change
        @client.on("volume")
        def on_volume_change(data):
            print("Volume changed => ", data)
        
        # Triggered on options change, such as shuffle etc.
        @client.on("playback_options")
        def on_playback_options_change(data):
            print("Options changed => ", data)
        
        # Triggered playback state is resumed
        @client.on("resume")
        def on_play():
            print("Playback resumed")
        
        # Triggered playback state is paused
        @client.on("pause")
        def on_pause():
            print("Playback paused")
        
        ```
        
        ## Launch flask example
        
        In order to launch flask example you need the following commands:
        
        ```bash
        $ export FLASK_APP=examples.flask-app.server
        $ flask run
        ```
        
        ## About authentication
        
        Right now authentication can only be achieved using local cookies and not through OAUTH flow.
        
        ## Note
        
        This code is intended for learning purposes only.
        You must know that bypassing spotify API is against theirs Terms of service therefore I don't invite you to abuse this library.
        Thanks
        
        ## Author
        
        Jacopo De Gattis
        
Keywords: SPOTIFY,WEBSOCKETS,MUSIC
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Description-Content-Type: text/markdown
