https://github.com/nocarryr/vidhub-control

Control Smart Videohub Devices
https://github.com/nocarryr/vidhub-control

asyncio blackmagic-design blackmagicdesign broadcasting kivy python smartscope smartview television video video-production video-switchers videohub

Last synced: about 2 months ago
JSON representation

Control Smart Videohub Devices

• Host: GitHub
• URL: https://github.com/nocarryr/vidhub-control
• Owner: nocarryr
• License: gpl-3.0
• Created: 2016-12-29T23:42:23.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2024-09-03T21:18:55.000Z (4 months ago)
• Last Synced: 2024-10-31T11:36:47.582Z (about 2 months ago)
• Topics: asyncio, blackmagic-design, blackmagicdesign, broadcasting, kivy, python, smartscope, smartview, television, video, video-production, video-switchers, videohub
• Language: Python
• Homepage: https://vidhub-control.readthedocs.io/
• Size: 6.32 MB
• Stars: 11
• Watchers: 4
• Forks: 4
• Open Issues: 1
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
vidhub-control

==============

|build_badge| |coveralls_badge|

.. |build_badge| image:: https://img.shields.io/github/workflow/status/nocarryr/vidhub-control/CI%20Test

    :alt: Build Status

.. |coveralls_badge| image:: https://img.shields.io/coveralls/github/nocarryr/vidhub-control

    :alt: Coveralls

Interface with Videohub SDI Matrix Switchers and SmartView Monitors by

`Blackmagic Design `_.

The primary purpose is for use as a library in other applications, but a GUI

application is included (requires installation of the `Kivy framework <#install-kivy>`_

Since neither the devices nor the software for them support presets or macros,

a need arose for instantaneous multiple routing changes.  This, as well as

setting the names for inputs and outputs within a single application can be

accomplished using this project.

Links

-----

.. list-table::

    :widths: auto

    * - Releases

      - https://pypi.org/project/vidhub-control/

    * - Source code

      - https://github.com/nocarryr/vidhub-control

    * - Documentation

      - https://vidhub-control.readthedocs.io/

Dependencies

------------

This project relies heavily on `asyncio` and other features available in

**Python v3.5** or later.

Core

  * `python-dispatch `_

  * `json-object-factory `_

  * `zeroconf `_

  * `python-osc `_

  * `pid `_

User interface (optional)

  * `Kivy `_

Installation

------------

Download

^^^^^^^^

.. highlight:: bash

For basic installation, clone or download the source code::

    git clone https://github.com/nocarryr/vidhub-control

    cd vidhub-control

Create virtual environment

^^^^^^^^^^^^^^^^^^^^^^^^^^

*(optional, but recommended)*

Linux/MacOS

"""""""""""

::

    virtualenv --python=python3 venv

    source venv/bin/activate

Windows

"""""""

::

    virtualenv --python=python3 venv

    venv/Scripts/activate

Install vidhub-control

^^^^^^^^^^^^^^^^^^^^^^

::

    python setup.py install

Install Kivy

^^^^^^^^^^^^

*(optional)*

Ensure all dependencies are met for your platform. Instructions can be found

on the `kivy download page `_

Linux (Ubuntu)

""""""""""""""

Follow the instructions for `Installation in a Virtual Environment `_

Windows

"""""""

::

    pip install docutils pygments pypiwin32 kivy.deps.sdl2 kivy.deps.glew

    pip install kivy.deps.sdl2

    pip install kivy

MacOS

"""""

Follow the instructions for `homebrew `_

or `MacPorts `_.

Usage

-----

To launch the user interface (Kivy required):

::

    vidhubcontrol-ui

Note for Windows

^^^^^^^^^^^^^^^^

The `vidhubcontrol-ui` script may not work. If this is the case, it can be

launched by::

    python vidhubcontrol/kivyui/main.py