How to use the MX1 Tool

Maddie
Maddie
  • Updated

The mx1 tool is shipped with the Maxon App installer and offers abilities such as logging in or out of an account, assigning or releasing a license via the the command line. 

The mx1 tool install location:

Mac: /Library/Application Support/Maxon/Tools/

Windows: C:\Program Files\Maxon\Tools\

Linux: opt/maxon/maxon_app/bin/

To access the mx1 tool:

  • Mac
    1. Launch Terminal
    2. cd to the Maxon App Tools folder 
    3. cd to /Library/Application Support/Maxon/Tools/
    4. Type ./mx1 then the command, e.g., ./mx1 user login -u test@mail.com -p 12345
  • Windows
    1. Open Command Prompt
    2. cd to the Maxon App Tools folder
    3. cd C:\Program Files\Maxon\Tools\
    4. type mx1 then the command, e.g., mx1 license assign net.maxon.license.app.bundle_maxonone-release~commercial
  • Linux
    1. Open Terminal
    2. cd to the bin folder
    3. cd /opt/maxon/maxon_app/bin/
    4. type ./mx1 then the command, e.g., ./mx1 user logout

List of the commands:

command
what it does
user login -u user_email -p password

Log into an account by entering the email and the account password. 

  • To hide the password, press Enter after entering the username.
  • mx1 login does not work for LDAP users.
  • If your password has special character on Mac (such as spaces or $), you will need to enclose it in quotes. 
  • mx1 cannot log into MyMaxon accounts with SSO or MFA enabled.
user logoutLog out of an account
user infoDisplay the account user info
user queryOptinIt will return the optin status for analytics and trial communication consent
license listList the the licenses a user has
license assign license_name

Assign a license to a machine 

example:  mx1 license activate net.maxon.license.app.zbrush~commercial

license release license_nameRelease a license from a machine
user refreshRefreshes the user account
service infoShow the Maxon service info
service stopStop the service
service startStart the service
service restartRestart the service
license trial queryShow the Maxon One trial status
license trial startStart a Maxon One trial
product listShow the list of the installed products 
product info product_identifierShow the detailed info on a installed product
product activate product_identifier

Activate a product's license

example: mx1 product activate com.redgiant.magicbullet

This will assign whichever license has Magic Bullet in it i.e. Maxon One, Red Giant Complete.  Note that only one license type can be in the account but there can be multiples of that type e.g. two or more Maxon One licenses.

Also supports user-friendly name mappings as seen below.

product deactivate product_identifierDeactivate a product's license
package download product_identifier -v version - p platform

Downloads an installer to the current directory

examples:
mx1 package download net.maxon.maxonapp-installer -p linux 
mx1 package download com.redgiant.trapcode-installer -v 17.1 -p macos
mx1 package download com.redshift3d.redshift-installer -p windows

User-friendly name mappings are also supported:

  • trapcode = com.redgiant.trapcode-installer
  • magicbullet = com.redgiant.magicbullet-installer
  • vfx = com.redgiant.vfx-installer
  • pluraleyes= com.redgiant.pluraleyes-installer
  • universe = com.redgiant.universe-installer
  • cinema4d = net.maxon.cinema4d-installer
  • c4d = net.maxon.cinema4d-installer
  • cinema = net.maxon.cinema4d-installer
  • redshift = com.redshift3d.redshift-installer
  • rs = com.redshift3d.redshift-installer
  • zbrush = net.maxon.zbrush-installer
  • z = net.maxon.zbrush-installer

examples:

mx1 package download vfx 

mx1 package download c4d -v 26.013

--helpHow to use the mx1 tool

Was this article helpful?

/

Comments

0 comments

Article is closed for comments.