SeedMover
Gestionnaire de transferts dual-pane entre une seedbox et un NAS, accessible depuis navigateur et smartphone.
Fonctionnalités
- Dual-pane — navigation indépendante dans chaque panneau
- Multi-protocoles — Local et SFTP inclus, extensible via plugins
- File d'attente — transferts séquentiels avec progression temps réel, pause et stop
- Historique — suivi de tous les transferts (taille, durée, date, statut)
- Connexions — ajout, édition, test depuis l'interface, persistées entre redémarrages
- Panneaux par défaut — sauvegarde la vue de démarrage en un clic
Démarrage rapide
# Générer une SECRET_KEY
python3 -c "import secrets; print(secrets.token_hex(32))"
# Lancer
docker compose up -d
Accès : http://<ip>:5000
Configuration docker-compose.yml
| Variable | Défaut | Description |
|---|---|---|
SEEDBOX_PATH |
/mnt/seedbox |
Chemin local seedbox |
NAS_PATH |
/mnt/nas |
Chemin local NAS |
APP_USERNAME |
admin |
Identifiant |
APP_PASSWORD |
changeme |
Mot de passe |
SECRET_KEY |
(à changer) | Clé de session Flask |
CACHE_TTL |
60 |
TTL du cache de listing (secondes) |
HISTORY_MAX |
50 |
Nombre max d'entrées dans l'historique |
SESSION_LIFETIME |
86400 |
Durée de session (secondes) |
Ajouter un protocole
Créer plugins/monprotocole.py, hériter de AbstractFS, implémenter les méthodes, définir PLUGIN_NAME et PLUGIN_LABEL. Le plugin est détecté automatiquement au démarrage.
Structure
seedmover/
├── app.py
├── plugins/
│ ├── base.py ← interface abstraite
│ ├── local.py ← système de fichiers local
│ └── sftp.py ← SFTP via Paramiko
├── data/ ← volume Docker (connexions, historique)
├── templates/
│ ├── index.html
│ └── login.html
└── docker-compose.yml
Générer une SECRET_KEY sécurisée
python3 -c "import secrets; print(secrets.token_hex(32))"
Volumes
volumes:
- /mnt/nas/Useed/Media_useed:/mnt/seedbox:ro # seedbox, lecture seule
- /mnt/nas/BOB4-Syno:/mnt/nas # NAS, lecture/écriture
Utilisation
- Se connecter sur
http://ip:5000 - Naviguer dans la seedbox (panneau gauche) avec double-clic
- Naviguer vers le dossier destination sur le NAS (panneau droit)
- Sélectionner un ou plusieurs fichiers/dossiers côté seedbox (clic simple)
- Cliquer sur ⟶ Copier vers NAS
- Suivre la progression dans la file de transfert en bas
Raccourcis
- Double-clic — ouvrir un dossier
- Clic simple — sélectionner/désélectionner
- ↻ Actualiser — forcer un rechargement (bypass cache)
- 📁 — créer un nouveau dossier
- ✏ Renommer — renommer un élément côté NAS
- ⏸ Pause / ▶ Reprendre — suspendre le transfert en cours
- ⏹ Stop — annuler le transfert et supprimer le fichier partiel
- Échap — fermer les modales
- Entrée — valider les modales
Stack technique
- Backend : Python 3.12, Flask, Flask-SocketIO, Eventlet
- Frontend : HTML/CSS/JS vanilla, Socket.IO
- Transport : copie par chunks de 4MB avec progression WebSocket
Notes techniques
- Streaming chunk par chunk (1MB) sans buffer intermédiaire — RAM stable pendant les transferts
malloc_trim()appelé après chaque transfert pour rendre la mémoire au système- Verrou par connexion pour thread-safety Paramiko (évite les "Garbage packet")
- Prefetch SFTP désactivé pour éviter le chargement du fichier entier en RAM