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