update readme
This commit is contained in:
70
README.md
70
README.md
@@ -1,14 +1,22 @@
|
|||||||
# ndi-python
|
# ndi-python
|
||||||
NewTek NDI Python wrapper
|
NewTek NDI Python wrapper
|
||||||
|
|
||||||
## Setup
|
## Installation
|
||||||
### Windows, Mac
|
ndi-python is support pypi package now. https://pypi.org/project/ndi-python/
|
||||||
Donwload and install NDI SDK.
|
So you can install it using pip if it is a supported environment.
|
||||||
https://ndi.tv/sdk/
|
```
|
||||||
|
pip install ndi-python
|
||||||
|
```
|
||||||
|
The supported environment is as follows.
|
||||||
|
- Windows x64 Python(3.7-3.10)
|
||||||
|
- macOS x64 >=10.12 Python(3.7-3.10)
|
||||||
|
- Linux x64 Python(3.7-3.10)
|
||||||
|
|
||||||
|
## Setup Avahi
|
||||||
|
Linux requires Avahi to search for NDI sources.
|
||||||
|
Please install according to your environment.
|
||||||
|
|
||||||
### Ubuntu
|
### Ubuntu
|
||||||
Donwload and install NDI SDK.
|
|
||||||
https://ndi.tv/sdk/
|
|
||||||
```
|
```
|
||||||
sudo apt install avahi-daemon
|
sudo apt install avahi-daemon
|
||||||
sudo systemctl enable --now avahi-daemon
|
sudo systemctl enable --now avahi-daemon
|
||||||
@@ -16,11 +24,57 @@ sudo systemctl enable --now avahi-daemon
|
|||||||
|
|
||||||
### Arch Linux
|
### Arch Linux
|
||||||
```
|
```
|
||||||
yay -S avahi ndi-sdk
|
sudo pacman -S avahi
|
||||||
sudo systemctl enable --now avahi-daemon
|
sudo systemctl enable --now avahi-daemon
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Run examples
|
||||||
|
I've ported some examples to python.
|
||||||
|
You can try it by running the ndi-python examples.
|
||||||
|
```
|
||||||
|
git clone --recursive https://github.com/buresu/ndi-python.git
|
||||||
|
cd ndi-python/example
|
||||||
|
pip install -r requirements.txt
|
||||||
|
python find.py
|
||||||
|
```
|
||||||
|
|
||||||
|
## Development
|
||||||
|
|
||||||
|
### Install NDI SDK
|
||||||
|
NDI SDK is required for development.
|
||||||
|
You should install according to your environment.
|
||||||
|
|
||||||
|
### Windows, Mac, Ubuntu
|
||||||
|
Donwload and install NDI SDK.
|
||||||
|
https://ndi.tv/sdk/
|
||||||
|
|
||||||
|
### Arch Linux
|
||||||
|
```
|
||||||
|
yay -S ndi-sdk
|
||||||
|
```
|
||||||
|
|
||||||
## Build
|
## Build
|
||||||
|
### Build with setup.py
|
||||||
|
```
|
||||||
|
git clone --recursive https://github.com/buresu/ndi-python.git
|
||||||
|
cd ndi-python
|
||||||
|
python setup.py build
|
||||||
|
```
|
||||||
|
For ubuntu you need to set the SDK directory in NDI_SDK_DIR as cmake options.
|
||||||
|
```
|
||||||
|
env CMAKE_ARGS="-DNDI_SDK_DIR=/path/to/ndisdk" python setup.py build
|
||||||
|
```
|
||||||
|
You can also specify the python version.
|
||||||
|
```
|
||||||
|
env CMAKE_ARGS="-DNDI_SDK_DIR=/path/to/ndisdk -DPYBIND11_PYTHON_VERSION=3.8" python3.8 setup.py build
|
||||||
|
```
|
||||||
|
|
||||||
|
### Build for Python package
|
||||||
|
```
|
||||||
|
python setup.py bdist_wheel
|
||||||
|
```
|
||||||
|
|
||||||
|
### Build only CMake
|
||||||
```
|
```
|
||||||
git clone --recursive https://github.com/buresu/ndi-python.git
|
git clone --recursive https://github.com/buresu/ndi-python.git
|
||||||
cd /path/to/build
|
cd /path/to/build
|
||||||
@@ -34,9 +88,7 @@ And build as follows.
|
|||||||
cmake /path/to/project -DNDI_SDK_DIR=/path/to/ndisdk
|
cmake /path/to/project -DNDI_SDK_DIR=/path/to/ndisdk
|
||||||
cmake --build /path/to/build --config Release
|
cmake --build /path/to/build --config Release
|
||||||
```
|
```
|
||||||
|
|
||||||
After build copy ndi-python binary and NDI binary to execute directory.
|
After build copy ndi-python binary and NDI binary to execute directory.
|
||||||
Enjoy!
|
|
||||||
|
|
||||||
## License
|
## License
|
||||||
ndi-python is MIT License
|
ndi-python is MIT License
|
||||||
|
|||||||
Reference in New Issue
Block a user