Junox Beta
Download Junox Beta
Version 1.0.1
Junox is a Google Chrome extension. Download the ZIP, then follow the steps below to load it into Chrome.
Installation takes about 2 minutes.
Requires Google Chrome 116 or newer.
- Version
- 1.0.1
- File size
- 462 KB (junox-beta-v1.0.1.zip)
- Released
- Released
- SHA-256
6d9c34f392961cdfd591132f5701dcc437326f5535dec79005a23d84e24ffe77- Optional: compare this with the file you downloaded to check it arrived intact.
Install Junox in Chrome
Follow these in order. Downloading the file doesn’t install it yet — Chrome needs you to load the folder once.
Step 1 of 11
Step 1: Download the ZIP
Click Download Junox Beta above. Chrome saves a file called junox-beta-v1.0.1.zip.
Use Google Chrome
Download and install with Chrome. Junox is a Chrome extension; Safari, Firefox and others can’t load it.
Step 2 of 11
Step 2: Find the ZIP file
Open the folder where Chrome saved the download.
- Windows
- Open File Explorer and go to Downloads.
- macOS
- Open Finder and click Downloads in the sidebar.
Downloaded with Safari?
Safari may unzip files automatically. To avoid confusion, download the ZIP again in Chrome.
Step 3 of 11
Step 3: Extract the ZIP
The ZIP contains one folder, junox-beta-v1.0.1, with manifest.json inside it. Unzip it, then — before you load it into Chrome — move the extracted folder somewhere permanent, like your Documents folder. Chrome runs Junox from this folder.
- Windows
- Right-click the ZIP and choose Extract All…, then Extract. By default it extracts into Downloads, usually inside another folder with the same name: junox-beta-v1.0.1 → junox-beta-v1.0.1 → manifest.json. Move the extracted folder to Documents.
- macOS
- Double-click the ZIP. A junox-beta-v1.0.1 folder appears next to it in Downloads, with manifest.json inside. Drag that folder to Documents.
Warning: Choose the folder’s home now
Don’t delete, move or rename this folder after installing. Chrome loads Junox from it, so deleting it removes Junox’s files and moving or renaming it breaks Junox until you load it again.
Using Chrome on Linux?
Everything works the same way: extract the ZIP with your file manager, keep the folder somewhere permanent, and follow the same steps in Chrome.
Step 4 of 11
Step 4: Open Google Chrome
Junox needs Chrome 116 or newer. To check, open the ⋮ menu → Help → About Google Chrome.
Step 5 of 11
Step 5: Go to the Extensions page
Copy this address, paste it into Chrome’s address bar and press Enter.
chrome://extensionsFor security, Chrome doesn’t let websites link to chrome:// pages, so it has to be typed or pasted.
- Or use the menu: ⋮ → Extensions → Manage Extensions.
Step 6 of 11
Step 6: Turn on Developer mode
Switch on the Developer mode toggle in the top-right corner of the Extensions page.
Why Developer mode?
It’s how Chrome lets you install an extension from a folder instead of the Chrome Web Store. Leave it on while you use the beta.
Step 7 of 11
Step 7: Click Load unpacked
A new row of buttons appears at the top-left once Developer mode is on. Click Load unpacked.
Step 8 of 11
Step 8: Select the extracted folder
In the window that opens, choose the junox-beta-v1.0.1 folder that has manifest.json directly inside it, and click Select (or Open — the button name depends on your computer).
Warning: Do not select the ZIP
Chrome can’t load a ZIP file. Pick the extracted folder. On Windows, the first junox-beta-v1.0.1 folder you see usually has a second junox-beta-v1.0.1 folder inside it — select that inner one, because it’s the one with manifest.json.
Window opened somewhere else?
Chrome often opens this window in the last folder you used, not where you saved Junox. Go to the folder you moved junox-beta-v1.0.1 to (for example Documents) before you click Select.
Step 9 of 11
Step 9: Check that Junox appears
A Junox card shows up in your list of extensions with its version number. Make sure its switch is on.
Warning: Keep the folder
Chrome runs Junox from the folder you selected. If you later delete, move or rename it, Junox stops working. Leave it where you put it in step 3.
Step 10 of 11
Step 10: Pin Junox to the toolbar
Click the puzzle-piece Extensions icon next to the address bar, find Junox, and click the pin so its icon stays visible.
Step 11 of 11
Step 11: Finish setup and open Junox
The first time Junox is installed, Chrome opens the Junox Settings page in a new tab.
AI: nothing to set up
Junox AI is selected by default. You don’t need an account or an API key.
Canvas only: add your Canvas site
Only needed if you use Canvas, so Junox can open and Auto Analyze your lessons automatically. Under “1 Your Canvas site”, enter your school’s Canvas address (for example myschool.instructure.com) and click “Add & allow”. Chrome asks to “Read and change your data on” that site: click Allow. Then reload any Canvas tabs you already had open. Not using Canvas? Skip this — on any other site, just open Junox from the toolbar or with Alt+Shift+S. It’s fine if the “Add your Canvas address” item in Junox’s Getting started list stays unticked.
Check that it works
Under “2 AI provider”, click Check connection. Junox shows “Checking… (the server can take up to a minute to wake up)” — the first check can take up to a minute while the server wakes up. Then you should see “✓ Junox AI is ready (50 AI requests per day).” During the beta, Junox AI allows 50 AI requests per day for each install; the count resets at midnight UTC.
Open Junox
Click the Junox icon in the toolbar, or press Alt+Shift+S, to open or close the sidebar. Use the Study Guide tab for a guide to the lesson, Explain for text you highlight, and Ask Junox for your own questions. Junox can’t open on Chrome’s own pages (like chrome://extensions) or the Chrome Web Store.
Optional: use your own AI
Prefer Ollama on your computer or an OpenAI-compatible API with your own key? Choose it under “2 AI provider” and click Test Connection — Chrome will ask for access to that address.
Why does Junox need these permissions?
These come straight from Junox’s manifest. Site access is never granted at install: Chrome asks you first, one site at a time.
| Permission | When | What it’s for |
|---|---|---|
| storage | Required | Saves your settings, Canvas sites and study history on this computer, inside Chrome. It isn’t synced to your Google account. |
| scripting | Required | Lets Junox add its sidebar to a page: on the Canvas sites you’ve allowed, or on the page you’re on when you open Junox. |
| activeTab | Required | When you click the Junox icon or press Alt+Shift+S, Chrome gives Junox temporary access to that one tab — nothing else. |
| junox.onrender.com | Required site access | Lets Junox talk to the Junox AI server, which writes the explanations when you use the default Junox AI. |
| Other websites (https and http) | Optional — only if you allow it | Not granted at install. Chrome asks you first, for one site at a time: when you add your Canvas address, allow an embedded lesson viewer, or connect Ollama or another AI service. http is mainly for addresses on your own computer, like Ollama. |
| webNavigation | Optional — only if you allow it | Only requested if you click “Find the lesson viewer” in the sidebar, so Junox can see which site an embedded lesson viewer comes from. |
Troubleshooting
Most install problems come down to one of these.
Still stuck?
Tell us what you see and which step you’re on — a real person reads every message.
Junox doesn’t appear after I select the folder
Make sure you selected the extracted folder that has manifest.json directly inside it, not a folder above it.
Look for a red error box or an Errors button on the Extensions page — it explains what Chrome didn’t like.
Check that Chrome is version 116 or newer (⋮ → Help → About Google Chrome).
I selected the ZIP and nothing happened
Chrome can’t load ZIP files. Extract the ZIP first (Windows: right-click → Extract All; macOS: double-click), then click Load unpacked again and choose the extracted folder.
Chrome says “Manifest file is missing or unreadable”
You picked a folder that doesn’t directly contain manifest.json — usually the outer junox-beta-v1.0.1 folder Windows creates when extracting. Click Load unpacked again, open junox-beta-v1.0.1, then select the junox-beta-v1.0.1 folder inside it (the one with manifest.json).
If the folder is empty or looks incomplete, delete it, download the ZIP again and re-extract it.
I can’t find Developer mode
It’s a toggle in the top-right corner of chrome://extensions. On narrow windows, make the window wider.
On school-managed Chromebooks or work computers, your administrator’s policies may hide Developer mode or block extensions that aren’t from the Chrome Web Store. If so, try a personal computer, or ask your administrator.
Junox is installed but isn’t opening
Check that the switch on the Junox card is on.
Click the Junox icon (or press Alt+Shift+S) on a normal website. Junox can’t open on Chrome’s own pages, like chrome://extensions or the New Tab page, or on the Chrome Web Store — the icon shows ✕ there.
For Canvas, make sure your Canvas address is listed and Allowed in Junox Settings, then reload the Canvas tab.
If the shortcut doesn’t work, another extension may use it. Change it at chrome://extensions/shortcuts.
I clicked Deny on Chrome’s site-access prompt
Junox shows “Permission was not granted, so the extension can't run on that site. Try again and choose "Allow".” Click “Add & allow” again and choose Allow this time.
If your Canvas site is already listed as “Not allowed — click to allow”, click that to see the prompt again.
If you remove a Canvas site and add it again, Chrome may grant access straight away without showing the prompt. That’s normal.
How do I update Junox?
Download the new version from this page and extract it.
Replace the files inside the folder Chrome already loads Junox from (the one you kept in Documents) with the files from the new version’s folder — keep the old folder’s name and place, because Chrome remembers that path. Then click the reload ↻ button on the Junox card in chrome://extensions.
Reloading keeps your settings, Canvas sites and study history. If you chose not to remember your API key, you’ll need to enter it again.
Alternatively, remove Junox and Load unpacked the new folder. This starts fresh: removing the extension deletes its saved settings and history. Loading a second copy from a different folder also creates a separate Junox with fresh settings, so remove the old one.
How do I uninstall Junox?
Go to chrome://extensions, click Remove on the Junox card and confirm. This deletes Junox’s saved settings, Canvas sites and study history from Chrome.
After removing it in Chrome, you can delete the Junox folder from your computer (only delete it after removing Junox, not instead).
Something else? Report a problem with what you see and which step you’re on.
