138 lines
4.2 KiB
Markdown
138 lines
4.2 KiB
Markdown
# Helmarr (iOS)
|
|
|
|
Application iOS native pour gérer les services Servarr depuis iPhone/iPad.
|
|
|
|
## Présentation
|
|
|
|
Helmarr est une app iOS/iPadOS/macOS pour contrôler Radarr, Sonarr, Prowlarr, Transmission et autres services *arr depuis mobile. Interface native, widgets Home Screen, notifications push.
|
|
|
|
!!! info "App Store"
|
|
[Helmarr sur l'App Store](https://apps.apple.com/app/helmarr/id1638624921) — Gratuit
|
|
|
|
## Services supportés
|
|
|
|
| Service | Fonction | Supporté |
|
|
|---------|----------|----------|
|
|
| Sonarr | Séries TV | ✅ |
|
|
| Radarr | Films | ✅ |
|
|
| Lidarr | Musique | ✅ |
|
|
| Prowlarr | Indexeurs | ✅ |
|
|
| Transmission | Torrents | ✅ |
|
|
| Tautulli | Stats Plex | ✅ |
|
|
| Overseerr/Jellyseerr | Requêtes | ✅ |
|
|
| SABnzbd/NZBGet | Usenet | ✅ |
|
|
|
|
## Configuration Talloires
|
|
|
|
### URLs et API Keys
|
|
|
|
| Service | URL Tailscale | API Key |
|
|
|---------|---------------|---------|
|
|
| **Radarr** | `https://radarr.talloires.tailfd281f.ts.net` | `b87fbcc6737e4d6a8c3c64f91bb81cef` |
|
|
| **Sonarr** | `https://sonarr.talloires.tailfd281f.ts.net` | `eb2cc87743de4ff18944d684f7e33da2` |
|
|
| **Prowlarr** | `https://prowlarr.talloires.tailfd281f.ts.net` | `813a9853a8bc468c8d6a4f013373cff7` |
|
|
| **Transmission** | `https://transmission.talloires.tailfd281f.ts.net` | *(auth basique)* |
|
|
|
|
!!! warning "Sécurité"
|
|
Ces API keys donnent un accès complet aux services. Ne pas partager.
|
|
|
|
### Étapes de configuration
|
|
|
|
1. **Installer Helmarr** depuis l'App Store
|
|
|
|
2. **Ajouter Radarr** :
|
|
- Tap `+` → `Radarr`
|
|
- **Host** : `radarr.talloires.tailfd281f.ts.net`
|
|
- **Port** : `443`
|
|
- **API Key** : `b87fbcc6737e4d6a8c3c64f91bb81cef`
|
|
- **SSL** : ✅ Activé
|
|
- **Validate Certificate** : ✅ (certificat Tailscale valide)
|
|
|
|
3. **Ajouter Sonarr** :
|
|
- Tap `+` → `Sonarr`
|
|
- **Host** : `sonarr.talloires.tailfd281f.ts.net`
|
|
- **Port** : `443`
|
|
- **API Key** : `eb2cc87743de4ff18944d684f7e33da2`
|
|
- **SSL** : ✅ Activé
|
|
|
|
4. **Ajouter Prowlarr** :
|
|
- Tap `+` → `Prowlarr`
|
|
- **Host** : `prowlarr.talloires.tailfd281f.ts.net`
|
|
- **Port** : `443`
|
|
- **API Key** : `813a9853a8bc468c8d6a4f013373cff7`
|
|
- **SSL** : ✅ Activé
|
|
|
|
5. **Ajouter Transmission** :
|
|
- Tap `+` → `Transmission`
|
|
- **Host** : `transmission.talloires.tailfd281f.ts.net`
|
|
- **Port** : `443`
|
|
- **SSL** : ✅ Activé
|
|
|
|
### Multi-réseau (LAN + Tailscale)
|
|
|
|
Helmarr supporte plusieurs hôtes avec basculement automatique :
|
|
|
|
| Réseau | URL | Quand |
|
|
|--------|-----|-------|
|
|
| **Tailscale** | `*.talloires.tailfd281f.ts.net` | Partout (recommandé) |
|
|
| **LAN** | `*.talloires.local` | À la maison uniquement |
|
|
|
|
!!! tip "Configuration recommandée"
|
|
Utiliser uniquement les URLs Tailscale — fonctionne partout tant que Tailscale est connecté sur l'iPhone.
|
|
|
|
## Fonctionnalités
|
|
|
|
### Widgets Home Screen
|
|
|
|
- **Calendrier** : Prochaines sorties séries/films
|
|
- **Téléchargements** : Queue active
|
|
- **Statistiques** : Taille bibliothèque
|
|
|
|
### Notifications Push
|
|
|
|
Configurer dans chaque *arr app → Settings → Connect → Webhook :
|
|
|
|
```
|
|
URL: https://helmarr.app/webhook/<votre_token>
|
|
Events: On Download, On Upgrade
|
|
```
|
|
|
|
### Recherche interactive
|
|
|
|
- Parcourir IMDb Most Popular
|
|
- Rechercher et ajouter directement
|
|
- Interactive search pour choisir la release
|
|
|
|
## Authentification
|
|
|
|
!!! success "Pas d'Authelia requis"
|
|
Les endpoints `/api/*` sont configurés sans Authelia dans Caddy.
|
|
Helmarr accède directement aux APIs avec la clé API.
|
|
|
|
## Alternatives
|
|
|
|
| App | Prix | Avantages |
|
|
|-----|------|-----------|
|
|
| **Helmarr** | Gratuit | Interface unifiée, widgets |
|
|
| **Ruddarr** | Gratuit (premium $6/an) | Plus joli, open source |
|
|
| **LunaSea** | Gratuit, open source | Plus d'apps supportées |
|
|
|
|
## Dépannage
|
|
|
|
### "Unable to connect"
|
|
|
|
1. Vérifier que Tailscale est connecté sur l'iPhone
|
|
2. Tester l'URL dans Safari : `https://radarr.talloires.tailfd281f.ts.net/api/v3/system/status?apikey=...`
|
|
3. Vérifier que le service tourne : `docker ps | grep radarr`
|
|
|
|
### Certificat invalide
|
|
|
|
Les certificats Tailscale sont valides. Si erreur :
|
|
|
|
- Désactiver temporairement "Validate Certificate"
|
|
- Vérifier que l'heure iPhone est correcte
|
|
|
|
### Lenteur
|
|
|
|
Les services tournent derrière gluetun (VPN). Latence normale ~100-200ms.
|