EduHoot
Versió actual del paquet: 1.0.7, amb proves automàtiques
d'idiomes (cd src i npm run test:i18n; preparació en les notes de versió).
Imatge Docker i publicació en GitHub: documentació.
Valencià
EduHoot és una aplicació tipus Kahoot per a l’aula: pots crear, importar i llançar qüestionaris amb imatges, vídeos i temps configurables. Admet CSV (inclosos els generats per IA) i importació de Kahoot públic. Està inspirada i reutilitza idees de llixhoot, llixhoot en lliurex i qplay.
- Modes: Només jo (efímer sense login), Per enllaç/Públic (persistents encara que no hi haja sessió) i control de permisos per a clonar.
- Idiomes: valencià, castellà i anglès (autodetecta el navegador i es pot canviar).
- Host: botó de “Saltar pregunta”, indicador de progrés i reentrada ràpida quan algun jugador perd la connexió.
- Importació Kahoot: enganxa la URL pública i juga des d’EduHoot.
Llicència: GNU Affero General Public License v3.0 (AGPL-3.0).
Inici ràpid
cd src && npm install- Inicia MongoDB local (
sudo systemctl start mongod) o defineix MONGO_URL.
- Executa
node server/server.js.
- Obri
http://localhost:3000/create/.
- Alternativa amb Docker: consulta docs/DEV_DOCKER_SETUP.md per a desenvolupar sense instal·lar Node ni MongoDB en local.
Accés amb Google
Configura un client OAuth 2.0 de Google amb la URL de retorn https://tu-dominio/api/auth/google/callback (o http://localhost:3000/api/auth/google/callback en local) i arranca el servidor amb:
GOOGLE_CLIENT_IDGOOGLE_CLIENT_SECRETPUBLIC_BASE_URL (recomanat en producció, per exemple https://tu-dominio)EDUTICTAC_COMMONS_URL (opcional): Commons al qual apunta el xip de compte. Per defecte https://commons.edutictac.es; en un Commons local, l'adreça pública del portal, per exemple http://edutictac.local:8082.
El primer usuari que entra amb Google es crea com admin; els següents entren com editor. Si ja existeix un usuari amb el mateix email, se li enllaça Google i conserva el rol.
En la pantalla de create, el bloc d'alta ràpida mostra només el botó de Google. El botó Entrar/Compte continua obrint el modal d'accés amb email per a usuaris antics.
Deploy simple al VPS
- Plantilla segura versionable:
scripts/deploy.example.sh
- Recomanat: copia-la a
scripts/deploy.sh, ompli les teues dades i no la puges al repo.
- Exemple:
DEPLOY_TARGET=usuari@vps:/var/www/eduhoot bash scripts/deploy.example.sh
- Amb reinici remot opcional:
DEPLOY_TARGET=usuari@vps:/var/www/eduhoot DEPLOY_REMOTE_CMD='cd /var/www/eduhoot/src && npm ci --omit=dev && pm2 restart eduhoot' bash scripts/deploy.example.sh
- Per previsualitzar canvis sense copiar:
DRY_RUN=1 bash scripts/deploy.example.sh
Funcions clau
- Importació de CSV i de contingut generat per IA.
- Importació pública de Kahoot per URL o ID.
- Control de visibilitat (privat, per enllaç, públic) i permisos de clonació.
- Botó de “Saltar pregunta” i marcador de progrés.
- Recuperació ràpida de jugadors quan la connexió cau.
- Tres modes de joc: Jugar a l’aula (amb PIN), Multijugador
(pantalla compartida) i Solo (individual, al teu ritme).
- L’alumnat s’uneix amb un nom lliure i una icona; l’amfitrió avança les
preguntes a mà, no hi ha avanç automàtic.
- Informe de partida en CSV, i exportació del banc de preguntes a Moodle
XML per a AULES.
Vols saber amb detall com funciona cada funcionalitat (modes de joc, avanç
de preguntes, informe CSV...)? Consulta ARCHITECTURE.md.
Actualitzacions recents
- Pantalla neta a l’instant entre preguntes, sense restes de la pregunta anterior.
- Noms de jugador de fins a 40 caràcters en multijugador.
- Icones de forma (triangle, rombe, cercle, quadrat) a cada resposta, dibuixades amb CSS pur, a més del color, per a distingir-les millor i per accessibilitat davant el daltonisme.
- Botó de pantalla completa a la vista del professor.
- Celebració quan tota la classe encerta una pregunta, i avís quan la falla tota.
- Animació a la insígnia de punts dobles i animació de moviments al rànquing entre preguntes.
- Informe de partida (
report.csv) més segur: només el host real el pot descarregar, amb neteja automàtica dels fitxers en disc encara que el servidor es reinicie.
- Landing principal redissenyada amb accessos separats, selector d’idioma i footer comú amb el logo d’EduTicTac.
- Biblioteca amb ordenació per data i alfabètica, tags rellevants i estadístiques de partides.
- El mode Solo ara registra partides i mostra estadístiques visibles al ranking i un feedback més clar.
Enllaços directes al mode Solo
- Quiz concret:
/solo/?id=<quizId>
- Una etiqueta:
/solo/?tag=musica
- Diverses etiquetes amb coincidència de qualsevol:
/solo/?tags=musica,primaria
- Diverses etiquetes exigint totes:
/solo/?tags=musica,primaria&tagMode=all
Castellano
EduHoot es una aplicación tipo Kahoot para el aula: crea, importa y lanza quizzes con imágenes, vídeos y tiempos configurables. Admite CSV (también generados por IA) e importación de Kahoot público. Se inspira y reutiliza ideas de llixhoot, llixhoot en lliurex y qplay.
- Modos: Solo yo (efímero sin login), Por enlace/Público (persisten aunque no haya sesión) y control de permisos para clonar.
- Idiomas: valenciano, castellano e inglés (autodetecta el navegador y se puede cambiar).
- Host: botón de “Saltar pregunta”, indicador de progreso y reincorporación rápida cuando los jugadores pierden la conexión.
- Importación Kahoot: pega la URL pública y juega desde EduHoot.
Licencia: GNU Affero General Public License v3.0 (AGPL-3.0).
Inicio rápido
cd src && npm install- Inicia MongoDB local (
sudo systemctl start mongod) o configura MONGO_URL.
- Ejecuta
node server/server.js.
- Abre
http://localhost:3000/create/.
- Alternativa con Docker: consulta docs/DEV_DOCKER_SETUP.md para desarrollar sin instalar Node ni MongoDB localmente.
Acceso con Google
Configura un cliente OAuth 2.0 de Google con la URL de retorno https://tu-dominio/api/auth/google/callback (o http://localhost:3000/api/auth/google/callback en local) y arranca el servidor con:
GOOGLE_CLIENT_IDGOOGLE_CLIENT_SECRETPUBLIC_BASE_URL (recomendado en producción, por ejemplo https://tu-dominio)EDUTICTAC_COMMONS_URL (opcional): Commons al que apunta el chip de cuenta. Por defecto https://commons.edutictac.es; en un Commons local, la dirección pública del portal, por ejemplo http://edutictac.local:8082.
El primer usuario que entra con Google se crea como admin; los siguientes entran como editor. Si ya existe un usuario con el mismo email, se le enlaza Google y conserva su rol.
En la pantalla de create, el bloque de alta rápida muestra solo el botón de Google. El botón Entrar/Cuenta sigue abriendo el modal de acceso con email para usuarios antiguos.
Acceso docente con Authentik
En producción hay una transición de 14 días desde el 12 de octubre de 2026.
La fecha anunciada para dejar solo «Entrar con EduTicTac» era el 26 de octubre
a las 19:00 (Europe/Madrid). La retirada automática y el recordatorio están
desactivados mientras se valida la corrección del acceso real. Google seguirá
disponible dentro de Authentik. Véase el
plan de migración.
AUTHENTIK_MIGRATION_END permite fijar el fin de la transición en ISO UTC.
Al llegar al plazo se desactivan Google directo y las vías docentes locales,
y las sesiones HTTP antiguas requieren volver a entrar por Authentik.
La vinculación inicial requiere correo verificado; los accesos posteriores
usan issuer/sub y conservan la propiedad de los cuestionarios y el rol.
El grupo professorat se admite entre los grupos docentes.
EduHoot admite login OIDC con Authentik. Solo las identidades que incluyen un
rol docente en la claim configurada pueden iniciar sesión; el alumnado no puede
usar este login para crear o gestionar cuestionarios. Configura
AUTHENTIK_ISSUER, AUTHENTIK_CLIENT_ID, AUTHENTIK_CLIENT_SECRET y
AUTHENTIK_REDIRECT_URI (por defecto /api/auth/authentik/callback), y registra
esa URL en Authentik. La claim de roles/grupos es groups por defecto y se
puede cambiar con AUTHENTIK_ROLE_CLAIM; los roles aceptados se configuran con
AUTHENTIK_TEACHER_ROLES.
Integración con EduTicTac Commons
EduHoot puede validar al alumnado contra el servicio de identidad pseudónima de EduTicTac Commons y registrar la puntuación final en Commons.
Variables principales:
EDUTICTAC_ID_API_URL: URL interna de id-api, por ejemplo http://id-api:8005.EDUTICTAC_ID_AUTH_REQUIRED: 0 permite entrar con nombre corto o con código + PIN Commons; 1 obliga a usar código + PIN Commons.EDUTICTAC_ID_APP_TOKEN: token interno compartido con Commons para enviar resultados.
En modo mixto (EDUTICTAC_ID_AUTH_REQUIRED=0), si el alumno rellena código + PIN Commons, EduHoot no debe pedir también nombre: usa el código público como alias corto. Si deja esos campos vacíos, puede jugar con nombre corto como antes.
Al terminar una partida, EduHoot envía resumen de puntuación a /api/apps/eduhoot/scores cuando EDUTICTAC_ID_API_URL y EDUTICTAC_ID_APP_TOKEN están configurados.
Deploy simple al VPS
- Plantilla segura versionable:
scripts/deploy.example.sh
- Recomendado: cópiala a
scripts/deploy.sh, rellena tus datos y no la subas al repo.
- Ejemplo:
DEPLOY_TARGET=usuario@vps:/var/www/eduhoot bash scripts/deploy.example.sh
- Con reinicio remoto opcional:
DEPLOY_TARGET=usuario@vps:/var/www/eduhoot DEPLOY_REMOTE_CMD='cd /var/www/eduhoot/src && npm ci --omit=dev && pm2 restart eduhoot' bash scripts/deploy.example.sh
- Para previsualizar cambios sin copiar:
DRY_RUN=1 bash scripts/deploy.example.sh
Entorno stage (preproducción)
- Guía completa:
STAGE_SETUP.md
- Plantilla de deploy stage:
scripts/deploy-stage.example.sh
- Servicio systemd stage:
install-files/service/eduhoot-stage-server.service
- Config Nginx stage:
install-files/nginx/eduhoot-stage.conf
- Variables de entorno stage:
install-files/stage.env.example
Flujo recomendado:
- Monta stage una vez siguiendo
STAGE_SETUP.md.
- Despliega cambios a
/opt/eduhoot-stage/src con scripts/deploy-stage.sh.
- Valida en
stage.tu-dominio (flujos host/player, login y CSV).
- Solo después promueve a producción.
Funciones clave
- Importación de CSV y de contenido generado por IA.
- Importación pública de Kahoot por URL o ID.
- Control de visibilidad (privado, por enlace, público) y permisos para clonar.
- Botón de “Saltar pregunta” y contador de progreso.
- Reincorporación ágil de jugadores si se cae la conexión.
- Tres modos de juego: Jugar en el aula (con PIN), Multijugador
(pantalla compartida) y Solo (individual, a tu ritmo).
- El alumnado se une con un nombre libre y un icono; el profesorado avanza
las preguntas a mano, no hay avance automático.
- Informe de partida en CSV, y exportación del banco de preguntas a Moodle
XML para AULES.
¿Quieres saber en detalle cómo funciona cada funcionalidad (modos de
juego, avance de preguntas, informe CSV...)? Consulta ARCHITECTURE.md.
Actualizaciones recientes
- Pantalla limpia al instante entre preguntas, sin restos de la pregunta anterior.
- Nombres de jugador de hasta 40 caracteres en multijugador.
- Iconos de forma (triángulo, rombo, círculo, cuadrado) en cada respuesta, dibujados con CSS puro, además del color, para distinguirlas mejor y por accesibilidad ante el daltonismo.
- Botón de pantalla completa en la vista del profesorado.
- Celebración cuando toda la clase acierta una pregunta, y aviso cuando la falla toda.
- Animación en la insignia de puntos dobles y animación de movimientos en el ranking entre preguntas.
- Informe de partida (
report.csv) más seguro: solo el host real puede descargarlo, con limpieza automática de los ficheros en disco aunque el servidor se reinicie.
- Landing principal renovada con accesos diferenciados, selector de idioma y footer compartido con el logo de EduTicTac.
- Biblioteca con orden por fecha y alfabético, etiquetas relevantes y estadísticas visibles en cada ficha.
- Modo Solo registra partidas y mejora el ranking/feedback, además de mostrar estadísticas de partidas jugadas.
Enlaces directos al modo Solo
- Quiz concreto:
/solo/?id=<quizId>
- Una etiqueta:
/solo/?tag=musica
- Varias etiquetas con coincidencia de cualquiera:
/solo/?tags=musica,primaria
- Varias etiquetas exigiendo todas:
/solo/?tags=musica,primaria&tagMode=all
English
EduHoot is a Kahoot-like app for classrooms: create, import, and launch quizzes with images, videos, and configurable timers. Supports CSV (including AI-generated) and public Kahoot import. It’s inspired by and reuses ideas from llixhoot, llixhoot on lliurex, and qplay.
- Modes: Only me (ephemeral without login), By link/Public (persist even without login), with clone-permission control.
- Languages: Valencian, Spanish, English (auto-detects browser and is switchable).
- Host: “Skip question” button, progress counter, and quick player rejoin when connections drop.
- Kahoot import: paste a public URL and play it from EduHoot.
License: GNU Affero General Public License v3.0 (AGPL-3.0).
Quick start
cd src && npm install- Start local MongoDB (
sudo systemctl start mongod) or set MONGO_URL.
- Run
node server/server.js.
- Open
http://localhost:3000/create/.
- Docker alternative: see docs/DEV_DOCKER_SETUP.md to develop without installing Node or MongoDB locally.
Google Sign-In
Create a Google OAuth 2.0 client with the redirect URL https://your-domain/api/auth/google/callback (or http://localhost:3000/api/auth/google/callback locally) and start the server with:
GOOGLE_CLIENT_IDGOOGLE_CLIENT_SECRETPUBLIC_BASE_URL (recommended in production, for example https://your-domain)EDUTICTAC_COMMONS_URL (optional): Commons the account chip points to. Defaults to https://commons.edutictac.es; in a local Commons, the portal's public address, for example http://edutictac.local:8082.
The first Google user becomes admin; later users become editor. If a user with the same email already exists, Google is linked to that account and the current role is preserved.
Simple VPS Deploy
- Safe versioned template:
scripts/deploy.example.sh
- Recommended: copy it to
scripts/deploy.sh, fill your real values, and keep it out of the repo.
- Example:
DEPLOY_TARGET=user@vps:/var/www/eduhoot bash scripts/deploy.example.sh
- With optional remote restart:
DEPLOY_TARGET=user@vps:/var/www/eduhoot DEPLOY_REMOTE_CMD='cd /var/www/eduhoot/src && npm ci --omit=dev && pm2 restart eduhoot' bash scripts/deploy.example.sh
- Preview without copying:
DRY_RUN=1 bash scripts/deploy.example.sh
Stage Environment (pre-production)
- Full guide:
STAGE_SETUP.md
- Stage deploy template:
scripts/deploy-stage.example.sh
- Stage systemd service:
install-files/service/eduhoot-stage-server.service
- Stage Nginx config:
install-files/nginx/eduhoot-stage.conf
- Stage environment variables:
install-files/stage.env.example
Recommended flow:
- Set up stage once using
STAGE_SETUP.md.
- Deploy changes to
/opt/eduhoot-stage/src via scripts/deploy-stage.sh.
- Validate on
stage.your-domain (host/player flows, login, CSV import).
- Promote to production only after stage is green.
Key features
- CSV import and AI-generated content ingestion.
- Public Kahoot import via URL or ID.
- Visibility controls (private, by link, public) with clone permissions.
- “Skip question” button and progress tracking.
- Fast player rejoin if the connection drops.
- Three game modes: Classroom (with a PIN), Multiplayer (shared
screen), and Solo (individual, self-paced).
- Students join with a free-text name and an icon; the teacher advances
questions manually — there's no auto-advance.
- CSV game report, plus exporting the question bank to Moodle XML for
Moodle/AULES.
Want the full details on how each feature works (game modes, question
advancing, CSV report...)? See ARCHITECTURE.md.
Recent updates
- Instant clean screen between questions, with no leftovers from the previous one.
- Player names up to 40 characters in multiplayer.
- Shape icons (triangle, diamond, circle, square) on each answer, drawn with pure CSS, on top of the color, for clearer matching and color-blindness accessibility.
- Fullscreen toggle button on the teacher's view.
- Celebration when the whole class gets a question right, and a warning when everyone misses it.
- Small animation on the double-points badge and a ranking movement animation between questions.
- More secure game report (
report.csv): only the real host can download it, with automatic cleanup of the files on disk even if the server restarts.
- Redesigned landing with separate entry points, language selector, and shared footer pointing to EduTicTac.
- Library now supports ordering by date/alpha, shows only related tags, and surfaces quiz stats.
- Solo mode logs plays so the ranking/counts include solo sessions, plus brighter feedback and stats.
Solo Deep Links
- Specific quiz:
/solo/?id=<quizId>
- One tag:
/solo/?tag=music
- Multiple tags matching any:
/solo/?tags=music,primary
- Multiple tags requiring all:
/solo/?tags=music,primary&tagMode=all
