# Yet Another Office Click-To-Run Installer

## Intro

* A mostly automated script(s) to install Office Click-to-Run from an offline source without using Office Deployment Tool (setup.exe), which allow bypassing ODT restrictions

* Support installing Product Suites or Single Apps individually

* Support installing multiple languages separately or together

* Support configuration options like the ones available with ODT, including:  
- Source Path  
- Excluding Apps  
- Update Channel  
- Miscellaneous Options (Display Level, Updates Enabled, Eula, Pin Icons, App Shutdown, Auto Activate)

* Includes a proper workaround to install Office 2019 on Windows 7 and 8.1 with working updates

* There are two flavors available of the scripts:

- YAOCTRI - Volume  
install volume products for Office 2019 only, in addition to the special SKUs O365ProPlus and Mondo

- YAOCTRIR - Retail  
install retail products for Microsoft 365 / Office 2016 / Office 2019 Suites, in addition to Office 2019 Single Apps

* Each flavor consist of two command scripts:

- Configurator.cmd  
the main script which is used to select products and installation options  
it also creates configuration ini files, with the ability to start the installation at the end  

- Installer.cmd  
the secondary script which is only used to execute the installation, depending on the already created the configuration ini file

* Office C2R source files are universal, and contain all possible products, any SKU can be installed from the same source  
https://docs.microsoft.com/office365/troubleshoot/installation/product-ids-supported-office-deployment-click-to-run

* Starting MAY 2020, Office 365 products are being renamed to Microsoft 365, keeping the same SKU names and included apps:  
https://docs.microsoft.com/en-us/deployoffice/name-change

SKU ID                 | Old Name                  | New Name  
---------------------- | ------------------------- | -------------------------------  
O365ProPlusRetail      | Office 365 ProPlus        | Microsoft 365 Enterprise  
O365BusinessRetail     | Office 365 Business       | Microsoft 365 Business  
O365SmallBusPremRetail | Office 365 Small Business | Microsoft 365 Business Standard  
O365HomePremRetail     | Office 365 Home           | Microsoft 365 Family  
O365EduCloudRetail     | Office 365 Education      | Microsoft 365 Education

* If you are using Office C2R for the first time or you are confused with the different products, the most recommended choices are:  
Product: Microsoft 365 Enterprise  
Channel: Current / Monthly

______________________________

## How To

* Run YAOCTRI_Configurator.cmd or YAOCTRIR_Configurator.cmd as administrator and follow the prompts

- For each menu, press the corresponding number or letter beside an option to change its state or proceed

- To exit at any menu press X (Version/Arch/Lang/Type menus have no return option, only proceed or exit)

- At first, enter the path for Office offline source

either the drive, directory or network share that contain "Office" folder (not Office folder path itself)

Configurator.cmd will auto detect the path for the drive letter of Office .img file (virtual mounted / dvd / usb)

if Configurator.cmd is placed inside "Office" folder, the path will be auto-detected

if Configurator.cmd is placed next to "Office" folder, the path will be auto-detected

- If multiple versions are detected in the source, you will be prompted to choose one

- If the current OS is x64, and multi-architecture Office 64-bit/32-bit is detected, you will be prompted to choose one

- If multiple languages are detected in the specified version, you will be prompted to choose one, or all

- If you chose all languages, you will be prompted to choose the primary language  
(which determines the setup and Office Shell UI culture, including shortcuts, right-click context menus, and tooltips)

- Select the installation type: complete product suites, or single apps separately

- If you selected a product suite, you will get a menu to exclude (turn OFF) unneeded apps

- Select the desired Update Channel

- Change the Miscellaneous Options to your needs

- In the end, you will have three options:

1. Install Now  
start normal installation now with the selected options (C2R_Config ini will be created too)

2. Create setup configuration (Normal Install)  
create C2R_Config ini file, to be used later with Installer.cmd

3. Create setup configuration (Auto Install)  
create C2R_Config ini file with the unattended option, which allow Installer.cmd to start the installation immediately

______________________________

## Remarks

* If Configurator.cmd runs from a read-only path (e.g. DVD or network share), C2R_Config ini file will be created on the Desktop

* When using Installer.cmd, if Office SourcePath does not exist, the script will try to auto-detect alternative path, similar to Configurator.cmd

* YAOCTRIR - Retail flavor is recommended only if you have actual retail/subscription key

but you can still use it to install Retail SKUs, then use C2R-R2V to convert licensing to volume

* The workaround to install Office 2019 on Windows 7/8.1 requires installing corresponding Office 2016 products, and corresponding Office 2019 licenses

therefore, the underlying Product IDs and entries in "Program and Features" will be always Office 2016, but Office 2019 licenses will determine the features

* For YAOCTRI - Volume flavor, if you choose "Microsoft 365 Enterprise" along with Project 2019 and/or Visio 2019,

Mondo licenses used for volume conversion will take precedence over Project/Visio licenses (this is a limitation in Office itself, not the script)

a better choice would be to select Mondo directly, which include Project/Visio

* Disable Telemetry option is not processed for "Microsoft 365" suites because it affects features

* Auto Activate option has no effect in YAOCTRIR - Retail flavor

* Auto Activate option in YAOCTRI - Volume flavor will work only in these scenarios:

- on Windows 10 or 8.1:  
the system is KMS activated with an external online KMS server, or SppExtComObjHook is installed (or similar KMS service solutions)

- on Windows 7:  
SppExtComObjHook is installed, or external online KMS server is added manually to OSPP registry  
'HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\OfficeSoftwareProtectionPlatform'

* The script will not check or detect already installed Office products (C2R or MSI) before installation

while it is possible to install Office C2R on the top of already installed C2R, it is advisable to start clean

* If you want to update Office manually, set Updates option to False,  
then, you can execute this in command prompt as administrator to update Office:

"%CommonProgramFiles%\Microsoft Shared\ClickToRun\OfficeC2RClient.exe" /update user updatepromptuser=True displaylevel=True

______________________________

## Windows 7 Limited Support

* Since the support for Windows 7 had ended on 2020-01-14, Office C2R on Windows 7 will only receive security updates until January 2023

* Because of that, almost all Office channels will offer a specific build targeted for Windows 7

* You cannot choose a build targeted for Windows 8.1 and 10, to be installed on Windows 7

* For more information:  
https://docs.microsoft.com/DeployOffice/windows-7-support

______________________________

## Channels Overview

* Frequent update channels:

1. Beta / Insider Fast

gets frequent updates with new features, improvements, and fixes as soon as possible  
it receives multiple builds per month

2. Current / Monthly Preview

formerly known as Insider Slow / Monthly Targeted / First Release for Current

gets new features and improvements at least once a month, in addition to important fixes as a preview for production  
it receives multiple builds per month

3. Current / Monthly

gets new features and quality fixes as soon as they are ready for production  
it can receive more than one build per month, as needed

* Business stable channels:

4. Monthly Enterprise

new channel since May 2020

gets new features/quality/security updates once a month  
it receives only one build a month, on the second Tuesday of the month (Patch Tuesday)

5. Semi-Annual Preview

formerly known as Semi-Annual Targeted / First Release for Business  
provides the same new features four months before Semi-Annual channel

gets new features updates twice a year (in March and September), in addition to quality/security updates once a month  
it receives only one build a month, on the second Tuesday of the month (Patch Tuesday)

6. Semi-Annual

formerly known as Broad / Deferred / Business

gets new features updates twice a year (in January and July), in addition to quality/security updates once a month  
it receives only one build a month, on the second Tuesday of the month (Patch Tuesday)

* Office 2019 Volume channels:

7. Perpetual2019 VL

the official update channel for volume licensed products of Office 2019 (although, it can work from any other channel)  
it only gets security and quality fixes once a month (Patch Tuesday)

8. Microsoft Perpetual

internal preview channel for Perpetual2019 VL channel

* Testing channels:

D. DevMain Channel

the most frequent channel for Office builds as soon as they are compiled, providing new features/improvements/fixes or even new bugs and issues

E. Microsoft Elite

the second most frequent channel for Office builds as soon as they are tested  
it mostly aligns with Beta channel and works as an internal preview for it

______________________________

## Behind the scenes

* YAOCTRI - Volume flavor:

- Microsoft 365 Enterprise will be installed as Retail SKU, then converted with Mondo 2016 Volume licenses  
additionally, O365ProPlusRetail grace key will be installed to enable more features

- On Windows 10:  
all other products will be installed directly as Volume SKUs

- On Windows 7/8.1:  
Office Mondo 2016 will be installed directly as Volume SKU  
all other products will be installed as Office 2016 Retail SKUs, then converted with Office 2019 Volume licenses

* YAOCTRIR - Retail flavor:

- On Windows 10:  
all products will be installed directly as Retail SKUs

- On Windows 7/8.1:  
all Microsoft 365 and Office 2016 products will be installed directly as Retail SKUs  
Office 2019 products will be installed as Office 2016 Retail SKUs, then converted with Office 2019 Retail licenses

______________________________

## Special Thanks

@ratzlefatz     / OfficeRTool  
@Krakatoa       / WOTOK  
@presto1234     / code improvements suggestion  
@Windows_Addict / features suggestion and testing  
@Enthousiast    / reporting and testing
