Skip to content

About

lock your screen in C let's see the start

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌌 THE BLACK HOLE LOCKER

Ultimate Starfield Screen Locker

Linux C X11

Linux • X11 • Terminal • Low-Level Input Control


Transformer une simple animation Starfield en un écran de verrouillage quasi infranchissable

Installation • Utilisation • Documentation X11


📖 Introduction

The Black Hole Locker (alias Ultimate Starfield Locker) est un projet expérimental écrit en C, né d'un défi précis :

🎯 Créer un écran de verrouillage capable de neutraliser les vecteurs d'évasion classiques
Ctrl+C · Alt+F4 · Alt+Tab · focus loss
sans droits administrateur (no sudo)

Le programme combine :

Composant Description
🎨 Rendu visuel Animation immersive en terminal (ANSI / Unicode)
⌨️ Capture clavier Interception bas niveau via X11
🔐 Déverrouillage Logique par séquence secrète

Warning

Ce projet n'est pas un vrai lockscreen sécurisé système, mais un proof-of-concept avancé montrant jusqu'où on peut aller sans privilèges root.


🛠️ L'Évolution — Problèmes & Solutions

1️⃣ Le faux plein écran : l'illusion contrôlée

❌ Problème

En C standard, il est impossible de forcer une application terminal en plein écran natif.

✅ Solution

  • Buffer alternatif ANSI : \033[?1049h
  • Masquage du curseur
  • xterm brut sans décorations
xterm -xrm 'xterm.overrideRedirect: true'

💡 Ruse : Le Window Manager n'ajoute ni bordure, ni barre de titre, ni gestion de focus.
➡️ Résultat : une interface stealth, au-dessus de tout.


2️⃣ Le combat contre le Window Manager

❌ Problème

GNOME / KDE interceptent les raccourcis système (Alt+F4, Alt+Tab) avant qu'ils n'atteignent le programme.

✅ Solution ultime

XGrabKeyboard(dpy, root, False, 
              GrabModeAsync, GrabModeAsync, 
              CurrentTime);

➡️ Le serveur X11 redirige tout le flux clavier matériel vers ton programme.
➡️ Le Window Manager devient sourd.


3️⃣ Le bug du "Clavier Muet"

❌ Problème

Une fois le clavier capturé par X11 :

  • read(), stdin, termios → inutilisables
  • La séquence secrète ne fonctionne plus

✅ Solution

while (XPending(dpy)) {
    XNextEvent(dpy, &ev);
    if (ev.type == KeyPress) {
        KeySym keysym = XLookupKeysym(&ev.xkey, 0);
    }
}

➡️ On lit directement les signaux matériels du clavier, sans passer par le terminal.


🧬 Anatomie du Code — Les 4 Piliers

🛡️ A. La couche X11 — La Sécurité
Display *dpy = XOpenDisplay(NULL);
XGrabKeyboard(dpy, root, False, GrabModeAsync, GrabModeAsync, CurrentTime);
  • ✅ Capture exclusive du clavier
  • ✅ Neutralisation des touches système (Alt, Super, F4…)
  • ✅ Lecture directe des événements KeyPress
🌠 B. Le moteur physique — L'Animation

Le Starfield repose sur une projection 3D → 2D réelle :

x_screen = (x_3D / z_3D) * focal + center_x
y_screen = (y_3D / z_3D) * focal + center_y
Effet Technique
Profondeur z diminue → l'étoile "s'approche"
Perspective Division naturelle
Luminosité Étoiles lointaines → sombres / proches → brillantes

Caractères Unicode : █ ▓ ▒ ░ ·

🔐 C. La boucle d'écoute — Le Secret
if (c == 'm') last_key = 'm';
else if (last_key == 'm' && c == 'p') locked = 0;
else last_key = 0;
  • 🔹 Détection séquentielle, pas instantanée
  • 🔹 Toute erreur reset la progression
  • 🔹 Le programme reste bloqué tant que la combinaison exacte n'est pas entrée
🧹 D. Le nettoyage — La Restauration
XUngrabKeyboard(dpy, CurrentTime);
printf("\033[?1049l\033[?25h");

[!CAUTION] Partie critique

  • Rend le clavier au système
  • Restaure le terminal normal
  • Évite de "casser" la session utilisateur

🚀 Installation

Prérequis

sudo apt install libx11-dev xterm x11-utils

Compilation

gcc -O3 ultimate_locker_x.c -o locker -lX11

Important

-lX11 doit être à la fin (ordre du linker).


🎮 Utilisation

Lancement

xterm -xrm 'xterm.overrideRedirect: true' -fullscreen -e ./locker

Ou utilisez le script fourni :

./ultimate_locker_x.sh

🔓 Déverrouillage

Tapez la séquence secrète : M puis P

🆘 Sortie d'urgence

Méthode Commande
🖥️ TTY Ctrl + Alt + F3
☠️ Kill pkill locker
🪴 reboot Ctrl + alt + backspace -> restart sessions
🌱 key_boot [ Alt + printscreen ] + 'e'r'i'u'b'

⚠️ Leçons apprises

🔑 Concept Description
Terminal = surcouche Pour bloquer vraiment, il faut parler au serveur graphique
X11 > stdin Pour la capture clavier bas niveau
Porte de secours Toujours prévoir une échappatoire

🧭 Limitations

Status Description
❌ Pas un lockscreen système sécurisé
❌ Dépend fortement de X11 (Wayland = comportement variable)
✅ Excellent exercice bas niveau, architecture, événements, input handling

🧪 Pistes d'amélioration

  • Séquence configurable (argv)
  • Hash + mot de passe
  • Timeout / idle detection
  • Gestion propre de tous les signaux
  • Mode "panic exit" caché
  • Motion blur / traînées d'étoiles

🏁 Conclusion

Ce projet démontre qu'avec du C pur, un terminal et une compréhension fine de X11,
on peut détourner des mécanismes bas niveau pour créer une illusion de contrôle total.


Le système pense toujours être maître.
Mais parfois… on peut lui faire croire le contraire. 🌌


📚 Pour en savoir plus sur X11 → Documentation X11

About

lock your screen in C let's see the start

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages