Readme

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

3.6 KiB Raw Blame History