🔌 Bifrost — SwitchToTelmiOS

---

🇫🇷 Français

⚡ Basculer de OnionOS vers TelmiOS en un clic

Plugin OnionOS pour Miyoo Mini / Mini Plus qui permet de quitter OnionOS et démarrer TelmiOS directement depuis le menu Apps, sans passer par le menu Bifrost au redémarrage.

🤖 Ce projet a été entièrement vibe codé avec Claude Code — l'IA de développement d'Anthropic.

⚠️ Prérequis : Ce plugin nécessite le dualboot Miyoo-Bifrost installé sur la carte SD.

---

🎬 Comment ça marche

📱 OnionOS → Apps → Switch TelmiOS → Confirmer → 💫 Reboot → TelmiOS

1. 🔍 Vérifie que TelmiOS est bien installé sur la carte SD
2. 💬 Affiche un écran de confirmation natif OnionOS
3. ✅ A = Confirmer → écrit le choix + flag autoboot → reboot
4. ❌ B = Annuler → retour au menu OnionOS, rien n'est modifié
5. ⚡ Au redémarrage, le menu Bifrost est sauté automatiquement → TelmiOS démarre directement

---

📦 Contenu du plugin

SwitchToTelmiOS/
├── 📄 config.json      ← Déclaration de l'app pour OnionOS
├── 📜 launch.sh        ← Script principal (vérification + confirmation + switch)
└── 📁 res/
    └── 🖼️ icon.png     ← Icône 96×96 de l'app

---

🛠️ Installation

Étape 1 — Mettre à jour le dualboot Bifrost

Le plugin utilise le mode Autoboot de Bifrost. Si tu utilises une ancienne version de Bifrost, mets à jour le fichier runtime.sh :

1. 📥 Copie le fichier DualBoot/.tmp_update/runtime.sh de ce repo
2. 📋 Colle-le sur la carte SD dans SD:\.tmp_update\runtime.sh (remplace l'ancien)

✅ Si tu viens d'installer Bifrost depuis le repo principal, cette mise à jour est déjà incluse.

Étape 2 — Installer le plugin sur la carte SD

1. 📥 Télécharge ce repo (bouton vert Code → Download ZIP)
2. 📁 Copie le dossier SwitchToTelmiOS/ sur la carte SD dans :

SD:\App\SwitchToTelmiOS\

Ta carte SD doit ressembler à ça :

SD:\
├── 📁 .tmp_update\         ← Bifrost (dualboot)
├── 📁 App\
│   ├── 📁 Terminal\        ← App OnionOS existante
│   ├── 📁 Tweaks\          ← App OnionOS existante
│   └── 📁 SwitchToTelmiOS\ ← ⭐ LE PLUGIN
│       ├── config.json
│       ├── launch.sh
│       └── res/
│           └── icon.png
├── 📁 onion\               ← OnionOS
├── 📁 telmios\             ← TelmiOS
└── ...

Étape 3 — Éjecter et tester

1. 💾 Éjecte proprement la carte SD
2. 📱 Insère-la dans le Miyoo Mini
3. 🚀 Démarre sur OnionOS → va dans Apps → Switch TelmiOS
4. ✅ Confirme avec A → la console redémarre directement dans TelmiOS !

---

✅ Vérifications effectuées par le plugin

Avant de basculer, le plugin vérifie que TelmiOS est correctement installé :

Vérification	Chemin vérifié
📁 Dossier TelmiOS	telmios/
📁 Système TelmiOS	telmios/.tmp_update/
📜 Script de démarrage	telmios/.tmp_update/runtime.sh
⚙️ Binaires	telmios/.tmp_update/bin/
📚 Librairies	telmios/.tmp_update/lib/

Si un élément manque → message d'erreur affiché → aucune modification n'est faite.

---

🔧 Comment ça fonctionne (technique)

Le plugin écrit deux fichiers sur la carte SD puis redémarre :

1. .bootchoice → contient telmios (le dualboot Bifrost lit ce fichier pour savoir quel OS lancer)
2. .autoboot → flag one-shot qui indique à Bifrost de sauter le menu interactif et de lancer directement l'OS dans .bootchoice

Au prochain démarrage, Bifrost voit .autoboot, le supprime, et lance TelmiOS sans attente ni interaction.

---

🐛 Dépannage

Problème	Solution
L'app n'apparaît pas dans OnionOS	Vérifie que SD:\App\SwitchToTelmiOS\config.json existe
L'app dit "TelmiOS introuvable"	Vérifie que SD:\telmios\.tmp_update\runtime.sh existe
Le menu Bifrost s'affiche au reboot	Le runtime.sh de Bifrost n'est pas à jour — remplace-le (voir Étape 1)
Erreur silencieuse (retour menu)	Consulte le log : SD:\.tmp_update\logs\switch_telmios.log

---

📎 Liens

• 🏠 Dualboot Bifrost : github.com/mkl159/Miyoo-Bifrost-
• 🧅 OnionOS : github.com/OnionUI/Onion
• 📖 TelmiOS : github.com/DantSu/Telmi-story-teller

---

📜 Licence

Projet communautaire non officiel. OnionOS et TelmiOS sont des projets indépendants.

---

---

🇬🇧 English

⚡ Switch from OnionOS to TelmiOS in one click

OnionOS plugin for Miyoo Mini / Mini Plus that lets you leave OnionOS and boot into TelmiOS directly from the Apps menu, skipping the Bifrost boot menu entirely on restart.

🤖 This project was entirely vibe coded with Claude Code — Anthropic's AI development tool.

⚠️ Prerequisite: This plugin requires the Miyoo-Bifrost dualboot installed on the SD card.

---

🎬 How it works

📱 OnionOS → Apps → Switch TelmiOS → Confirm → 💫 Reboot → TelmiOS

1. 🔍 Checks that TelmiOS is properly installed on the SD card
2. 💬 Shows a native OnionOS confirmation dialog
3. ✅ A = Confirm → writes choice + autoboot flag → reboot
4. ❌ B = Cancel → back to OnionOS menu, nothing is modified
5. ⚡ On restart, the Bifrost menu is automatically skipped → TelmiOS boots directly

---

📦 Plugin contents

SwitchToTelmiOS/
├── 📄 config.json      ← App declaration for OnionOS
├── 📜 launch.sh        ← Main script (verify + confirm + switch)
└── 📁 res/
    └── 🖼️ icon.png     ← 96×96 app icon

---

🛠️ Installation

Step 1 — Update the Bifrost dualboot

The plugin uses Bifrost's Autoboot mode. If you're on an older Bifrost version, update runtime.sh:

1. 📥 Copy the DualBoot/.tmp_update/runtime.sh file from this repo
2. 📋 Paste it on the SD card at SD:\.tmp_update\runtime.sh (replace existing)

✅ If you just installed Bifrost from the main repo, this update is already included.

Step 2 — Install the plugin on the SD card

1. 📥 Download this repo (green Code → Download ZIP button)
2. 📁 Copy the SwitchToTelmiOS/ folder to the SD card at:

SD:\App\SwitchToTelmiOS\

Your SD card should look like this:

SD:\
├── 📁 .tmp_update\         ← Bifrost (dualboot)
├── 📁 App\
│   ├── 📁 Terminal\        ← Existing OnionOS app
│   ├── 📁 Tweaks\          ← Existing OnionOS app
│   └── 📁 SwitchToTelmiOS\ ← ⭐ THE PLUGIN
│       ├── config.json
│       ├── launch.sh
│       └── res/
│           └── icon.png
├── 📁 onion\               ← OnionOS
├── 📁 telmios\             ← TelmiOS
└── ...

Step 3 — Eject and test

1. 💾 Safely eject the SD card
2. 📱 Insert it into the Miyoo Mini
3. 🚀 Boot into OnionOS → go to Apps → Switch TelmiOS
4. ✅ Confirm with A → the console reboots directly into TelmiOS!

---

✅ Checks performed by the plugin

Before switching, the plugin verifies TelmiOS is properly installed:

Check	Path verified
📁 TelmiOS folder	telmios/
📁 TelmiOS system	telmios/.tmp_update/
📜 Startup script	telmios/.tmp_update/runtime.sh
⚙️ Binaries	telmios/.tmp_update/bin/
📚 Libraries	telmios/.tmp_update/lib/

If anything is missing → error message displayed → no changes are made.

---

🔧 How it works (technical)

The plugin writes two files to the SD card then reboots:

1. .bootchoice → contains telmios (the Bifrost dualboot reads this to know which OS to launch)
2. .autoboot → one-shot flag telling Bifrost to skip the interactive menu and directly launch the OS from .bootchoice

On next boot, Bifrost sees .autoboot, deletes it, and launches TelmiOS without any wait or interaction.

---

🐛 Troubleshooting

Issue	Solution
App doesn't appear in OnionOS	Check that SD:\App\SwitchToTelmiOS\config.json exists
App says "TelmiOS not found"	Check that SD:\telmios\.tmp_update\runtime.sh exists
Bifrost menu shows on reboot	Bifrost runtime.sh is outdated — replace it (see Step 1)
Silent error (back to menu)	Check the log: SD:\.tmp_update\logs\switch_telmios.log

---

📎 Links

• 🏠 Bifrost Dualboot: github.com/mkl159/Miyoo-Bifrost-
• 🧅 OnionOS: github.com/OnionUI/Onion
• 📖 TelmiOS: github.com/DantSu/Telmi-story-teller

---

📜 License

Unofficial community project. OnionOS and TelmiOS are independent projects.