Installing it
Three ways to run it. Pick one — the extension is the nicest for daily teaching.
The quick way: just open it
- Unzip the TeachersDeck folder somewhere you'll find it again, such as your Documents folder.
- Double-click
index.html. It opens in your default browser and works straight away.
One limit. Opened this way, the Games widget can't list the ready-made games that ship in the games folder, because browsers block pages opened from a file from reading neighbouring files. Everything else works. Use either method below to get that section.
As your Chrome new tab (recommended)
- Open Chrome and go to
chrome://extensions. - Turn on Developer mode, top right.
- Click Load unpacked and choose the
teachersdeckfolder — the one containingmanifest.json. - Open a new tab. TeachersDeck is now your new tab page.
Chrome will occasionally warn you about developer-mode extensions. That's normal for an extension installed from a folder rather than the Chrome Web Store, and you can dismiss it. The app still runs entirely on your machine either way.
From a local web server
Useful if you'd rather keep it as a web page but still want the built-in games. In a terminal, from inside the teachersdeck folder:
python3 -m http.server 8000
Then visit http://localhost:8000 in your browser. Stop the server with Ctrl+C when you're done.
What's in the folder
| File | What it is |
|---|---|
index.html | The app itself. This is the one you open. |
manual.html | This guide. |
manifest.json | Tells Chrome how to load it as an extension. |
css/, js/ | The code. Nothing to edit here for normal use. |
games/ | Ready-made classroom games. |
Around the screen
Everything is a panel you open, drag where you want and close again.
Opening and arranging widgets
- Open one by clicking its button in the dock along the bottom, or in the drawers at the left, right or top.
- Can't find a widget? Click the thin line above the bottom dock to open the tray of all widgets.
- Move a panel by dragging anywhere along its title bar — the grip on the left is the obvious spot, but the whole bar works. Resize from the small corner mark at the bottom right.
- Minimise with the − button in the panel's corner, close with ×.
Positions are remembered, so the room you set up on Friday is still there on Monday. Settings → Reset widget positions puts everything back to tidy defaults without touching your content.
The top bar
- Class pill — shows the class currently open and switches between classes.
- Language switch — two-letter buttons that flip the whole interface between your two chosen languages.
- Theme button — backgrounds and your own photo.
- Settings — classes, layout, languages, and the reset buttons. Always the rightmost button.
Classes
If you teach several groups a day, give each one its own deck.
Each class keeps its own student list, its own open widgets and where they sit, its own theme and background, and its own checklist, scoreboard, attendance record, agenda and announcements. Switching class reopens the whole board as that class left it.
Setting them up
- Open Settings → Classes. Your current board is already there as your first class — type a name for it, such as 7A Monday.
- Type a name in the box below and click Create & open. You get a fresh board to set up for that class.
- Teaching two groups the same way? Click Copy this class instead and you get the same widgets, layout and theme under a new name.
Switching during the day
Click the class pill in the top bar and choose a class. The page reloads into that class's board, which takes a second. Deleting a class with the × button erases that class's list, layout and settings; your files, games and music are shared between classes, so they stay.
Shared across every class: your uploaded files, games, music, videos and sounds, and your Pro licence. One teacher, one browser — no need to upload the same lesson files twice.
The interface language is part of a class's settings, so a class set to Vietnamese switches the whole interface when you open it. Handy if you teach in two languages; worth knowing if it surprises you.
Layout, theme and language
Backgrounds and your own photo
The theme button offers six built-in backgrounds. Below them, Upload a background image takes a photo from your computer. Dim background darkens whatever is behind the panels so text stays readable — leave it on for projectors.
A new background replaces the previous one. Backgrounds are per class.
Layout modes
Settings → Layout mode decides how much furniture is on screen:
- Compact — just the bottom dock, with the tray above it for everything else. Best on a small classroom screen. Widget emoji icons are hidden in this mode.
- Cozy — bottom, left and right docks all visible, with widget emoji icons shown.
- Custom — you choose. Only in this mode can you place each widget's button yourself, under Dock buttons, turn individual drawers on and off, and toggle widget emoji icons on or off under Widget icons.
Each dock holds a limited number of buttons, so put your daily five in the bottom dock and reach the rest from the tray. In Settings, Hide the bottom dock until I hover its tab slides the dock out of the way and leaves only its small tab at the bottom edge — more room for a document or the lesson. Point at the tab (or press Tab to a dock button) and the dock comes back; click the tab to open the tray as usual.
Top bar pills
The class switcher, language switch and theme button can each be shown in the top row or hidden away, under Settings → Top bar pills. Settings itself can't be hidden.
Languages and dates
The interface speaks English, Vietnamese, Spanish, French, Chinese, Japanese, Korean and Tagalog. Pick the two you use most as Quick language 1 and 2; those become the buttons in the top bar for one-click switching mid-lesson. Under Date system you can show Gregorian dates, the Vietnamese and Chinese lunar date, or both together.
The widgets
Thirty-one tools. You won't use them all — pick five or six for the board and leave the rest in the tray.
Time and attention
The ones that go on the board and stay there.
Your class list
These three read the same student list, so they stay in step with each other.
Known gap in this version. These widgets point you to Settings → Class list, but that editor isn't in Settings yet. Until it lands, they run on the sample list the app ships with. Everything else about them works.
Running the lesson
What's happening today, and what students should be doing right now.
Checking understanding
Quick reads of the room, and a bit of competition.
Files, media and games
Anything you bring in from outside. All of it stays on this computer.
Language and reference
Built for English and language classrooms, useful anywhere.
Free and Pro
The free version covers the clock, timer, stopwatch, calendar and your lesson files. Pro unlocks the other twenty-six widgets plus the custom background photo and full control over the side drawers. It's a monthly or annual subscription, and it unlocks on the browser you enter it in.
To activate: open Settings → TeachersDeck Pro, paste your licence key into the box and click Activate. Keys look like TDPRO-XXXX-XXXX-XXXX.
In this build everything is unlocked so the whole app can be tested and demonstrated. If you're reading this as a teacher trying it out, that means you can use every widget now.
Your data
Everything — your classes, layouts, checklists, attendance, uploaded files, games and music — is stored by your browser on this computer. Nothing is sent to a server, there's no account, and no one else can see it. Which also means:
- Clearing your browser's site data or history erases it. Look for “cookies and site data” before you clear anything.
- It doesn't follow you between computers. The classroom machine and your laptop at home keep separate decks.
- Using the app in a private or incognito window keeps nothing after you close it.
- Keep your original lesson files in their normal folders. What you add to the Files widget is a copy inside the browser, not a backup.
Settings has two reset buttons. Reset widget positions tidies the board and keeps your content. Reset everything erases every class and everything stored, on every class, and can't be undone.
If something goes wrong
The background image won't stick
If you see a message saying the image was applied but can't be saved, the window you're in is blocking storage — usually an embedded preview or a private window. The background will hold for the lesson but reset when you reload. Open the app in a normal browser tab or as the extension and upload it again.
The noise meter says it can't hear anything
It needs microphone permission, and browsers only grant that to pages served over https, over localhost, or running as the extension. If nothing happens when you click enable, use the Open microphone setup button that appears in the widget. To check the permission afterwards, open chrome://settings/content/microphone and make sure TeachersDeck is not under “Not allowed to use your microphone”. Treat the reading as a rough guide, not a measurement.
The Games widget shows no built-in games
The built-in games are listed in games/games.js, so they appear however you open the app. If the section is missing, the games folder was probably left out when you moved or unzipped the app — keep it beside index.html. Your own uploaded games work either way.
A YouTube link opens in a new tab instead of playing here
That's deliberate. YouTube blocks embedded playback for many videos, so the app hands them to a real tab, which always works.
Everything looks wrong after an update
Try Settings → Reset widget positions first. If the board is still odd, close any other tabs with TeachersDeck open and reload — an old tab left open can hold the app's storage during an update.