Enterprise Deployment
Deploy Classroom Monitor with one Setup EXE via Active Directory Group Policy or Microsoft Intune. Same file as Force Update; no multi-file folder required.
Per-channel interactive install (Windows, browsers, Android): Setup guide.
On this page
One-file package
Download ClassroomMonitor-Setup from /downloads (or version-info.json setup_url / durable /downloads/installers/latest/setup.exe). An MSI is also published (msi_url / latest/setup.msi). Tip auto-update and Update / Downgrade use MSI when the client was MSI-installed; Setup installs keep Setup EXE.
/quiet /norestart INSTALLATION_TYPE=Student INSTALL_EXTENSION=1
- Student (lab): INSTALLATION_TYPE=Student
- Teacher (console): INSTALLATION_TYPE=Teacher
- Server: INSTALLATION_TYPE=Server
-
Browser extension force-install:
INSTALL_EXTENSION=1(or/InstallExtension). Student fresh install defaults ON; Teacher/Server default OFF. MSI: same property. PowerShell:downloads/gpo/Install-ClassroomMonitor.ps1 -InstallExtension.
Group Policy Deployment
Preferred: Computer Configuration Startup scripts with the one Setup EXE. Optional: native Software Installation can use the published MSI (msiexec INSTALLATION_TYPE=Student|Teacher|Server).
- Copy the Setup EXE to a share readable by Domain Computers (example: \\fileserver\Software\ClassroomMonitor\).
- Create a GPO linked to the computer OU.
- Computer Configuration β Policies β Windows Settings β Scripts (Startup/Shutdown) β Startup β Add the EXE (or a one-line .cmd that calls it).
- Parameters: /quiet /norestart INSTALLATION_TYPE=Student INSTALL_EXTENSION=1 (or Teacher / Server; omit or INSTALL_EXTENSION=0 to skip the browser extension).
- Scope Security Filtering, run gpupdate /force on a test PC, reboot, confirm Program Files\ClassroomMonitor and HKLM\SOFTWARE\NewsTargeted\ClassroomMonitor.
Install log: %ProgramData%\ClassroomMonitor\Logs\setup.log
Microsoft Intune Deployment
- Download the same Setup EXE (Win32 app package).
- Intune β Apps β Windows β Add β Windows app (Win32).
- Install command: ClassroomMonitor-Setup-vX.Y.Z.exe /quiet /norestart INSTALLATION_TYPE=Student INSTALL_EXTENSION=1
- Detect C:\Program Files\ClassroomMonitor\ClassroomMonitor.exe; assign to device groups.
Force-install Chrome and Edge extension (block Remove)
Students and teachers must not remove the Classroom Monitor browser extension without a valid
unlock / exit code (from the Teacher Console) or an
administrator / UAC / school policy change (GPO, Intune, MDM, or Setup clearing the policy).
Extension v1.1.8+ gates in-extension Stop on the unlock code.
Only browser enterprise policy with force_installed hides the stock Remove button on
chrome://extensions / edge://extensions.
What blocks what
| Action | Without force_installed | With force_installed (managed) |
|---|---|---|
| Stop in extension popup | Needs unlock / exit code | Same: unlock required |
| Disable toggle | User can often turn the extension off | Usually blocked (installType: admin) |
| Remove in browser extensions page | Remove stays visible; the extension cannot hide it | Remove hidden or blocked by the browser |
There is no separate Chromium policy named "prevent removal".
installation_mode: force_installed is what removes the user Remove control.
Store ID and sample JSON
- Extension ID:
mfckcopffcphadempnmcbagbnapdafhi - Update URL:
https://classroom.newstargeted.com/downloads/extensions/update.xml - Sample ExtensionSettings JSON: chrome-edge-extension-settings.json (merge with your other extensions; do not overwrite unrelated keys)
{
"mfckcopffcphadempnmcbagbnapdafhi": {
"installation_mode": "force_installed",
"update_url": "https://classroom.newstargeted.com/downloads/extensions/update.xml",
"override_update_url": true
}
}
Developer PCs that use Load unpacked get a different extension ID.
Force-install policies must target the ID shown on edge://extensions (or Chrome).
School Setup writes policies for the store ID after CRX force-install.
What Classroom Monitor Setup applies
Interactive Setup shows a checkbox:
Install browser extension for Chrome and Edge
(default ON for Student, OFF for Teacher/Server). Silent and GPO use
INSTALL_EXTENSION=1 / 0 (or /InstallExtension / /NoInstallExtension).
Preference is stored at
HKLM\SOFTWARE\NewsTargeted\ClassroomMonitor\InstallBrowserExtension.
When opted in, Setup (admin) runs the extension bridge (tip 1.5.8.26+; force-install guards from extension 1.1.8+):
ClassroomMonitor.exe --register-extension-bridge
That step registers (packed CRX / update.xml path):
- Native messaging host (HKCU, plus best-effort HKLM)
ExtensionInstallForcelistfor Chrome and EdgeExtensionSettingsmerge withinstallation_mode: force_installed- Optional InPrivate / incognito mandatory-extension lists (see school InPrivate policy notes)
Same-version reinstall (1.5.8.199+)
Operators can replace a published tip folder without bumping FileVersion when only content changes.
version-info.json carries sha256_installer and build_id.
After Setup/MSI installs, the client stores InstalledInstallerSha256.
Tray Check for updates treats the same version with a different tip hash as
Reinstall update and downloads again. Matching hashes stay Up to date.
Update-time heal (1.5.8.105+; Student default from 1.5.8.206)
On Check for Updates, Install Update Now, quiet Setup, silent ClassroomMonitorUpdate,
remote force_update, MSI upgrade, or PowerShell upgrade:
- If Chrome/Edge force-install for Classroom Monitor is missing, the client detects
that and re-applies Setup force-install when allowed
(
--heal-extension-force-install/ quiet Setup withINSTALL_EXTENSION=1). InstallBrowserExtension=1(or Teacher/Server already opted in): always heal when missing.- Student with preference unset: defaults ON so Allow List Only
and reliable Block List keep working after update; preference is written to
1after a successful heal. - Explicit
InstallBrowserExtension=0/INSTALL_EXTENSION=0: updates do not add the extension (school opt-out respected). - Heal failures (no admin, locked GPO) are logged and never crash the desktop update. Teacher/Server may see a tray note; Students stay silent.
- Presence checks cover packed CRX id
mfckcopffcphadempnmcbagbnapdafhi, Chrome Web Store idckbjmljglifaigcppogdilfefnhfdbpo, and Edge policy entries.
Daily classroom use does not need repeated UAC. Only Setup, update service, or an elevated heal touches HKLM. For silent lab deploy of the desktop client first, see Group Policy and Intune above. Sideload steps for testing: Setup guide (Chrome and Edge).
Microsoft Edge (registry / policy)
Root: HKLM\SOFTWARE\Policies\Microsoft\Edge
-
Set
ExtensionSettings(REG_SZ) to the merged JSON above (or deploy the same via Edge Administrative Templates β Configure extension settings). -
Optional legacy forcelist (Setup still sets this):
ExtensionInstallForcelist\1=mfckcopffcphadempnmcbagbnapdafhi;https://classroom.newstargeted.com/downloads/extensions/update.xml - Run
gpupdate /force(or wait for Intune sync), then openedge://policyand confirm both policies. - Open
edge://extensions: Classroom Monitor should show as installed by your organization, with no Remove.
Google Chrome (registry / policy)
Root: HKLM\SOFTWARE\Policies\Google\Chrome
Same keys as Edge:
ExtensionSettings(JSON above)ExtensionInstallForcelist\1(same forcelist string)
Confirm on chrome://policy and chrome://extensions.
GPO and Intune (extension only)
- Create or edit a GPO linked to student computer OUs (teachers may use a separate GPO without force-install).
- Computer Configuration β Administrative Templates β Microsoft Edge or Google Chrome.
- Enable Configure extension settings and paste the merged JSON.
- Enable Configure extension installation force list with the forcelist line above.
- Intune Settings catalog: use Control which extensions are installed silently / ExtensionSettings, plus the force-list entry. There is still no separate "prevent removal" toggle; force_installed is the control.
Unlock so Remove works again
- Teacher generates an unlock / exit code in the Teacher Console (same daily code flow as Android unlock).
- Student opens the extension popup β Unlock stop / uninstall and enters the code.
- With the desktop client present, the bridge can clear force-install registry entries for Classroom Monitor after a valid code so browser Remove becomes available again.
- Without a desktop client, unlock still allows Stop presence, but Remove may stay blocked until IT removes the policy.
Verification checklist
edge://policyorchrome://policy: ExtensionSettings contains the store ID withforce_installed- Extensions page: no Remove for Classroom Monitor (managed)
- Popup with presence on: Stop disabled until unlock
- Unmanaged Load unpacked: warning that the install is not force-installed; Remove still visible
Updates
After the first install, tip auto-update and Update / Downgrade use Setup EXE or MSI matching the install type. Replacing the share file and Startup path refreshes GPO deployments for new machines.