unity-activate
===

A tool to automate the manual activation of unity license using puppeteer.

Inspired by https://github.com/MizoTake/unity-license-activate (@MizoTake).

![npm](https://www.npmjs.com/package/unity-activate)
!license
!downloads
!release
![semantic-release](https://github.com/semantic-release/semantic-release)

Usage as a node module:

``sh npm install unity-activate`

`js const { ActivatorOptions, Activator } = require('unity-activate');

(async () => { new Activator({ file :'input.alf', username :'username', password :'password', authKey :'authenticator_key', serial :'serial_code', out :'output_dir', }).run(); })();`

`Usage as a command-line utility:`

`sh

`Installation:`


npm install -g unity-activate

`sh Usage: $ unity-activate [opts] <*.alf>

Activate Unity activation license file (Unity_v*.alf or Unity_lic.alf) NOTE: If two-factor authentication is enabled, the verify code will be requested.

Options: -o, --out

              Output ulf file to the specified directory (default: .)
  -u, --username     Username (email) to login Unity (default: $UNITY_USERNAME)
  -p, --password     Password to login Unity (default: $UNITY_PASSWORD)
  -k, --key               The authenticator key to login (default: $UNITY_KEY).
  -s, --serial         Serial key to activate (default: $UNITY_SERIAL). If empty, activate as personal license.
NOTE: Unity Personal Edition is not available to companies or organizations that earned more than USD100,000 in the previous fiscal year.
 
  -d, --debug                  Display additional log and dump content to 'error.html' on error (default: false)
  --headful                    Run "headful" puppeteer (default: false)
  -h, --help                   Display this message 
  -v, --version                Display version number




$3
Create a license activation file and import license file by command.

`sh

`On Windows:`


$ "C:\Program Files\Unity\Editor\Unity.exe" -batchmode -createManualActivationFile
On macOS:

$ /Applications/Unity/Unity.app/Contents/MacOS/Unity -batchmode -createManualActivationFile

Or, with UnityHub (Settings > License Management > MANUAL ACTIVATION > SAVE LICENSE REQUEST).

![](https://user-images.githubusercontent.com/12690315/103255736-d4aa8380-49cd-11eb-9701-ff787e38a9f1.png)

`$3`

Run unity-activate to download the *.ulf file.

`sh

`For personal license (with interaction):`


$ unity-activate *.alf
$   > enter the username and password
$ username: your@email.com
$ password: *
...
For personal license:

$ unity-activate --username your@email.com --password your_password *.alf
For professional license (with --serial option):

$ unity-activate --username your@email.com --password your_password --serial your_serial_code *.alf
Use environment variables instead of options:

$ export UNITY_USERNAME=your@email.com
$ export UNITY_PASSWORD=your_password
$ export UNITY_SERIAL=your_serial_code # If empty, activate as personal license.
$ unity-activate *.alf




$3
Now that you have your license file, you can activate your Unity account by command.

`sh

`On Windows:`


$ "C:\Program Files\Unity\Editor\Unity.exe" -batchmode -manualLicenseFile *.ulf
On macOS:

$ /Applications/Unity/Unity.app/Contents/MacOS/Unity -batchmode -manualLicenseFile *.ulf


Or, with UnityHub.
![](https://user-images.githubusercontent.com/12690315/103255739-d70cdd80-49cd-11eb-9d18-62600a20085f.png)


$3
Signing in to Unity requires authentication via email or a authenticator app (eg. Google Authenticator).
You can use an authenticator key instead of those.

`sh $ unity-activate --username your@email.com --password your_password --key your_authenticator_key *.alf`

#### How to obtain authenticator key

- Login to Unity account and activate new two factor authentication. Go to https://id.unity.com/en/settings/tfa/new and clickStart setup![](https://user-images.githubusercontent.com/12690315/133873890-7bdeb10d-2bde-497b-83e0-2c3586e526ad.png) - SelectAuthenticator App and click Next![](https://user-images.githubusercontent.com/12690315/133873893-e1894f2b-67d3-4b7a-877f-70c9613cba24.png) - ClickCan't scan the barcode?`.
Find and save the authenticator key
![](https://user-images.githubusercontent.com/12690315/133878441-19553b38-3bd5-492f-a27a-6974923b4add.png)
- Verify activation with Google Authenticator. You can also verify using a QR code
![](https://user-images.githubusercontent.com/12690315/133878444-0f11a58b-9a4f-4f0e-9856-a33bfa243eaa.png)

Contributing

$3

Issues are very valuable to this project.

- Ideas are a valuable source of contributions others can make
- Problems show where this project is lacking
- With a question you show where contributors can improve the user experience

$3

Pull requests are, a great way to get your ideas into this repository.

$3

This is an open source project that I am developing in my spare time.
If you like it, please support me.
With your support, I can spend more time on development. :)

![](https://github.com/users/mob-sakai/sponsorship)

License

* MIT

Author

* ![](https://user-images.githubusercontent.com/12690315/96986908-434a0b80-155d-11eb-8275-85138ab90afa.png) mob-sakai ![](https://twitter.com/intent/follow?screen_name=mob_sakai) !GitHub followers

Usage as a node module:

``sh npm install unity-activate`

`js const { ActivatorOptions, Activator } = require('unity-activate');

(async () => { new Activator({ file :'input.alf', username :'username', password :'password', authKey :'authenticator_key', serial :'serial_code', out :'output_dir', }).run(); })();`

`Usage as a command-line utility:`

`sh

`Installation:`


npm install -g unity-activate

`sh Usage: $ unity-activate [opts] <*.alf>

Activate Unity activation license file (Unity_v*.alf or Unity_lic.alf) NOTE: If two-factor authentication is enabled, the verify code will be requested.

Options: -o, --out

              Output ulf file to the specified directory (default: .)
  -u, --username     Username (email) to login Unity (default: $UNITY_USERNAME)
  -p, --password     Password to login Unity (default: $UNITY_PASSWORD)
  -k, --key               The authenticator key to login (default: $UNITY_KEY).
  -s, --serial         Serial key to activate (default: $UNITY_SERIAL). If empty, activate as personal license.
NOTE: Unity Personal Edition is not available to companies or organizations that earned more than USD100,000 in the previous fiscal year.
 
  -d, --debug                  Display additional log and dump content to 'error.html' on error (default: false)
  --headful                    Run "headful" puppeteer (default: false)
  -h, --help                   Display this message 
  -v, --version                Display version number




$3
Create a license activation file and import license file by command.

`sh

`On Windows:`


$ "C:\Program Files\Unity\Editor\Unity.exe" -batchmode -createManualActivationFile
On macOS:

$ /Applications/Unity/Unity.app/Contents/MacOS/Unity -batchmode -createManualActivationFile

Or, with UnityHub (Settings > License Management > MANUAL ACTIVATION > SAVE LICENSE REQUEST).

![](https://user-images.githubusercontent.com/12690315/103255736-d4aa8380-49cd-11eb-9701-ff787e38a9f1.png)

`$3`

Run unity-activate to download the *.ulf file.

`sh

`For personal license (with interaction):`


$ unity-activate *.alf
$   > enter the username and password
$ username: your@email.com
$ password: *
...
For personal license:

$ unity-activate --username your@email.com --password your_password *.alf
For professional license (with --serial option):

$ unity-activate --username your@email.com --password your_password --serial your_serial_code *.alf
Use environment variables instead of options:

$ export UNITY_USERNAME=your@email.com
$ export UNITY_PASSWORD=your_password
$ export UNITY_SERIAL=your_serial_code # If empty, activate as personal license.
$ unity-activate *.alf




$3
Now that you have your license file, you can activate your Unity account by command.

`sh

`On Windows:`


$ "C:\Program Files\Unity\Editor\Unity.exe" -batchmode -manualLicenseFile *.ulf
On macOS:

$ /Applications/Unity/Unity.app/Contents/MacOS/Unity -batchmode -manualLicenseFile *.ulf


Or, with UnityHub.
![](https://user-images.githubusercontent.com/12690315/103255739-d70cdd80-49cd-11eb-9d18-62600a20085f.png)


$3
Signing in to Unity requires authentication via email or a authenticator app (eg. Google Authenticator).
You can use an authenticator key instead of those.

`sh $ unity-activate --username your@email.com --password your_password --key your_authenticator_key *.alf`

#### How to obtain authenticator key

Contributing

$3

Issues are very valuable to this project.

- Ideas are a valuable source of contributions others can make
- Problems show where this project is lacking
- With a question you show where contributors can improve the user experience

$3

Pull requests are, a great way to get your ideas into this repository.

$3

This is an open source project that I am developing in my spare time.
If you like it, please support me.
With your support, I can spend more time on development. :)

![](https://github.com/users/mob-sakai/sponsorship)

License

* MIT

Author

* ![](https://user-images.githubusercontent.com/12690315/96986908-434a0b80-155d-11eb-8275-85138ab90afa.png) mob-sakai ![](https://twitter.com/intent/follow?screen_name=mob_sakai) !GitHub followers

unity-activate

Usage as a node module:

Usage as a command-line utility:

Installation:

$3

On Windows:

On macOS:

$3

For personal license (with interaction):

For personal license:

For professional license (with --serial option):

Use environment variables instead of options:

$3

On Windows:

On macOS:

$3

Contributing

$3

$3

$3

License

Author

See Also

unity-activate

Usage as a node module:

Usage as a command-line utility:

Installation:

$3

On Windows:

On macOS:

$3

For personal license (with interaction):

For personal license:

For professional license (with --serial option):

Use environment variables instead of options:

$3

On Windows:

On macOS:

$3

Contributing

$3

$3

$3

License

Author

See Also

Dist Tags

`Usage as a command-line utility:`

`Installation:`

`On Windows:`

`$3`

`For personal license (with interaction):`

`On Windows:`

`Usage as a command-line utility:`

`Installation:`

`On Windows:`

`$3`

`For personal license (with interaction):`

`On Windows:`