Metadata-Version: 2.1
Name: rtsp
Version: 1.1.2
Summary: RTSP client
Home-page: https://github.com/statueofmike/rtsp
Author: Michael Stewart
Author-email: statueofmike@gmail.com
License: MIT
Download-URL: https://github.com/statueofmike/rtsp/archive/1.1.2.tar.gz
Description: # RTSP Package
        
                    /((((((\\\\
            =======((((((((((\\\\\
                 ((           \\\\\\\
                 ( (*    _/      \\\\\\\
                   \    /  \      \\\\\\________________
                    |  |   |      </    __             ((\\\\
                    o_|   /        ____/ / _______       \ \\\\    \\\\\\\
                         |  ._    / __/ __(_-</ _ \       \ \\\\\\\\\\\\\\\\
                         | /     /_/  \__/___/ .__/       /    \\\\\\\     \\
                 .______/\/     /           /_/           /         \\\
                / __.____/    _/         ________(       /\
               / / / ________/`---------'         \     /  \_
              / /  \ \                             \   \ \_  \
             ( <    \ \                             >  /    \ \
              \/      \\_                          / /       > )
                       \_|                        / /       / /
                                                _//       _//
                                               /_|       /_|
        
        
        RTSP Client. Requires OpenCV-Python
        
        ## Features
        
          * fetch a single image as Pillow Image
          * open RTSP stream and poll most recent frame as Pillow Image
          * preview stream in OpenCV
        
          * Robustness
            * configurable number of frames to allow dropped
            * configure time to retry creating a new connection
        
        ### Client
        
            Client(rtsp_server_uri, drop_frame_limit=15, retry_connection=TRUE, verbose = TRUE)
        
        ## Examples
        
        One-off Retrieval
        
            import rtsp
            client = rtsp.Client(rtsp_server_uri = 'rtsp://...')
            client.read().show()
            client.close()
        
        Stream Preview
        
            import rtsp
            with rtsp.Client('rtsp://...') as client:
                client.preview()
        
        Continuous Retrieval
        
            import rtsp
        
            with rtsp.Client(rtsp_server_uri = 'rtsp://...',drop_frame_limit=10) as client:
                _image = client.read()
        
                while True:
                    process_image(_image)
                    _image = client.read()
        
        Verbose mode
        
            In [1]: import rtsp
            In [2]: client = rtsp.Client()
            Connected to RTSP video source rtsp://192.168.1.3/ufirststream/track1.
            In [3]: client.preview()
            In [4]: client.close()
            Dropped RTSP connection.
            Received signal to stop.
            In [5]: client.open()
            Connected to RTSP video source rtsp://192.168.1.3/ufirststream/track1.
            In [6]: client.read().show()
            Connected to RTSP video source rtsp://192.168.1.3/ufirststream/track1.
            In [7]: client.close()
            Dropped RTSP connection.
            Received signal to stop.
        
        ## Roadmap:
          * v1.0.0 - basic function relying on OpenCV or ffmpeg
          * v2.0.0 - lightweight native-Python implementation rtsp client functions
            * live stream reading & buffer
            * on-demand frame retrieval
          * v2.1.0 - native Python rtsp server functions
Keywords: rtsp image stream
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Multimedia :: Video :: Capture
Classifier: Topic :: System :: Networking
Requires-Python: >=3.5
Description-Content-Type: text/markdown
