ray-cli


Nameray-cli JSON
Version 0.4.3 PyPI version JSON
download
home_pagehttps://github.com/nobbmaestro/ray-cli
SummaryCommand-line utility for generating and broadcasting DMX over sACN
upload_time2025-02-11 21:05:35
maintainerNone
docs_urlNone
authorNorbert Batiuk
requires_python<4.0,>=3.8
licenseMIT
keywords dmx sacn cli utility python
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Ray CLI

[![GitHub Release](https://img.shields.io/github/v/release/nobbmaestro/ray-cli)](github-release)
[![GitHub last commit](https://img.shields.io/github/last-commit/nobbmaestro/ray-cli/development)](github-last-commit)
[![GitHub commits since](https://img.shields.io/github/commits-since/nobbmaestro/ray-cli/v0.4.3/development)](githut-commits-since)
![Tests](https://github.com/nobbmaestro/ray-cli/actions/workflows/tests.yml/badge.svg)
![License](https://img.shields.io/github/license/nobbmaestro/ray-cli)

Ray CLI is a command-line utility designed for generating and broadcasting DMX data over sACN.

## Installation

### Prerequisites

- Python 3.7+ is required.
- **_Optional_** For Pipx, ensure it is installed by running `pip install pipx`

### Pipx (Recommended)

```sh
pipx install ray-cli
```

### Pip

```sh
pip install ray-cli
```

### GitHub

```sh
git clone git@github.com:nobbmaestro/ray-cli.git
cd ray-cli
make install
```

## Usage

### Basic Example

To broadcast a ramp DMX signal to a specific IP address:

```sh
ray-cli 192.168.86.198 \
    --dst 192.168.86.67 \
    --mode chase \
    --universes 1 2 \
    --channels 24 \
    --fps 50 \
    --duration 60
```

### Complete List of Command-Line Options

```sh
usage: ray-cli [-m {chase,ramp,ramp-down,ramp-up,sine,square,static}] [-d DURATION]
               [-u UNIVERSES [UNIVERSES ...]] [-c CHANNELS] [-i INTENSITY]
               [-I INTENSITY_MIN] [-f FREQUENCY] [--fps FPS] [--dst DST] [-v] [-q]
               [--dry] [--purge] [-h] [-V]
               [IP_ADDRESS]

Command-line utility for generating and broadcasting DMX over sACN

positional arguments:
  IP_ADDRESS                                 IP address of the DMX source (default:
                                             192.168.86.204)

optional arguments:
  -m, --mode {chase,ramp,ramp-down,ramp-up,sine,square,static}
                                             DMX signal shape mode (default: ramp)
  -d, --duration DURATION                    broadcast duration in seconds (default:
                                             INDEFINITE)
  -u, --universes UNIVERSES [UNIVERSES ...]  sACN universe(s) to send to (range:
                                             1-63999, default: 1)
  -c, --channels CHANNELS                    DMX channels at universe to send to (range:
                                             1-512, default: 24)
  -i, --intensity INTENSITY                  DMX channels output intensity (range:
                                             1-255, default: 10)
  -I, --intensity-min INTENSITY_MIN          DMX channels minimum output intensity
                                             (range: 0-255, default: 0)
  -f, --frequency FREQUENCY                  frequency of the generated signal (default:
                                             1.0)
  --fps FPS                                  frames per second per universe (default:
                                             10)
  --dst DST                                  IP address of the dmx destination (default:
                                             MULTICAST)

display options:
  -v, --verbose                              run in verbose mode
  -q, --quiet                                run in quiet mode

operational options:
  --dry                                      simulate outputs without broadcast
  --purge                                    send zero-data on all channels and exit

query options:
  -h, --help                                 print help and exit
  -V, --version                              show program's version number and exit
```

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/nobbmaestro/ray-cli",
    "name": "ray-cli",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<4.0,>=3.8",
    "maintainer_email": null,
    "keywords": "dmx, sacn, cli, utility, python",
    "author": "Norbert Batiuk",
    "author_email": "norbert@batiuk.se",
    "download_url": "https://files.pythonhosted.org/packages/4c/5a/64bc711e6653370620981812a8834326c559524685d02bad14dee1bb4951/ray_cli-0.4.3.tar.gz",
    "platform": null,
    "description": "# Ray CLI\n\n[![GitHub Release](https://img.shields.io/github/v/release/nobbmaestro/ray-cli)](github-release)\n[![GitHub last commit](https://img.shields.io/github/last-commit/nobbmaestro/ray-cli/development)](github-last-commit)\n[![GitHub commits since](https://img.shields.io/github/commits-since/nobbmaestro/ray-cli/v0.4.3/development)](githut-commits-since)\n![Tests](https://github.com/nobbmaestro/ray-cli/actions/workflows/tests.yml/badge.svg)\n![License](https://img.shields.io/github/license/nobbmaestro/ray-cli)\n\nRay CLI is a command-line utility designed for generating and broadcasting DMX data over sACN.\n\n## Installation\n\n### Prerequisites\n\n- Python 3.7+ is required.\n- **_Optional_** For Pipx, ensure it is installed by running `pip install pipx`\n\n### Pipx (Recommended)\n\n```sh\npipx install ray-cli\n```\n\n### Pip\n\n```sh\npip install ray-cli\n```\n\n### GitHub\n\n```sh\ngit clone git@github.com:nobbmaestro/ray-cli.git\ncd ray-cli\nmake install\n```\n\n## Usage\n\n### Basic Example\n\nTo broadcast a ramp DMX signal to a specific IP address:\n\n```sh\nray-cli 192.168.86.198 \\\n    --dst 192.168.86.67 \\\n    --mode chase \\\n    --universes 1 2 \\\n    --channels 24 \\\n    --fps 50 \\\n    --duration 60\n```\n\n### Complete List of Command-Line Options\n\n```sh\nusage: ray-cli [-m {chase,ramp,ramp-down,ramp-up,sine,square,static}] [-d DURATION]\n               [-u UNIVERSES [UNIVERSES ...]] [-c CHANNELS] [-i INTENSITY]\n               [-I INTENSITY_MIN] [-f FREQUENCY] [--fps FPS] [--dst DST] [-v] [-q]\n               [--dry] [--purge] [-h] [-V]\n               [IP_ADDRESS]\n\nCommand-line utility for generating and broadcasting DMX over sACN\n\npositional arguments:\n  IP_ADDRESS                                 IP address of the DMX source (default:\n                                             192.168.86.204)\n\noptional arguments:\n  -m, --mode {chase,ramp,ramp-down,ramp-up,sine,square,static}\n                                             DMX signal shape mode (default: ramp)\n  -d, --duration DURATION                    broadcast duration in seconds (default:\n                                             INDEFINITE)\n  -u, --universes UNIVERSES [UNIVERSES ...]  sACN universe(s) to send to (range:\n                                             1-63999, default: 1)\n  -c, --channels CHANNELS                    DMX channels at universe to send to (range:\n                                             1-512, default: 24)\n  -i, --intensity INTENSITY                  DMX channels output intensity (range:\n                                             1-255, default: 10)\n  -I, --intensity-min INTENSITY_MIN          DMX channels minimum output intensity\n                                             (range: 0-255, default: 0)\n  -f, --frequency FREQUENCY                  frequency of the generated signal (default:\n                                             1.0)\n  --fps FPS                                  frames per second per universe (default:\n                                             10)\n  --dst DST                                  IP address of the dmx destination (default:\n                                             MULTICAST)\n\ndisplay options:\n  -v, --verbose                              run in verbose mode\n  -q, --quiet                                run in quiet mode\n\noperational options:\n  --dry                                      simulate outputs without broadcast\n  --purge                                    send zero-data on all channels and exit\n\nquery options:\n  -h, --help                                 print help and exit\n  -V, --version                              show program's version number and exit\n```\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Command-line utility for generating and broadcasting DMX over sACN",
    "version": "0.4.3",
    "project_urls": {
        "Homepage": "https://github.com/nobbmaestro/ray-cli",
        "Repository": "https://github.com/nobbmaestro/ray-cli"
    },
    "split_keywords": [
        "dmx",
        " sacn",
        " cli",
        " utility",
        " python"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f699792d435593ff67529ec5baf78df9fbb6ef0c065ef125f5fa7c2976967df7",
                "md5": "37067003a185a75ff0bbc1599f87db60",
                "sha256": "b8525daec8e91f533854575fd27fc752b07f93f0a9c0f4b21f37c78afb15d1a2"
            },
            "downloads": -1,
            "filename": "ray_cli-0.4.3-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "37067003a185a75ff0bbc1599f87db60",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<4.0,>=3.8",
            "size": 13107,
            "upload_time": "2025-02-11T21:05:33",
            "upload_time_iso_8601": "2025-02-11T21:05:33.718092Z",
            "url": "https://files.pythonhosted.org/packages/f6/99/792d435593ff67529ec5baf78df9fbb6ef0c065ef125f5fa7c2976967df7/ray_cli-0.4.3-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "4c5a64bc711e6653370620981812a8834326c559524685d02bad14dee1bb4951",
                "md5": "13303cd53ec13f10c55840aeaf7c7729",
                "sha256": "50fdb2accaa9ad6ae959989150d71a76d29833d0ecf0887c980e084cf5ebfd6e"
            },
            "downloads": -1,
            "filename": "ray_cli-0.4.3.tar.gz",
            "has_sig": false,
            "md5_digest": "13303cd53ec13f10c55840aeaf7c7729",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<4.0,>=3.8",
            "size": 10394,
            "upload_time": "2025-02-11T21:05:35",
            "upload_time_iso_8601": "2025-02-11T21:05:35.516196Z",
            "url": "https://files.pythonhosted.org/packages/4c/5a/64bc711e6653370620981812a8834326c559524685d02bad14dee1bb4951/ray_cli-0.4.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-02-11 21:05:35",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "nobbmaestro",
    "github_project": "ray-cli",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "tox": true,
    "lcname": "ray-cli"
}
        
Elapsed time: 2.96453s