(See README.en.md for an English version.)

NOTE: En date du 25 septembre 2019, pytoutv ne fonctionne pas avec l'API de TOU.TV et n'est donc pas fonctionnel (voir problème #134.

pytoutv est une librairie écrite en Python 3 qui implémente un client pour TOU.TV.

Ce dépôt contient aussi une interface en ligne de commande.

pytoutv, grâce à l'API publique de TOU.TV (voir toutv/config.py pour les URL publiques), est en mesure de récupérer les listes d'émissions et d'épisodes, obtenir des informations sur des émissions ou des épisodes ou télécharger n'importe quel fichier vidéo distribué publiquement par le service TOU.TV. Les informations téléchargées, incluant les fichiers vidéo, sont destinées à un usage personnel et ne devraient pas être redistribuées, à moins d'une autorisation préalable fournie par les propriétaires de TOU.TV.

Le projet pytoutv n'est pas affilié, connecté ou associé à la Société Radio-Canada ou à CBFT-DT. La Société Radio-Canada ou CBFT-DT ne parrainent pas, n'approuvent pas ou n'endossent pas le projet pytoutv.

Note : bien qu'on parle de pytoutv 2, il n'existe pas de version 1 de pytoutv. Ce projet était auparavant connu sous le nom Tou.tv-console-application et ciblait Python 2. Son réusinage et son changement de nom vers pytoutv a mené à sa version 2. L'interface en ligne de commande demeure assez compatible avec la version précédente.

Dépendances

pytoutv requiert :

Python 3.3+, avec :

Dépendances facultatives :

termcolor (disponible sur PyPI): couleurs dans le terminal (CLI)
PyQt4: interface Qt

pytoutv est réputé fonctionner sur Ubuntu, Debian, Fedora, Arch Linux et Mac OS X.

Installation

Il existe plusieurs méthodes pour installer pytoutv, la plus facile étant en passant par l'outil pip.

Veuillez noter que Python 3.3+ est requis peu importe la méthode utilisée.

Installation des dépendances

Les méthodes d'installation avec pip et setup.py vont automatiquement installer les dépendances Python pour vous. Ceci dit, il peut être préférable de les installer avec le gestionnaire de paquetages de votre distribution :

Sur Debian et Ubuntu, voici comment faire :

$ sudo aptitude install python3-crypto python3-requests python3-setuptools

Sur Fedora:

$ sudo yum install python3-crypto python3-requests python3-setuptools

Sur Arch Linux :

$ sudo pacman -Sy python-crypto python-requests python-setuptools

Avec pip

Assurez-vous d'avoir pip et setuptools. Votre distribution favorite devrait fournir une façon d'obtenir ces paquetages.

Installez ensuite pytoutv à l'aide de pip :

$ sudo pip install pytoutv

Ubuntu et Debian

Sur Debian et Ubuntu, pip utilise par défaut les dépendances en Python 2. Pour régler ce problème, vous pouvez télécharger la version Python 3 de pip :

$ sudo aptitude install python3-pip

Par la suite, il ne suffit que de lancer l'installation avec ce paquet:

$ sudo pip3 install pytoutv

Fedora

Sur Fedora, pip utilise par défaut les dépendances en Python 2. Pour régler ce problème, vous pouvez télécharger la version Python 3 de pip :

$ sudo yum install python3-pip

Par la suite, il ne suffit que de lancer l'installation avec ce paquet:

$ sudo python3-pip install pytoutv

Mac OS X

Apple fournissent leur propre version de Python 2.7, pré-installé avec le système d'exploitation. C'est bien, mais nous avons besoin de 3.3 minimum.

Rendez-vous sur https://www.python.org/download/ pour télécharger la dernière version de Python compatible avec votre système.

Installez-le et ouvrez votre terminal. Si l'exécution de "python3.X" (X étant la sous-version installée, comme 3.3 ou 3.4) vous ouvre le mode de commande de Python 3.3+, tout est correct.

Quittez Python et exécutez:

"sudo pip3 install pytoutv"

Si tout se passe bien, vous devriez ensuite pouvoir l'exécuter!

À NOTER: Il semble que le script d'installation ne place pas de chemin global. Ajoutez: "/Library/Frameworks/Python.framework/Versions/3.4/bin" à "/etc/paths".

Avec setup.py

Tant que vous avez setuptools, vous pouvez installer pytoutv directement en utilisant son script setup.py :

Clonez le dépôt :

$ git clone https://github.com/bvanheu/pytoutv && cd pytoutv
Lancez le script d'installation :

$ sudo ./setup.py install

Librairie

La documentation de la librairie n'est pas encore disponible.

Ligne de commande

L'outil en ligne de commande se nomme simplement toutv. Les commandes les plus couramment utilisées sont:

list: afficher les émissions ou les épisodes d'une émission donnée
info: afficher les informations d'une émission ou d'un épisode
fetch: télécharger un épisode ou tous les épisodes d'une émission donnée
search: chercher un mot-clé parmi les émissions et épisodes
login: fournir les informations de connexion pour Tou.TV Extra

Utilisez toutv -h et toutv <commande> -h pour obtenir plus d'informations à propos des commandes et de leur utilisation.

Proxy

Veuillez noter que toutv honore les variables d'environnement HTTP_PROXY et HTTPS_PROXY, qui devraient contenir les URL complètes des proxies à utiliser, incluant le schéma (http://, https://).

Exemples

Voici quelques exemples d'utilisation de l'interface en ligne de commande.

Se connecter à la section extra de tou.tv

Ceci est requis pour pouvoir télécharger la version 720p des vidéos, et pour télécharger les émissions qui sont exclusives aux membres de la section Extra. Pour les autres cas, le login est optionnel.

$ toutv login <USERNAME>
Password: <PASSWORD>
Login successful
Token: c3458d85-6094-4030-9454-114380b2dec0

Liste de toutes les émissions

Note: toutes les émissions, incluant celles qui sont exclusives aux membres de la section Extra.

$ toutv list
2416249839: 2030, Le Big Bang démographique
2424965959: 26 lettres
1735242576: 30 vies
2415880603: Ainsi soient-ils
2284422575: Air de famille (Un)
2424965905: Alain Bashung faisons envie
2424966134: Alfred Hitchcock : Agent secret
2424966154: Alfred Hitchcock : Aventure malgache
...

Liste des épisodes d'une émission

$ toutv list 'physique ou chimie'
Physique ou chimie:

  * 2160477711: S01E01 Des choses à faire avant de mourir
  * 2160477623: S01E02 Agir ou laisser faire
  * 2160483636: S01E03 Uniquement sexuel
  * 2160483351: S01E04 Dommages collatéraux
  * 2160490365: S01E05 Une victoire très curieuse
  * 2160490718: S01E06 Il en faut du courage
  * 2160497332: S01E07 Aller de l’avant
  * 2160497534: S01E08 Le prix de la liberté
  * 2161200777: S01E09 Égoïsme raisonnable
  * 2161201111: S01E10 Réactions en chaîne
  ...

Informations d'une émission

$ toutv info 'physique ou chimie'
Physique ou chimie  [Unknown country]

Blanche, Irène, Jonathan et Rock, professeurs au Collège Zurbarán à Madrid, sont
censés servir de guides à leurs étudiants, alors qu'eux-mêmes ont une vie
compliquée. Ils découvriront assez rapidement qu'enseigner est la meilleure
façon d'apprendre la vie. Entre amours, amitiés, trahisons et déceptions, la
série espagnole Physique ou chimie met de l’avant les hauts et les bas que
vivent les élèves et les professeurs.


Infos:

  * Tags: jeunesse, rogers

Informations d'un épisode

$ toutv info 'Série noire' S01E08
Série noire
Épisode 8  [S01E08]

Ébranlés par les récentes découvertes, Denis et Patrick tentent d’en savoir
davantage sur l’identité de la mystérieuse femme corpulente. Charlène et Judith
les aideront-elles à éclaircir cette nouvelle piste? Victimes d’un kidnapping,
Denis et Patrick découvrent, au péril de leur vie, les motivations étonnantes de
l’organisation criminelle de Bruno.


Infos:

  * Air date: 2014-03-03
  * Available bitrates:
    * 461 kbps
    * 561 kbps
    * 925 kbps
    * 1324 kbps

Téléchargement d'un épisode

$ toutv fetch Enquete S2014E11
Enquête.S2014E11.La.guerre.d...    28.8 MiB    24/260 [##-----------------]   9%

Téléchargement d'un épisode avec la meilleure qualité vidéo disponible

$ toutv fetch -q MAX 'série noire' s01e05
Série.noire.S01E05.Épisode.5...    63.7 MiB    38/260 [###----------------]  14%

Téléchargement de tous les épisodes d'une émission donnée avec une qualité moyenne

$ toutv fetch 'en audition avec simon'
En.audition.avec.Simon.S01E01...    16.5 MiB   15/15 [####################] 100%
En.audition.avec.Simon.S03E47...    24.9 MiB   23/23 [####################] 100%
En.audition.avec.Simon.S01E17...     9.9 MiB    9/27 [#######-------------]  33%
...

Spécifier une émission ou un épisode avec un URL

Vous pouvez utiliser un URL tou.tv au lieu d'un nom pour une émission ou un épisode, pour les commandes fetch, info, et list.

$ toutv fetch http://ici.tou.tv/le-show-cache-2
$ toutv fetch http://ici.tou.tv/le-show-cache-2/S2014E02
$ toutv info http://ici.tou.tv/le-show-cache-2
$ toutv info http://ici.tou.tv/le-show-cache-2/

Pytoutv

Install / Use

README