Skip to content

markuskiller/SEBConfigGenerator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

SEB Configuration Generator

Cloudflare Pages Cloudflare Pages GitHub Pages GitHub issues Language Privacy Safe Exam Browser License: MIT

Browser-based Safe Exam Browser (SEB) configuration generator for creating focused learning environments in classroom teaching.


Quick Links

🌐 Online SEB Config Generator: focusmode.ch

πŸ“š Documentation:

πŸ’» Offline Use:


Features

  • βœ… Pre-configured Services - OneNote, Word, Kahoot, Mentimeter, Miro, Padlet, Whiteboard.fi, Slido, Etherpad (PRs welcome)
  • βœ… Multi-Tool Support - Combine multiple services in one configuration
  • βœ… Bilingual Interface - German and English (PRs welcome)
  • βœ… Privacy-First - 100% browser-local processing, no data transmission (see Privacy section below)
  • βœ… Flexible Domain Control - Wildcards, custom domains, blocked domains
  • βœ… Moodle Quiz Integration - Export URL lists for direct copy-paste into Moodle SEB settings
  • βœ… Subject-Specific Tools - Pre-configured dictionaries and reference tools (PRs welcome)
  • βœ… Domain Capture Tools - PowerShell script and browser console helpers
  • βœ… Open Source - MIT License, auditable code

Use Cases

βœ… Designed for:

  • Digital worksheets during supervised lessons
  • Collaborative writing assignments
  • Interactive tool usage (Kahoot, Mentimeter, Padlet)
  • Focused work periods with controlled internet access
  • Research tasks with approved resources

❌ Not designed for:

  • High-stakes exams (insufficient security)
  • Unsupervised assessments
  • Preventing determined circumvention

Privacy & Data Storage

100% Local Processing:

  • All configuration data is processed exclusively in your browser
  • No data is transmitted to any server
  • No analytics, tracking, or external dependencies
  • Can be used completely offline

Local Storage (Browser): The following user preferences are saved locally in your browser:

  • Language preference (sebConfigLang) - Selected UI language (German/English)
  • Favorites (sebConfigFavorites) - Your favorite boolean options for quick access
  • Translation display (sebConfigShowTranslations) - Show original or translated labels in advanced options
  • URL filter source (sebConfigURLFilterSource) - Active filter for URL rules (all/preset/SharePoint/custom/imported)

Note: These preferences enhance usability and are stored only on your device. No configuration data or user inputs are ever stored or transmitted.


Technical Stack

  • Client-side only - Pure HTML/CSS/JavaScript
  • No dependencies - No npm, no build process
  • Data processing - 100% in-browser JSON to XML conversion
  • Extensible templating & translations architecture - PRs welcome!
  • Output formats - .seb.plist (import into SEB Config Tool) or Moodle Quiz URL lists (copy-paste)
  • Deployment - Static files via Cloudflare Pages and GitHub Pages
  • Build automation - Bash scripts for template generation

Development

Project Structure

SEBConfigGenerator/
β”œβ”€β”€ index.html              # Main application
β”œβ”€β”€ js/                     # Application logic
β”œβ”€β”€ templates/              # Service presets and configuration templates
β”‚   β”œβ”€β”€ source/             # Human-editable JSON source files
β”‚   └── generated/          # Auto-generated JavaScript modules
β”œβ”€β”€ scripts/                # Build and deployment automation
β”‚   β”œβ”€β”€ deploy.sh           # Automated deployment script
β”‚   β”œβ”€β”€ build-service-presets.sh
β”‚   └── build-translations.sh
└── docs/                   # Public-facing documentation
    β”œβ”€β”€ de/                 # German docs (SCHNELLSTART.md, ANLEITUNG.md)
    └── en/                 # English docs (QUICKSTART.md, GUIDE.md)

Setup

# Clone repository
git clone https://github.com/markuskiller/SEBConfigGenerator.git
cd SEBConfigGenerator

# Open in browser
open index.html

# Or use local server
python -m http.server 8000

Building Templates

# Rebuild service presets and translations
./scripts/build-service-presets.sh
./scripts/build-translations.sh

# Or use automated deployment script
./scripts/deploy.sh

See scripts/README.md for detailed build documentation.

Deployment

Automated (recommended):

./scripts/deploy.sh v0.19.0  # Rebuild + version bump + commit + push

Manual:

./scripts/build-service-presets.sh
./scripts/build-translations.sh
git add .
git commit -m "Update generated templates"
git push origin dev

Deployment targets:


Contributing

Contributions welcome!

We particularly welcome contributions of the following JSON template sources:

  • service templates (e.g. socrative.com)
  • reference tool templates (e.g. dictionary.cambridge.org)
  • subject templates (e.g. Maths or History)
  • translations (e.g. French or Spanish)
β”œβ”€β”€ templates/                # Service presets and configuration templates
β”‚   β”œβ”€β”€ source/               # Human-editable JSON source files
β”‚   β”‚   β”œβ”€β”€ services/         # Individual service configurations
β”‚   β”‚   β”‚   β”œβ”€β”€ kahoot.json
β”‚   β”‚   β”‚   β”œβ”€β”€ mentimeter.json
β”‚   β”‚   β”‚   └── ...
β”‚   β”‚   β”œβ”€β”€ reference-tools/  # Subject-specific reference tools
β”‚   β”‚   β”‚   β”œβ”€β”€ duden.json
β”‚   β”‚   β”‚   β”œβ”€β”€ oxford.json
β”‚   β”‚   β”‚   └── ...
β”‚   β”‚   β”œβ”€β”€ subjects/         # Pre-configured subject bundles
β”‚   β”‚       β”œβ”€β”€ german.json
β”‚   β”‚       β”œβ”€β”€ french.json
β”‚   β”‚       └── ...
β”‚   └── generated/            # Auto-generated JavaScript modules
β”‚
└── translations/             # UI language files
       β”œβ”€β”€ de.json
       β”œβ”€β”€ en.json
       └── ...

Please:

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Test thoroughly
  5. Submit a pull request (create one pull request per service/tool/new language)

License

MIT License - See LICENSE for details.


About Safe Exam Browser

Safe Exam Browser (SEB) is a secure browser environment for taking online exams. This generator creates SEB configuration files optimized for classroom teaching scenarios.

Official SEB Resources:


(c) 2025 Markus Killer (focusmode.ch) πŸŽ“

About

Generate Config files for SafeExamBrowser

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •