TUTORIAL Up2Paste - Up2Paste/Windows GitHub Wiki

L'outil Up2Paste (U2P) permet de créer un fichier au format Pastebin pour être utilisé avec vStream.

Le format supporté par vStream est décrit ici : https://github.com/Kodi-vStream/venom-xbmc-addons/wiki/Voir-et-partager-sa-biblioth%C3%A8que-priv%C3%A9e

Cet outil peut travailler à partir des sources :

  • Compte UPTOBOX privé
  • Dossier UPTOBOX publique
  • fichier CSV

PRINCIPE

A partir d'un compte Uptobox ou d'un fichier csv, l'outil produit un fichier texte. Coller le contenu de ce fichier sur le site PasteBin.com.

Il est préférable d'avoir un compte pasteBin afin de mettre à jour un pasteBin existant. Cela évite de supprimer/ajouter le nouvel identifiant dans vStream. Et de devoir partager le nouvel identifiant.

Selon le contenu à récupérer (compte ou fichier csv, films ou séries), il est nécessaire de préparer la configuration dans le fichier \config\makePastebin.cfg

Ci-dessous vous retrouverez le détails des champs disponibles.

Mais pour les modifier, il est plus facile d'utiliser l'outil configU2P.exe

image

A la fin de la configuration, vous sauvegardez et quitter cet outil. Puis vous lancez U2P.exe. Si tout ce passe bien, cela va créer un fichier dans le dossier \extractPastebin\ Vous copiez le contenu de ce fichier sur le site pastebin.com. Pour que l'identifiant pastebin reste toujours le même, il faut créer un compte pastebin.

En renseignant vos identifiants pastebin (ce n'est pas obligatoire), l'outil mettra à jour le contenu de vos différents codes pastes.

EXPORT DE SÉRIES UPTOBOX

Exemple minimum pour une extraction de séries depuis un compte UptoBox :

[keys]
keyUpto = MonTokenUptoBox # RENSEIGNER ICI VOTRE TOKEN UPTOBOX
keyMovieDB = votreCleTMDB  # VOTRE CLEF TMDB si vous en avez une

[RepDistant]
serie = SERIES # Le nom de votre dossier Uptobox qui contient vos séries, chaque série est dans un dossier différent

[Extract]
film = 0
serie = 1
anime = 0

stockage = 2
#1=repertoire publique UptoBox, 2=compte privé UptoBox, 3=fichier csv

modeTMDB = 2 # Si vous avez renseigné une clé TMDB
#0=mode manuel, 1= semi-automatique, 2 automatique

Sur votre compte Uptobox, les épisodes doivent être dans un dossier qui porte le nom de la série. Il est conseillé de mettre l'année de la série dans le titre de ce dossier, ex : Flash (2014) afin d'éviter les erreurs sur les doublons. Dans le dossier de la série, vous pouvez soit créer un dossier par saison, soit déposer les épisodes de toutes les saisons, mais en respectant une syntaxe : S01E01.

IMPORT DE FILMS CSV

Exemple minimum pour l'import de films depuis un fichier CSV :

L'import csv n'est possible que pour les films !

[Config]
name = mesFilms

[keys]
keyMovieDB = votreCleTMDB  # CLEF TMDB si vous en avez une

[Extract]
film = 1
serie = 0
anime = 0

stockage = 3
#1=repertoire publique UptoBox, 2=compte privé UptoBox, 3=fichier csv

modeTMDB = 2
#0=mode manuel, 1= semi-automatique, 2 automatique

# Le fichier csv doit se nommer filesFilms_mesFilms.csv (selon le paramètre '[config] - name' ci-dessus)
# Il doit être constitué des deux colonnes :
# Titre; url

Installation LINUX

Procédure pour une utilisation sous Linux :

sudo apt-get install python3-tk
virtualenv -p python3 --no-site-packages venvPastebin
source venvPastebin/bin/activate
pip install requests
pip install pillow
pip install requests-toolbelt

Lancement : python main.py

Installation Windows

Téléchargeable ici pour Windows : Up2Paste Vous devez le décompresser dans un chemin court qui ne comporte ni d'espace ni d'accent.

Vous devez également installer manuellement le fichier ffprobe.exe dans le dossier \build\ Pour cela, télécharger la version ffmpeg qui correspond à votre système d'exploitation ici : FFMPEG Le fichier ffprobe.exe se trouve dans le dossier \bin du zip.

Lancement depuis ce programme : U2P.exe

PARAMETRES AVANCÉS

Les paramètres avancer se trouve dans le fichier \config\makePastebin.cfg. Il n'est pas conseillé modifier directement le fichier. Il est plus facile d'utiliser l'outil configU2P.exe

Ci-dessous l'ensemble des paramètres ajustable du fichier.

[Config]

name = MonCompte

Nom du fichier de sortie
Avec name = MonCompte, le fichier sera nommé 'extractFilm_MonCompte.txt' pour les films et 'extractSerie_MonCompte.txt' pour les séries.

lang = fr

Langue de recherche pour les informations sur TMDB

certification = 16

Définie l'age minimum (inclue) pour qu'un film soit extrait.

Les films qui dépassent cette limite sont regroupés dans le fichier censure.txt

Vous prenez la responsabilité de recopier les lignes de ce fichier dans votre PasteBin.

Les lignes en haut d'un PasteBin apparaissent en premier, il est conseillé de les ajouter à la fin.

nbFormat = 50

Si vous avez déclaré votre token Uptobox, l'outil peut chercher à identifier la résolution des films pour vous les proposer selon un classement.<br>
Cette recherche ne se fait pas pour l'ensemble des fichiers analysés mais par bloc.<br>
Ce paramètre défini le nombre de fichiers à analyser par bloc.<br>

La limite est 100.

Si vous avez plus de fichiers que cette limite, vous devrez lancer plusieurs fois l'outil. La valeur 0 permet de désactiver la fonctionnalité.

[keys]

keyMovieDB = XXXX

Key TMDB api, afin de produire les informations Genres, Saga, Année, classement par réalisateur, classement par diffuseur (Netflix, Amazon, Canal+, AppleTV+, etc.)
Cette clef est utilisée quelque soir le mode de stockage (1, 2 ou 3)

keyUpto = YYYY

token de votre Compte Uptobox.

Cette clef est obligatoire si vos fichiers sont stockés sur un compte Uptobox (mode de "stockage = 2" dans la section [extract] de ce fichier). Elle est utilisée également avec les autres modes de stockage (2 ou 3) pour retrouver la résolution des films. (Elle est optionnelle dans ce cas).

[Extract] film = 1 serie = 1 anime = 0

# Pour activer le type de contenu à extraire (1 pour extraire, 0 sinon)

Même s'il est conseillé de générer un fichier par type de vidéos pour une meilleur gestion (mise à jour par exemple), vous pouvez activer plusieurs contenus qui se retrouveront dans la même extraction.

stockage = 2

Pour préciser le mode de stockage de vos vidéos à extraire
# 1 = répertoire publique Uptobox
# 2 = compte uptobox (voir le paramètre [RepDistant] pour déclarer les répertoires qui contiennent les vidéos à extraire)
# 3 = fichier csv  (uniquement pour des films)

Le fichier csv doit se nommer filesFilms_MonCompte.csv (selon le paramètre 'name' de la section [Config]) Il doit être constitué des deux colonnes : titre; url

linkFolderFilm = https://uptobox.com/user_public?hash=………

L'URL du dossier publique Uptobox qui contient les FILMS à extraire.
Uniquement pour les films. Pour les séries, voir ci-dessous pour l'utilisation d'un fichier.
Pour utiliser ce mode de stockage, vous devez positionner le paramètre "stockage = 1"

Vous pouvez également laisser ce paramètre vide et fournir un fichier qui contient une liste de dossiers publiques. Séries : le fichier doit s'appeler : listeFolderFichiers_MonCompte.txt Films : le fichier doit s'appeler : listeFolderFilms_MonCompte.txt (le suffixe 'MonCompte' dépend du paramètre 'name' défini dans la section [Config])

Le fichier doit être constitué ainsi, sans entête : titre;url

VICTOR LESSARD;https://uptobox.com/user_public?hash=………...
AU NOM DU PERE ET DU FILS (1993);https://uptobox.com/user_public?hash=………….
LÉO;https://uptobox.com/user_public?hash=..........

[Fournisseur] url = https://uptobox.com/

Optionnel<br>
url de base commune a tous les fichiers du pastebin<br>
L'exemple correspond au mode stockage = 2<br>

modeTMDB = 0

Mode de traitement des résultats TMDB
# 0 => mode manuel : une fenêtre s'ouvre pour choisir les médias si la recherche renvoie plusieurs résultats.
# 1 => mode semi-automatique, prend le premier résultat trouvé si moins de 3 résultats, sinon propose une liste de sélection.
# 2 => mode automatique : prend le premier résultat trouvé.

Retrouver dans le fichier "resultMap.csv", les noms de fichiers dont la syntaxe n'a pas permis de retrouver le nom de la vidéo.

Également, si les informations retrouvées ne correspondent pas au film, vous pouvez demander le rescan du film. Pour cela, il faut sélectionner la ligne dans le fichier pastebin créé, puis la copier dans un fichier film_MonCompte.txt a l'intérieur du répertoire "correction scan". Ainsi le film sera proposé pour une sélection manuelle des informations lors du prochain scan.

[RepDistant] serie = SERIES film = FILMS anime = ANIMES

Avec le mode stockage=2, le nom des répertoires sur votre compte uptobox.

Pour les séries, les épisodes doivent être dans un dossier qui porte le nom de la série. Il est conseillé de mettre l'année de la série dans le titre du dossier, ex : Flash (2014), afin d'éviter les erreurs sur les doublons. Dans le dossier de la série, vous pouvez soit créer un dossier par saison, soit déposer les épisodes de toutes les saisons, mais en respectant une syntaxe : S01E01.

groupe = REP_

Permet de définir le préfixe des noms de groupes de votre compte Uptobox qui doivent être conservés dans vStream.<br>
Si par exemple vous nommer un dossier `REP_Mes films à voir` dans un votre dossier `FILMS`, un dossier `Films à voir` sera créé dans vStream.

Les fichiers qui se trouvent dans les autres dossiers de votre compte seront bien importés également, mais sans conservation des dossiers.

[Logger] niveau = info

# info ou debug

Niveau d'information dans les log. Retrouver dans le fichier "activity.log", les log de niveau "error"

FICHIERS CRÉES

Avec le paramètre "name = test", les fichiers générés seront :

  • \extractPastebin\extractFilm_test.txt => Fichier au format pastebin pour les films
  • \extractPastebin\extractSerie_test.txt => Fichier au format pastebin pour les séries
  • \extractPastebin\extractAnime_test.txt => Fichier au format pastebin pour les séries
  • \bd\mediaVstream_test.bd => historique des recherches TMDB utilisé lors des extractions suivantes
  • errorFilm.txt => liste des films sans resultat de recherche TMDB
  • errorSerie.txt => liste des séries sans resultat de recherche TMDB
  • resultMap.csv => les noms de fichiers dont la syntaxe n'a pas permis de retrouver le nom du média