đŹđ§ English · đ«đ· Français
-
English · Français
+
L'esprit de Firefox OS. Un Gecko moderne. Une base Gaia commune.
Un projet communautaire pour retrouver une expérience mobile fondée sur le Web, sur PC, Android et téléphone natif.
Firefox OS fork · Open source
+
-
+
đ Le projet · đŠ TĂ©lĂ©chargements · đ Changelog · đ Signaler un bug
-## đŠ Le Web comme interface +[Site](https://vulpes-os.org/?lang=fr) · [TĂ©lĂ©chargements](https://nnsprod.com/git/oversu/VulpesOS/releases) · [Changelog](CHANGELOG.md) · [Signaler un bug](https://nnsprod.com/git/oversu/VulpesOS/issues) -Accueil, paramĂštres, appareil photo, galerie, messages : **Gaia reste l'interface**, composĂ©e de HTML, CSS et JavaScript. Vulpes adapte les API attendues par ces applications Firefox OS Ă un moteur Gecko moderne et Ă des services propres Ă chaque plateforme. +Vulpes OS reprend Firefox OS pour faire fonctionner **Gaia**, son interface et ses applications HTML/CSS/JavaScript, avec un moteur **Gecko** rĂ©cent. -Ce dĂ©pĂŽt contient dĂ©sormais l'interface commune, l'hĂŽte PC, l'application Android, le runtime Tundra et les outils de dĂ©veloppement. C'est une **premiĂšre prĂ©version pour dĂ©veloppeurs**, pas un systĂšme mobile terminĂ©. +Je dĂ©veloppe Vulpes principalement seul, sous le nom dâOverSu, avec lâaide des personnes qui testent et contribuent au projet. **Vulpes est libre et gratuit, et le restera.** Aucun abonnement ni fonctionnalitĂ© payante nâest prĂ©vu. -
Captures de l'environnement de développement PC. Les fonctionnalités dépendent de la plateforme et du matériel disponible.
+
Lâaccueil de Gaia dans la version pour ordinateur.
-## đ„ Choisissez votre plateforme +## Essayer Vulpes -| Plateforme | Disponible aujourd'hui | Moteur | -| --- | --- | --- | -| **PC Linux** | Sources, fenĂȘtre Gaia au format tĂ©lĂ©phone, dĂ©veloppement et tests d'applications | Gecko **156.0.1** | -| **APK Android** | Preview installable ; Android et ses permissions restent en dessous | GeckoView **156.0** | -| **Pixel 3a · Sargo** | Sources Tundra ; build natif de dĂ©veloppement testĂ© sur notre appareil | Gecko **156.0.1** ARM64 | +| Plateforme | Comment lâutiliser | +| --- | --- | +| **Linux** | Lancer Gaia depuis les sources pour dĂ©couvrir lâinterface ou dĂ©velopper les applications. | +| **Android** | Installer lâ[APK disponible dans les releases](https://nnsprod.com/git/oversu/VulpesOS/releases). Il fonctionne dans Android et ne remplace pas le systĂšme du tĂ©lĂ©phone. | +| **Google Pixel 3a · Sargo** | Faire fonctionner Vulpes comme systĂšme natif avec Tundra. Lâimage Ă tĂ©lĂ©charger est encore en prĂ©paration ; les fonctions testĂ©es et les limites sont dĂ©crites dans la [fiche de lâappareil](https://vulpes-os.org/devices/pixel-3a.php?lang=fr). | -### Android â Preview 17 +Sur Pixel 3a, **Tundra dĂ©marre directement Gecko et Gaia** et assure leur accĂšs au matĂ©riel. Droidian a servi dâenvironnement de test au dĂ©but du projet : il nâest pas inclus dans Vulpes OS et Tundra ne repose pas dessus. -TĂ©lĂ©chargez l'APK et `SHA256SUMS.txt` depuis [la release Preview 17](https://nnsprod.com/git/oversu/VulpesOS/releases/tag/v2.7-preview.17). Une installation par-dessus une ancienne Preview Vulpes signĂ©e conserve ses donnĂ©es. +### Linux -- Minimum dĂ©clarĂ© : **Android 8 / API 26**. Cible : **API 37**. -- APK universel : **ARM64, ARMv7 et x86_64** ; environ **600 Mio**, moteur GeckoView inclus. -- Photo et Galerie utilisent Gaia, avec les permissions et l'import de fichiers Android. -- Les appels et SMS sont transmis aux applications Android ; Vulpes n'est pas l'application TĂ©lĂ©phone/SMS par dĂ©faut. -- Des parcours sur Ă©mulateur Android 16 sont testĂ©s. Le minimum SDK dĂ©clarĂ© ne signifie pas que tous les appareils Android ont Ă©tĂ© validĂ©s. -- Il s'agit d'un **build de dĂ©veloppement signĂ©**, avec dĂ©bogage Gecko accessible via ADB autorisĂ©, pas d'une application durcie pour la production. - -### Linux â lancer depuis les sources - -PrĂ©requis : Linux x86_64, Python 3, Git et les bibliothĂšques systĂšme nĂ©cessaires Ă Firefox. Sur Debian/Ubuntu : `git python3 libgtk-3-0 libdbus-glib-1-2 libasound2` (les noms de paquets peuvent varier selon la distribution). +PrĂ©requis : Linux x86_64, Git, Python 3 et les bibliothĂšques systĂšme nĂ©cessaires Ă Firefox. ```sh git clone https://nnsprod.com/git/oversu/VulpesOS.git @@ -48,58 +46,29 @@ cd VulpesOS ./run.sh ``` -`setup.sh` tĂ©lĂ©charge le moteur Mozilla verrouillĂ© et vĂ©rifie son empreinte. Le lancement normal ouvre Gaia sans dĂ©bogueur. Les profils et moteurs tĂ©lĂ©chargĂ©s restent hors Git. +`setup.sh` tĂ©lĂ©charge le moteur Gecko prĂ©vu pour cette version et vĂ©rifie son empreinte. -### Pixel 3a â dĂ©veloppement natif Tundra +### Compiler lâAPK -**Tundra dĂ©marre directement Gecko et Gaia**, avec un espace utilisateur Linux et les services matĂ©riels Android sĂ©lectionnĂ©s pour lâappareil. - -Notre image de dĂ©veloppement Sargo installĂ©e a passĂ© les contrĂŽles de dĂ©marrage et de persistance. Des appels rĂ©els et des SMS dans les deux sens ont Ă©tĂ© observĂ©s ; les derniers essais couvrent les conversations, les bascules de capteur photo, la capture JPEG pleine rĂ©solution, le focus tactile, le zoom numĂ©rique et l'arrĂȘt du vibreur. - -**Une installation autonome est maintenant testĂ©e localement.** Le paquet Fastboot fournit le systĂšme, un espace de donnĂ©es vierge et les composants matĂ©riels associĂ©s au noyau. Il remplace `userdata`, `boot_a`, `dtbo_a` et `vbmeta_a` : il nâutilise plus les fichiers dâune ancienne installation Droidian et ne nĂ©cessite pas de session Android ni dâADB. Deux dĂ©marrages depuis le stockage interne ont passĂ© chacun onze contrĂŽles Gaia et dix contrĂŽles natifs, avec conservation des rĂ©glages. - -Lâinstallation demande un **Pixel 3a (Sargo) dĂ©verrouillĂ©** et efface toutes les donnĂ©es de `userdata`. Le bootloader et les calibrations propres au tĂ©lĂ©phone restent en place. Ce candidat rĂ©serve actuellement 8 Gio au volume, dont 1 Gio de donnĂ©es modifiables ; lâextension automatique nâest pas encore implĂ©mentĂ©e. Il a Ă©tĂ© testĂ© sur notre Pixel, pas sur chaque combinaison de firmware existante. - -**Le paquet autonome nâest pas encore proposĂ© en tĂ©lĂ©chargement dans cette release.** Les recettes et lâinstallateur sont prĂ©parĂ©s ; la revue de provenance et de redistribution des composants matĂ©riels reste Ă terminer. Les sauvegardes et les clĂ©s de maintenance du tĂ©lĂ©phone de dĂ©veloppement ne font pas partie du paquet gĂ©nĂ©rique. - -## đ ïž DerniĂšres Ă©volutions des sources · 8 octobre 2026 - -- **Photo :** bascule des capteurs sĂ©quencĂ©e, libĂ©ration fiable et transport des images corrigĂ©. Capture avant/arriĂšre, focus, zoom et ouverture dans Galerie testĂ©s sur notre Pixel 3a. -- **Contacts :** fiche actualisĂ©e aprĂšs Ă©dition, parcours SMS/sĂ©lecteur/TĂ©lĂ©phone rĂ©tablis et sĂ©lection dâune photo dans Galerie. Les tests PC couvrent recherche, recadrage, favoris et suppression ; les tests natifs couvrent crĂ©ation, Ă©dition et navigation entre applications. -- **Marketplace :** installation dâapplications intĂ©grĂ©e, permissions restreintes et retour contrĂŽlĂ© vers Gaia. -- **Tundra :** outils de build autonome et de restauration, paquets Bluetooth verrouillĂ©s et certificats natifs. La dĂ©couverte matĂ©rielle Bluetooth fonctionne ; lâappairage Gaia et les profils restent Ă terminer. - -**Ces changements de sources sont postĂ©rieurs Ă lâAPK Preview 17 publiĂ©.** Les ressources Android sont prĂ©parĂ©es, mais aucun nouvel APK ni image native contenant tous ces correctifs nâest publiĂ©. Le dernier candidat natif est testĂ© en RAM ; lâenregistrement cellulaire reste en cours dâanalyse et lâaudio des appels dans les deux sens nâest pas encore qualifiĂ©. Lâhistorique commun PC/Android/Tundra se trouve dans [`changelog.json`](changelog.json). - -## âš Ce que nous partageons - -- **Une base Gaia :** interface et services communs pour PC, Android et Tundra. -- **Les applications d'origine :** Photo, Galerie, ParamĂštres et Messages conservent leur interface Gaia, reliĂ©e aux adaptateurs de chaque plateforme. -- **Du code Web Ă©ditable :** les ressources servies sont dans `assets/webapps/`, la compatibilitĂ© commune dans `host/`, les remplacements dans `overrides/`. Rechargez ou redĂ©marrez pour tester, sans recompiler Gecko. Certaines sources historiques de `gaia/` nĂ©cessitent encore la mise Ă jour de leur version regroupĂ©e. -- **Un moteur remplaçable :** tĂ©lĂ©chargements verrouillĂ©s, contrĂŽle d'empreinte, tests isolĂ©s et outils de retour arriĂšre. Une mise Ă jour du moteur se teste et se sĂ©lectionne explicitement ; la compatibilitĂ© n'est pas garantie automatiquement. -- **Des versions distinctes :** Vulpes, Gaia, Gecko et adaptation matĂ©rielle sont identifiĂ©s sĂ©parĂ©ment. GeckoView 156.0 n'est pas prĂ©sentĂ© comme Gecko bureau 156.0.1. - -## đ§Ș Limites actuelles - -Cette Preview contient des adaptateurs matĂ©riels incomplets et des comportements hĂ©ritĂ©s Ă corriger. Sur Sargo, l'aperçu photo tourne autour de 16 images/s ; flash/vidĂ©o, rotation automatique par capteur et suspension complĂšte restent incomplets. L'enregistrement rĂ©seau peut ĂȘtre instable et l'audio d'une conversation dans les deux sens reste Ă qualifier. Un grand dialogue signalĂ© aprĂšs envoi de SMS est encore en cours d'analyse. - -Sur Android, les intĂ©grations suivent les permissions et les restrictions de cycle de vie du systĂšme. Les alarmes Gaia ne sont pas garanties aprĂšs l'arrĂȘt de Vulpes par Android. Certaines commandes non prises en charge restent visibles mais dĂ©sactivĂ©es. Des applications de dĂ©veloppement/test sont incluses. - -Conservez une sauvegarde avant vos essais. Pour signaler un problĂšme, indiquez la plateforme, les versions Vulpes/Gecko et les Ă©tapes de reproduction ; retirez des logs les numĂ©ros, contacts et autres informations personnelles. - -## đ ïž Construire l'APK Android +Depuis la racine du dĂ©pĂŽt : ```sh cd android ./build-apk.sh ``` -Le script installe les outils verrouillĂ©s, prĂ©pare les ressources Gaia communes et construit un APK de dĂ©veloppement signĂ© dans `android/dist/`. L'acceptation des licences SDK Android peut ĂȘtre nĂ©cessaire. Un clone neuf gĂ©nĂšre sa propre clĂ© de signature : il ne pourra pas mettre Ă jour un APK signĂ© avec la clĂ© privĂ©e du projet. +LâAPK de dĂ©veloppement est crĂ©Ă© dans `android/dist/`. Une compilation personnelle utilise sa propre clĂ© de signature : elle ne peut pas mettre Ă jour un APK signĂ© avec la clĂ© du projet. -## đ Remerciements et licences +## Participer -Vulpes OS est un projet communautaire d'**OverSu / NNS Production**, inspirĂ© de Firefox OS. Merci Ă **Mozilla, aux contributeurs Gaia, Ă Capyloon, Droidian, UBports, libhybris, Debian, AOSP** et aux communautĂ©s qui font vivre les systĂšmes mobiles ouverts. +Vous pouvez tester Vulpes, [signaler un problĂšme](https://nnsprod.com/git/oversu/VulpesOS/issues), amĂ©liorer les traductions ou proposer du code. Pour un bug, indiquez la plateforme, la version utilisĂ©e et les Ă©tapes pour le reproduire. -Les nouveaux fichiers Vulpes utilisent **MPL 2.0**. Gaia conserve **Apache 2.0** ; les composants hĂ©ritĂ©s conservent leurs licences et mentions. Voir [LICENSE](LICENSE), [NOTICE](NOTICE) et [la licence Gaia](gaia/LICENSE). Les forks doivent conserver les mentions d'attribution et de licence applicables. +Les avancĂ©es et les comptes rendus dâessais sont dans le [changelog](CHANGELOG.md). Si vous souhaitez contribuer aux frais du projet, la page [Me soutenir](https://vulpes-os.org/support.php?lang=fr) explique Ă quoi sert ce soutien. -Vulpes OS est indĂ©pendant de Mozilla et n'est pas une version officielle de Firefox OS. +## CrĂ©dits et licences + +Merci Ă Mozilla, aux contributeurs de Gaia, Ă Capyloon, Droidian, UBports, libhybris, Debian et AOSP pour le code, les outils et les travaux qui ont aidĂ© le projet. + +Les nouveaux fichiers Vulpes sont sous **MPL 2.0**. Gaia conserve sa licence **Apache 2.0** ; les autres composants conservent leurs licences et mentions. Voir [LICENSE](LICENSE), [NOTICE](NOTICE) et [la licence de Gaia](gaia/LICENSE). + +Vulpes OS est un projet indĂ©pendant dâ**OverSu / NNS Production**, sans affiliation avec Mozilla. diff --git a/README.md b/README.md index 5c5d5f3d..8cb26789 100644 --- a/README.md +++ b/README.md @@ -1,45 +1,43 @@ -đŹđ§ English · đ«đ· Français
-
English · Français
+
The spirit of Firefox OS. A modern Gecko. One shared Gaia.
A community project bringing a web-based phone experience to desktop, Android and native hardware.
Firefox OS fork · Open source
+
-
+
đ Website · đŠ Downloads · đ Changelog · đ Report a bug
-## đŠ The Web as your interface +[Website](https://vulpes-os.org/?lang=en) · [Downloads](https://nnsprod.com/git/oversu/VulpesOS/releases) · [Changelog](CHANGELOG.en.md) · [Report a bug](https://nnsprod.com/git/oversu/VulpesOS/issues) -Home screen, settings, camera, gallery, messages: **Gaia remains the interface**, built from HTML, CSS and JavaScript. Vulpes adapts the APIs that these Firefox OS applications expect to a modern Gecko engine and platform-specific services. +Vulpes OS picks up where Firefox OS left off, adapting **Gaia**, its interface and HTML/CSS/JavaScript applications, to run on a recent **Gecko** engine. -This repository now contains the shared interface, desktop host, Android application, Tundra runtime and development tools. This is an **early developer preview**, not a finished phone operating system. +Iâm OverSu, and I develop Vulpes mostly on my own, with help from people who test and contribute to the project. **Vulpes is free and open source, and will stay that way.** There are no plans for subscriptions or paid features. -
Desktop development screenshots. Capabilities depend on the platform and available hardware.
+
The Gaia home screen in the desktop version.
-## đ„ Choose your platform +## Try Vulpes -| Platform | Available today | Engine | -| --- | --- | --- | -| **Linux desktop** | Source checkout, phone-sized Gaia window, development and app tests | Gecko **156.0.1** | -| **Android APK** | Installable Preview; keeps Android and its permissions underneath | GeckoView **156.0** | -| **Pixel 3a · Sargo** | Tundra sources; native development build tested on our device | Gecko **156.0.1** ARM64 | +| Platform | How to use it | +| --- | --- | +| **Linux** | Run Gaia from source to explore the interface or develop applications. | +| **Android** | Install the [APK from the releases page](https://nnsprod.com/git/oversu/VulpesOS/releases). It runs as an Android application and does not replace your phoneâs operating system. | +| **Google Pixel 3a · Sargo** | Run Vulpes as a native operating system with Tundra. A downloadable image is still being prepared; see the [device page](https://vulpes-os.org/devices/pixel-3a.php?lang=en) for tested features and known limitations. | -### Android â Preview 17 +On the Pixel 3a, **Tundra boots Gecko and Gaia directly** and provides access to the hardware. Droidian was used as a testing environment early in development. It is not included in Vulpes OS, and Tundra is not based on it. -Download the APK and `SHA256SUMS.txt` from [the Preview 17 release](https://nnsprod.com/git/oversu/VulpesOS/releases/tag/v2.7-preview.17). Installing over an earlier signed Vulpes Preview preserves its data. +### Linux -- Minimum declared: **Android 8 / API 26**. Target: **API 37**. -- Universal APK: **ARM64, ARMv7 and x86_64**; approximately **600 MiB** including GeckoView. -- Camera and Gallery use Gaia, with Android permissions and file import. -- Calls and SMS hand off to Android's applications; Vulpes is not the default SMS or phone app. -- Android 16 emulator workflows are tested. Minimum SDK support is not a claim that every Android device is validated. -- This is a signed **development build** with Gecko debugging available through authorized ADB, not a production-hardened app. - -### Linux â run from source - -Linux x86_64, Python 3, Git and the system libraries needed by Firefox are required. On Debian/Ubuntu, install `git python3 libgtk-3-0 libdbus-glib-1-2 libasound2` (package names may differ by distribution). +Youâll need Linux x86_64, Git, Python 3 and the system libraries required by Firefox. ```sh git clone https://nnsprod.com/git/oversu/VulpesOS.git @@ -48,58 +46,29 @@ cd VulpesOS ./run.sh ``` -`setup.sh` downloads the pinned Mozilla engine and verifies its checksum. Normal startup opens the Gaia interface without a debugger. Profiles and downloaded engines stay outside Git. +`setup.sh` downloads the Gecko engine selected for this version and verifies its checksum. -### Pixel 3a â native Tundra development +### Build the APK -**Tundra boots Gecko and Gaia directly**, using Linux userspace and the Android hardware services selected for the device. - -Our installed Sargo development image has passed startup and persistence checks. Real calls and two-way SMS have been observed; the latest checks cover conversation rendering, camera sensor switching, full-resolution JPEG capture, touch focus, digital zoom and bounded vibration. - -**A standalone installation has now been tested locally.** The Fastboot package provides the system, fresh writable storage and the hardware components paired with the kernel. It replaces `userdata`, `boot_a`, `dtbo_a` and `vbmeta_a`: startup no longer uses files from an old Droidian installation and requires neither an Android session nor ADB. Two boots from internal storage passed eleven Gaia and ten native checks each and retained settings. - -Installation requires an **unlocked Pixel 3a (Sargo)** and erases all existing `userdata`. The bootloader and device-specific calibration remain in place. This candidate currently reserves an 8 GiB volume, including 1 GiB of writable data; automatic expansion is not implemented yet. It has been tested on our Pixel, not every existing firmware combination. - -**The standalone package is not yet available as a download in this release.** Build recipes and the installer are prepared; hardware component provenance and redistribution review are still pending. Development-phone backups and maintenance keys are excluded from the generic package. - -## đ ïž Latest source improvements · 8 October 2026 - -- **Camera:** serialized sensor switching, reliable release and binary photo transport. Front/rear capture, focus, zoom and Gallery opening tested on our Pixel 3a. -- **Contacts:** refreshed details after editing, restored SMS/number-picker/dialer flows, and Gallery photo selection. Desktop tests cover search, cropping, favourites and deletion; native tests cover creation, editing and cross-app navigation. -- **Marketplace:** integrated application installation with permission restrictions and controlled return to Gaia. -- **Tundra:** standalone build/recovery tools, pinned Bluetooth runtime packages and native trusted certificates. Bluetooth hardware discovery works; Gaia pairing and profiles remain unfinished. - -**These are source updates, newer than the published Preview 17 APK.** Updated Android assets are prepared, but no new APK or native image containing all these fixes is published. The latest native candidate is tested in RAM; cellular registration remains under investigation and two-way call audio is not yet qualified. See [`changelog.json`](changelog.json) for the shared desktop/Android/Tundra history. - -## âš What is shared - -- **One Gaia base:** interface and common services serve desktop, Android and Tundra. -- **Original applications:** Camera, Gallery, Settings and Messages keep their Gaia UI, backed by platform adapters. -- **Editable web code:** change served assets in `assets/webapps/`, shared compatibility code in `host/`, and replacements in `overrides/`. Restart/reload to test; no Gecko rebuild is needed for these changes. Some historical `gaia/` sources still need their bundled counterparts updated. -- **A replaceable engine:** pinned downloads, checksum verification, isolated compatibility checks and rollback tools. An engine update is tested and explicitly selected; compatibility is not guaranteed automatically. -- **Separate version numbers:** Vulpes release, Gaia, Gecko and hardware adaptation are reported independently. GeckoView 156.0 is not presented as desktop Gecko 156.0.1. - -## đ§Ș Current limits - -This preview contains incomplete hardware adapters and legacy application behavior. On Sargo, camera preview is around 16 fps; flash/video, automatic sensor rotation and full suspend remain incomplete. Network registration can be unstable and two-way call audio still needs end-to-end qualification. A reported large dialog after SMS sending remains under investigation. - -On Android, platform integration follows Android permissions and lifecycle restrictions. Gaia alarms are not guaranteed after Android stops Vulpes. Unsupported controls may remain visible but disabled. Development/test applications are included. - -Keep a backup before testing. Include the platform, Vulpes/Gecko versions and reproduction steps when reporting a problem; remove phone numbers, contacts and other personal information from logs. - -## đ ïž Build the Android APK +From the repository root: ```sh cd android ./build-apk.sh ``` -The script installs the pinned toolchain, packages the shared Gaia resources and builds a signed development APK in `android/dist/`. Android SDK licenses may need acceptance. A fresh checkout generates its own signing key; it cannot update an APK signed by the project's private release key. +The development APK is created in `android/dist/`. A personal build uses its own signing key, so it cannot update an APK signed with the projectâs key. -## đ Credits and licenses +## Contribute -Vulpes OS is a community project by **OverSu / NNS Production**, inspired by Firefox OS. Thanks to **Mozilla, Gaia contributors, Capyloon, Droidian, UBports, libhybris, Debian, AOSP** and the communities keeping open mobile systems alive. +You can test Vulpes, [report an issue](https://nnsprod.com/git/oversu/VulpesOS/issues), improve translations or contribute code. When reporting a bug, include your platform, the version youâre using and the steps to reproduce it. -New Vulpes code uses **MPL 2.0**. Gaia retains **Apache 2.0** and inherited components retain their own licenses and notices. See [LICENSE](LICENSE), [NOTICE](NOTICE) and [Gaia's license](gaia/LICENSE). Preserve the applicable attribution and license notices in forks. +Development updates and test results are in the [changelog](CHANGELOG.en.md). If youâd like to help cover project costs, the [Support me](https://vulpes-os.org/support.php?lang=en) page explains what your contribution supports. -Vulpes OS is independent of Mozilla and is not an official Firefox OS release. +## Credits and licenses + +Thanks to Mozilla, Gaia contributors, Capyloon, Droidian, UBports, libhybris, Debian and AOSP for the code, tools and work that have helped this project. + +New Vulpes code is licensed under **MPL 2.0**. Gaia retains its **Apache 2.0** license; other components retain their own licenses and notices. See [LICENSE](LICENSE), [NOTICE](NOTICE) and [Gaiaâs license](gaia/LICENSE). + +Vulpes OS is an independent project by **OverSu / NNS Production**, with no affiliation with Mozilla.