Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Unittest Completion Status Code Coverage Status Python v3.9, v3.10, v3.11, v3.12, v3.13 OS Support Linux, Mac OS, MS Windows

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. Both the CLI and UI tools run on Linux, Mac OS and MS Windows.

For more information about Ultimarc devices visit https://www.ultimarc.com.

Supported Ultimarc Devices

Ultimarc Device

CLI Support

UI Support

J-PAC

Yes

Yes

I-PAC2

Yes

Yes

I-PAC4

Yes

Yes

MINI-PAC

Yes

Yes

USB Button

Yes

Yes

Ultimate I/O

Yes

No

UltraStik 360 Joystick

Yes

No

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]

Installing on Windows

Install Python 3 from Python.org. The Python available through the Microsoft Store doesn’t have all the required dll’s to run the Graphical Tool.

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

Udev Support

For Udev support for Ultimarc devices, copy the file ‘ultimarc/udev/95-ultimarc.rules’ to the /etc/udev/rules.d folder.

License

GPL-3.0 licensed. See the bundled LICENSE file for more details.

Metadata

Release files for Ultimarc 1.0.0a9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for Ultimarc 1.0.0a9
File Size Uploaded Provenance Actions
ultimarc-1.0.0a9.tar.gz 227.1 kB Without provenance Details for ultimarc-1.0.0a9.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for Ultimarc 1.0.0a9
File Interpreter ABI Platform Actions
ultimarc-1.0.0a9-py3-none-any.whl Python 3 none any Details for ultimarc-1.0.0a9-py3-none-any.whl

Total release size: 512.5 kB

Release files / ultimarc-1.0.0a9.tar.gz

Download URL ultimarc-1.0.0a9.tar.gz
Size 227.1 kB
Tags Source
SHA-256 checksum
How to use checksums
0408d3adb1324b6a9fb488032ce1a2500d51f84c636ad9d0975918be77698a01
BLAKE2b-256 checksum
How to use checksums
a2fd54c1659bc375d186e3cf856c58cc3b323226d9baa7944682f72d80f8a616
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.9

Release files / ultimarc-1.0.0a9-py3-none-any.whl

Download URL ultimarc-1.0.0a9-py3-none-any.whl
Size 285.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6e88c423e0142933b8c8325342bad8b1775d3f55fea3f3a154e57ccda7b4621e
BLAKE2b-256 checksum
How to use checksums
b96887a2c31622df71be870bdb90b6a07a58bc7fde414c55460533cc901518ea
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.9

Security for Ultimarc 1.0.0a9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page