Metadata-Version: 2.1
Name: Ultimarc
Version: 1.0.0a5
Summary: Tools for configuring Ultimarc USB devices
Home-page: https://github.com/katie-snow/QtPyUltimarc
Author: Katie Snow
Author-email: snowywhitewater@gmail.com
License: GNU General Public License v3 (GPLv3)
Project-URL: Homepage, https://github.com/katie-snow/QtPyUltimarc
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Environment :: Console
Classifier: Environment :: X11 Applications :: Qt
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Games/Entertainment :: Arcade
Classifier: Topic :: System :: Hardware :: Universal Serial Bus (USB)
Requires-Python: >=3.7
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: babel>=2.12.1
Requires-Dist: libusb>=1.0.26b5
Requires-Dist: jsonschema>=4.17.3
Requires-Dist: python-easy-json>=1.1.2
Provides-Extra: ui
Requires-Dist: pyside6>=6.5.0; extra == "ui"

|badge1| |badge2| |badge3|

.. |badge1| image:: https://github.com/katie-snow/QtPyUltimarc/actions/workflows/tests.yaml/badge.svg
  :alt: Unittest Completion Status
.. |badge2| image:: https://raw.githubusercontent.com/katie-snow/QtPyUltimarc/coverage-badge/coverage.svg?raw=true
  :alt: Code Coverage Status
.. |badge3| image:: https://img.shields.io/badge/python-v3.7%20|%20v3.8%20|%20v3.9%20|%20v3.10%20|%20v3.11-blue
  :alt: Python v3.7, v3.8, v3.9, v3.10, v3.11


****************************************************************************************
Python Ultimarc Tools: Python tools for managing Ultimarc devices
****************************************************************************************

The **Python Ultimarc** tools are a pure python implementation and cross platform set of command line tools, graphical
tool and python library for managing Ultimarc USB arcade devices, for more information about Ultimarc devices
visit https://www.ultimarc.com.

Get It Now
==========

To install only the command line tools, run:
::

    $ pip install ultimarc

To install both the command line and graphical tools, run:
::

    $ pip install ultimarc[ui]


Graphical Tool
==============

To launch the graphical configration tool, run:
::

    $ ultimarc-ui

The graphical tool supports managing plugged in devices, along with creating and editing configuration files for
unplugged devices.


Command Line Tools
==================

The command line tools are a set of tools to inspect and manage different Ultimarc devices. The tools are launched by
executing '**ultimarc**' in a terminal command window. To view the available tool commands, run the tool with the
'--help' argument:
::

    $ ultimarc --help

    usage: python -m tools [command] [-h|--help] [args]

    available commands:
      ipac2          : Manage ipac2 devices
      ipac4          : Manage ipac4 devices
      jpac           : Manage jpac devices
      list           : list all attached ultimarc devices
      mini-pac       : Manage Mini-pac devices
      usb-button     : manage usb-button devices.

To view the help for a specific tool, add the tool name and use the '--help' argument:
::

    $ ultimarc list --help

    usage: list [-h] [--debug] [--log-file] [-q] [--bus BUS] [--address ADDRESS] [-c CLASS_ID] [-d]

    list all attached ultimarc devices

    optional arguments:
      -h, --help            show this help message and exit
      --debug               enable debug output
      --log-file            write output to a log file
      -q, --quiet           suppress normal output
      --bus BUS             filter by usb device bus number
      --address ADDRESS     filter by usb device address number
      -c CLASS_ID, --class-id CLASS_ID
                            filter by device class id
      -d, --descriptors     Show device descriptor values.

    class ids: usb-button,aimtrak,mini-pac,ipac2,ipac4,jpac


Project Links
=============

- PyPI: https://pypi.python.org/pypi/python-easy-json
- Issues: https://github.com/katie-snow/QtPyUltimarc/issues

License
=======

GPL-3.0 licensed. See the bundled `LICENSE <https://github.com/katie-snow/QtPyUltimarc/blob/main/LICENSE>` file for more details.
