docs: ajouter section Desktop (Tauri) dans README principal + refonte desktop/README.md
CI / lint (push) Successful in 56s
CI / security (push) Successful in 14s
CI / test (push) Successful in 28s
CI / build (push) Successful in 7s
CI / e2e (push) Failing after 28s
Desktop Build / build-windows (push) Has been cancelled
Desktop Build / build-linux (push) Has been cancelled

- README.md: nouvelle section Desktop avec install binaires (.deb/.AppImage/.msi), build from source, architecture
- desktop/README.md: refonte complète — install binaires, build, démarrage, config vaults, dépannage
This commit is contained in:
2026-07-26 10:01:36 -04:00
parent ec32030afc
commit cf30dfb48c
2 changed files with 311 additions and 36 deletions
+92
View File
@@ -35,6 +35,7 @@
- [🔒 Authentification](#-authentification)
- [Ajouter une nouvelle vault](#-ajouter-une-nouvelle-vault)
- [Build & déploiement avec build.sh](#-build--déploiement-avec-buildsh)
- [Desktop (Tauri) — Application native](#-desktop-tauri--application-native)
- [Utilisation](#-utilisation)
- [API](#-api)
- [Performance](#-performance)
@@ -495,6 +496,97 @@ curl -X POST http://localhost:2020/api/attachments/rescan/MonVault
---
## 🖥️ Desktop (Tauri) — Application native
ObsiGate Desktop est une application native construite avec [Tauri](https://tauri.app/) (Rust + webview système). Elle embarque le backend Python et le frontend dans un exécutable standalone — zéro Docker, zéro ligne de commande.
> 🚧 **Version 2.0.0 — binaires en cours de stabilisation.** Pour l'instant, le build depuis les sources est recommandé.
### Fonctionnalités desktop natives
| Fonctionnalité | Web | Desktop |
|---|---|---|
| Accès fichiers local | Via upload | Natif (sélecteur dossier) |
| Thème système | Manuel | Auto (suit OS dark/light) |
| Notifications | Service Worker | Natif OS |
| Associations `.md` | ❌ | ✅ « Ouvrir avec ObsiGate » |
| Tray icon | ❌ | ✅ Barre des tâches |
| Auto-update | ❌ | ✅ Vérifie les releases Gitea |
| Mode hors-ligne | Limité | Complet (backend local) |
### Téléchargement (binaires pré-buildés)
Les releases sont publiées sur [Gitea](https://git.dracodev.net/Projets/ObsiGate/releases) :
| Plateforme | Format |
|---|---|
| **Linux** | `.deb` + `.AppImage` |
| **Windows** | `.msi` + `.exe` (NSIS) |
#### Linux
```bash
# .deb (Debian/Ubuntu/Deepin)
sudo dpkg -i obsigate_2.0.0_amd64.deb
# Lancer : ObsiGate depuis le menu applications ou `obsigate-desktop`
# .AppImage (toute distrib)
chmod +x ObsiGate_2.0.0_amd64.AppImage
./ObsiGate_2.0.0_amd64.AppImage
```
#### Windows
```cmd
:: Double-cliquer sur ObsiGate_2.0.0_x64.msi
:: Ou lancer ObsiGate depuis le menu Démarrer
```
### Démarrage
1. **Lance l'application** depuis le menu ou la ligne de commande
2. Le backend Python démarre automatiquement sur `127.0.0.1:17890`
3. La fenêtre s'ouvre et charge l'interface ObsiGate
4. **Premier lancement** : sélectionne le dossier de tes vaults Obsidian via le sélecteur natif
5. Pour fermer : icône tray → Quitter (arrêt propre du backend)
### Build depuis les sources
Voir le [guide détaillé dans desktop/](./desktop/README.md).
```bash
# Linux
cd desktop
chmod +x build-linux.sh
./build-linux.sh
# → target/release/bundle/deb/obsigate_2.0.0_amd64.deb
# → target/release/bundle/appimage/ObsiGate_2.0.0_amd64.AppImage
```
```cmd
REM Windows
cd desktop
build-windows.bat
REM → target/release/bundle/msi/ObsiGate_2.0.0_x64.msi
```
### Architecture Desktop
```
┌────────────────────────────────────────────┐
│ Tauri (Rust) │
│ ├─ Webview (webview système) │
│ │ └─ Frontend (HTML/JS/CSS) │
│ └─ Sidecar Python │
│ └─ uvicorn backend.main:app │
│ └─ port 127.0.0.1:17890 │
└────────────────────────────────────────────┘
```
Cycle de vie : Tauri spawn le backend Python → health check → ouvre la webview. À la fermeture : SIGTERM → arrêt propre → nettoyage.
---
## �📖 Utilisation
### Interface web