Reading shouldn't stop you from fixing cars. Or using a computer. Or doing homework.
Frisc OS is a full Linux desktop designed from the ground up for people with dyslexia and anyone who wants a computer that doesn't fight them. It comes loaded with a complete automotive diagnostic suite — OBD-II scanning, ECU tuning, DTC lookup, wiring diagrams — all with clean, readable interfaces and an AI assistant that reads everything to you.
Built on Debian 12 (Bookworm). Runs on any PC or a Raspberry Pi 5.
Press Super+M and just ask. Dr. Marshall is always there.
- Reads any text aloud — highlight it, Marshall speaks it
- Helps with spelling — "How do you spell carburetor?"
- Explains things simply — no jargon, ever
- Voice control — talk to your computer
- 100% private — runs locally via Ollama, nothing leaves your machine
Every screen, every menu, every app — designed to be readable.
- OpenDyslexic font system-wide
- High contrast dark theme — easy on the eyes
- Big clear buttons and icons
- Color-coded sections so you never get lost
- Built-in spell check with autocorrect
- Text-to-speech on any selected text (Super+R)
Real diagnostic tools, not toys. Built for the garage.
| Tool | What It Does |
|---|---|
| OBD-II Scanner | Read live data, freeze frames, sensor values |
| DTC Code Lookup | Plain-English explanations for every trouble code |
| BlackFlag ECU | Flash read/write, map editing, tuning — gasoline |
| BlackFlag HD | J1939 diesel diagnostics, DPF regen, injector cal |
| J2534 Pass-Thru | Topdon RLink, Snap-on Pass Thru Pro 4 support |
| RP1210 Protocol | Heavy-duty pass-thru for commercial trucks |
| Wiring Diagrams | Interactive vehicle wiring lookup |
| VIN Decoder | Full vehicle info from VIN |
| Repair Guides | Step-by-step procedures |
| Auto Crawler | NHTSA database enrichment & TSB lookup |
Everything else you need, all in one place.
- n01d Terminal — clean terminal with autocomplete
- n01d Notes — simple note-taking
- n01d Media — music and video player
- n01d Book Reader — eBook library
- n01d Sysmon — system monitor
- n01d Forge — dev tools
- n01d Docker — container management
- n01d Comz — encrypted P2P messaging
For students who learn differently.
- Research tool with web search
- Writing assistant with spell check
- PDF export for assignments
- Email integration
- Dr. Marshall helps with all of it
| Shortcut | Action |
|---|---|
| Super+M | Dr. Marshall AI |
| Super+R | Read selected text aloud |
| Super+S | Spell check |
| Super+A | Automotive Suite |
| Super+T | n01d Terminal |
| Super+N | n01d Notes |
| Super+W | Schoolwork Suite |
| Super+C | n01d Comz |
| Super+B | Marshall Browser |
| Super+Space | Quick Launch |
| Super+F | File search |
git clone https://github.com/bad-antics/frisc-os.git
cd frisc-os
sudo ./install.shDownload the .deb from Releases:
sudo apt install ./frisc-os_1.0.0-1_all.debWorks on Raspberry Pi OS (Bookworm) and any arm64 Debian 12.
# Build a bootable ISO
sudo ./build-frisc-iso.sh
# Or build a VM disk image and launch it
sudo ./launch-vm.sh
# Or deploy directly to a USB drive
sudo ./deploy-to-usb.sh| Minimum | Recommended | |
|---|---|---|
| CPU | Any x86_64 or ARM64 (Pi 5) | Quad-core |
| RAM | 4 GB | 8 GB |
| Storage | 16 GB | 32 GB |
| GPU | Integrated | Any |
| OBD-II | ELM327 adapter (for auto tools) | J2534 pass-thru device |
frisc-os/
├── apps/
│ ├── automotive/ # OBD-II, BlackFlag ECU/HD, J2534, wiring
│ ├── n01d-suite/ # Terminal, notes, media, sysmon, forge...
│ ├── n01d-schoolwork/ # Research, write, PDF export
│ ├── wifi/ # WiFi manager
│ ├── marshall-browser/ # Privacy browser
│ └── frisc-installer.py # Disk installer
├── dr-marshall/ # AI assistant (Ollama-powered)
├── shortcuts/ # Global hotkeys & quick launcher
├── config/
│ ├── themes/ # Dyslexia-friendly dark themes
│ ├── accessibility/ # Font config, dyslexia assist
│ └── desktop/ # XFCE panel & desktop config
├── branding/
│ ├── plymouth/ # Boot splash animation
│ ├── grub/ # GRUB bootloader theme
│ └── *.png # Wallpapers, icons, login screen
├── guides/ # Plain-English user guides
├── install.sh # Install on existing system
├── build-frisc-iso.sh # Build bootable ISO
├── build-pi5-package.sh # Build Pi 5 .deb package
├── deploy-to-usb.sh # Write to USB drive
└── launch-vm.sh # Test in QEMU VM
| Script | Purpose |
|---|---|
install.sh |
Install Frisc OS on a running Debian system |
build-frisc-iso.sh |
Create a bootable ISO image |
build-raw-image.sh |
Create a raw disk image |
build-pi5-package.sh |
Build the .deb for Raspberry Pi 5 |
deploy-to-usb.sh |
Write a bootable image to USB |
launch-vm.sh |
Build & launch a QEMU VM for testing |
Frisc OS is built for accessibility. If you want to help:
- Report bugs — especially accessibility issues
- Improve readability — simpler words, clearer layouts
- Add vehicle data — DTC definitions, wiring diagrams, repair guides
- Test on hardware — especially Pi 5 and different OBD adapters
- Translate — help bring Frisc OS to other languages
GPL-3.0 — See LICENSE for details.
Built by Bad Antics Dev — NullSec Technology
Easy Computing for Everyone