شاشتي تحكي 🇩🇿

The Algerian Screen Commentator

An AI-powered screen commentator that watches your screen in real-time and delivers live commentary in authentic Algerian personality — from wise elders to passionate football pundits.

Inspired by screen-commentator (Cheng Xiaohua's version), rebuilt from scratch as a fully Algerian experience with deeper AI integration, multiple personalities, and dialect switching.

What It Does

شاشتي تحكي ("My Screen Speaks") captures your screen at a configurable interval, sends each frame to Claude's vision AI, and generates commentary in the voice of one of five distinct Algerian characters — delivered as text and optionally spoken aloud via your browser's speech synthesis.

Features

🎭 Five Algerian Commentator Personalities

Character	Style
🧓 الحاج عمار	Wise elder from the Casbah — authentic Darja, proverbs, old-school wisdom
😎 زكرياء من بلوزداد	Young Algiers guy — modern slang, casual and funny
🎓 البروفيسور بلحاج	Academic professor — analytical, mixes Arabic and French
⛰️ عمو يحيى من تيزي وزو	Kabyle philosopher — mountain wisdom, Tamazight touches
⚽ معلّق الخضر	Sports commentator — treats everything like an Algeria national team match

🗣️ Four Dialect Modes

🇩🇿 دارجة — Pure Algerian colloquial
عربية — Modern Standard Arabic
Français — French with Algerian flavor
مزيج — Natural code-switching, as Algerians actually speak

⚙️ Controls

Capture intervals: 3s · 5s · 10s · 15s · 30s
Manual snapshot — trigger a comment on demand
Voice output — Web Speech API with Arabic/French language selection
Live stats — shots analyzed, total comments, session duration

⌨️ Keyboard Shortcuts

Shortcut	Action
`Ctrl + Space`	Start / Stop commentator
`Ctrl + S`	Manual snapshot

Getting Started

شاشتي تحكي is a single HTML file — no build step, no dependencies, no server required.

Requirements

A modern browser (Chrome or Edge recommended for screen capture)
An Anthropic API key with access to claude-sonnet-4-*

Running It

Open shaashti-tahki.html in your browser
The app will prompt for screen share permission when you press ابدأ المعلّق
Select a personality and dialect
Sit back and let the Hajj comment on your screen

Note: The Anthropic API key is handled by the Claude.ai artifact environment. If running this file independently outside that environment, you will need to add your API key to the fetch() call headers:
headers: {
  'Content-Type': 'application/json',
  'x-api-key': 'YOUR_KEY_HERE',
  'anthropic-version': '2023-06-01'
}

How It Works

Screen Share
    │
    ▼
Canvas frame capture (every N seconds)
    │
    ▼
JPEG base64 encoding
    │
    ▼
Claude Sonnet Vision API
(system prompt = selected personality + dialect)
    │
    ▼
Commentary text → Feed UI + optional TTS

Each personality is a distinct system prompt that shapes Claude's tone, vocabulary, and cultural references. The dialect selector appends an additional instruction to the prompt, steering the language register.

Design

The visual identity is built around the Algerian flag palette:

#006233 — Flag green
#D21034 — Flag red
#F5B800 — Gold accent
#FDF6E3 — Warm cream background

Typography uses Scheherazade New for display headings (classical Arabic calligraphy feel), Cairo for UI text, and IBM Plex Mono for metadata and codes.

Background texture is a subtle zellige tile pattern. Corner decorations are hand-coded SVG arabesques.

Differences from the Original

Feature	screen-commentator (original)	شاشتي تحكي
Language	Chinese	Arabic / Darja / French
Personalities	Single	5 distinct characters
Dialect switching	✗	✓
Voice output	✗	✓ (Web Speech API)
Cultural framing	Generic	Algerian-specific
Architecture	Multi-file project	Single HTML file
Setup	npm / Node.js	Open in browser

Roadmap

Export commentary session as PDF / text transcript
Custom personality builder (write your own prompt)
Tamazight (Tifinagh) dialect mode
Highlight / clip a region of the screen instead of full capture
Share a commentary clip as an image with quote overlay
Mobile support (screen record API fallback)

Acknowledgments

Original concept: Cheng Xiaohua's screen-commentator
AI: Claude by Anthropic
Arabic fonts: Google Fonts — Cairo & Scheherazade New

License

MIT — do whatever you want with it, just keep the Hajj's wisdom alive.

يا ولدي، الكمبيوتر ما يخوّفش — خاصك تعرف كيفاش تخدم بيه. — الحاج عمار

Downloads last month: -; Downloads are not tracked for this model. How to track

Inference Providers NEW

This model isn't deployed by any Inference Provider. 🙋 Ask for provider support