How To Use The mx1 Tool

Maddie
Maddie
  • Updated

The mx1 tool is shipped with the Maxon App installer on Mac and Windows. It's also included on Linux since Maxon App 2.0. The mx1 tool 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

 

How to use mx1:

Mac:

  1. Launch Terminal
  2. cd to the Maxon App Tools folder 

    cd /Library/Application\ Support/Maxon/Tools 

  3. 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
    cd C:\Program Files\Maxon\Tools
  3. 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
    cd /opt/maxon/maxon_app/bin
  3. 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 *
user logout Log out of an account
user info Display the account user info.
user queryOptin It will return the optin status for analytics and trial communication consent
license list List 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_name Release a license from a machine **
user refresh Refreshes the user account
service info Show the Maxon service info. 
service stop Stop the service
service start Start the service
service restart Restart the service
license trial query Show the Maxon One trial status
license trial start Start a Maxon One trial
product list Show the list of the installed products 
product info product_identifier Show 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_identifier Deactivate 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

We also support user-friendly name mappings:

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

e.g.,

mx1 package download vfx 

mx1 package download c4d -v 26.013

--help How to use the mx1 tool

* 1, to hide the password, press Enter after entering the username. 2, mx1 login does not work for LDAP users. 3, If your password has special character on Mac (such as spaces or $), you will need to enclose it in quotes. 4, mx1 cannot log into MyMaxon accounts with SSO or MFA enabled

** use mx1 license list to get the license name

*** use mx1 product list to get the product name

Was this article helpful?

/

Comments

0 comments

Article is closed for comments.