smart_ide/services/carbonyl

carbonyl — navigateur terminal (amont)

Carbonyl est un navigateur basé sur Chromium affiché dans le terminal (Web APIs, médias, utilisable sans serveur graphique, y compris via SSH).

Ce répertoire services/carbonyl/ regroupe :

• upstream/ : sous-module Git pointant vers le dépôt amont fathyb/carbonyl (fork / suivi des évolutions amont dans ce monorepo).
• run-carbonyl.sh : lancement via Docker (image publique fathyb/carbonyl) ou binaire carbonyl si installé (npm install -g carbonyl).

Ne pas exécuter git submodule update --init --recursive dans upstream/ tant qu’un build Chromium complet n’est pas requis : le sous-module chromium amont est très volumineux. Pour un usage quotidien, préférer Docker ou le binaire précompilé.

Prérequis

• Docker (recommandé) : docker run --rm -ti fathyb/carbonyl https://example.com
• ou dépendances Chromium sur l’hôte si build / binaire local — voir le readme amont.

Variables (optionnelles)

Variable	Rôle
CARBONYL_DOCKER_IMAGE	Image Docker (défaut fathyb/carbonyl)
CARBONYL_RUNNER	docker (défaut) ou native pour appeler carbonyl dans le PATH

Scripts

• ./run-carbonyl.sh <url> — ouvre l’URL dans Carbonyl.
• Depuis la racine du monorepo : scripts/open-carbonyl-preview-test.sh — ouvre l’URL test déclarée pour le projet actif (voir ci-dessous).

Prévisualisation des déploiements test

Dans projects/<id>/conf.json, sous smart_ide, champ optionnel preview_urls :

"preview_urls": {
	"test": "https://app.example.test/"
}

Le script scripts/open-carbonyl-preview-test.sh lit projects/active-project.json (ou SMART_IDE_PROJECT_ID, ou argument --project <id>) puis preview_urls.test. En secours : variable PREVIEW_TEST_URL.

Documentation : docs/repo/service-carbonyl.md, docs/features/carbonyl-terminal-browser.md.

Licence amont

Carbonyl est sous licence BSD-3-Clause (voir upstream/license.md).