# 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.