Présentation
TinytinyRSS est un agrégateur de flux RSS qui vous permet de rester à l’écoute du Web et de vos amis via l’utilisation de leurs fichier XML (flux RSS).
Téléchargement
Avant toute chose, chargeons TinytinyRSS et mettons là dans l’endroit approprié :
mkdir -p /srv/www/
cd /srv/www/
wget http://tt-rss.org/download/tt-rss-1.3.3.tar.gz
tar xvf tt-rss-1.3.3.tar.gz
mv tt-rss-1.3.3 tinytinyrss
chown www-data:www-data /srv/www/tinytinyrss -R
TinytinyRSS se trouve désormais dans le répertoire /srv/www/tinytinyrss.
Installation
Tutoriel valable pour la version 1.3.3 de TinytinyRSS (pour les versions supérieures, se référer au notes d'installation officielles .
Nous considérons que vous savez :
- Installer apache2 et le configurer
- Installer postgreSQL et/ou MySQL et le configurer
- Installer php5 et le lancer
Une fois Apache configuré pour accéder à votre répertoire tinytinyrss, et votre base de données PostgreSQL (ou MySQL) configurée avec un nouvel utilisateur/mot de passe, procédez à la création de la base de données en utilisant le fichier /srv/www/tinytinyrss/schema/ttrss_schema_VOTREBDD.sql. Par exemple pour PostgreSQL, cela donnera :
su postgres
pgsql --file /srv/www/tinytinyrss/schema/ttrss_schema_pgsql.sql nom_de_votre_bdd
Puis procédez à l’installation des modules nécessaires à l’utilisation de TinytinyRSS :
apt-get install php5-curl php5-pgsql php5-xmlrpc
Après quoi, vient la configuration du fichier config.php situé dans le répertoire /srv/www/tinytinyrss/ :
cd /srv/www/tinytinyrss
cp config.php-dist config.php
chown www-data:www-data config.php
Éditez le fichier config.php et configurez les variables suivantes :
- DB_TYPE : pour une base de données PostgreSQL, mettez pgsql, sinon mettez mysql
- DB_HOST : laissez localhost
- DB_USER : nom d’utilisateur de la base de donnéees
- DB_NAME : nom de la base de données prévue pour TinytinyRSS
- DB_PASS : mot de passe lié à l’utilisateur qui accède à la base de données
- SINGLE_USER_MODE : false pour passer en mode multi-utilisateur et pouvoir ainsi protéger ses flux RSS
- REG_MAX_USERS : chiffre désignant le nombre maximum d’utilisateurs pouvant s’enregistrer sur TinytinyRSS.
Une fois tout cela fait, relancez Apache2, puis accédez à la page d’accueil de TinytinyRSS, l’identifiant et le mot de passe sont les suivants :
- identifiant : admin
- mot de passe : password
Utilisation
En théorie vous ne devriez pas avoir besoin de mes conseils pour l’utilisation. J’espère que l’interface est assez simple pour que vous y naviguiez en toute sérénité !
Astuces
Import des flux de Liferea
Sous Liferea, il suffit simplement de faire Abonnements > Exporter la liste de flux… et de choisir un fichier de destination.
Une fois le fichier opml exporté, allez sous votre interface TinytinyRSS puis allez dans :
- Configuration (lien en haut à droite)
- Feeds (onglet)
- Titre OPML
- Cliquez sur parcourir
- Choisissez votre fichier .opml
- Cliquez sur Importer
Voilà le travail !
Franciser l’interface
Il suffit pour cela d’éditer le fichier config.php et de mettre à true la variable ENABLE_TRANSLATIONS.
Mettre à jour régulièrement les flux RSS (sans connexion)
Je vous suggère de suivre le tutoriel suivant : http://howto.landure.fr/gnu-linux/debian-4-0-etch-en/install-tiny-tiny-rss-on-debian-4-0-etch/view
Notamment le titre Updating feeds, dont voici une traduction rapide et grossière :
Vous voudriez probablement mettre à jour régulièrement vos flux RSS, même si vous ne vous connectez pas. Pour arriver à cela, installez l’interface en ligne de commande pour PHP :
/usr/bin/apt-get install php5-cli
Modifier le fichier de configuration de TinytinyRSS afin d’activer la mise à jour des flux RSS par le démon :
/bin/sed -i <br/>
-e "s/<br/>(define('ENABLE_UPDATE_DAEMON', <br/>).*/<br/>1true);/" <br/>
/srv/www/tinytinyrss/config.php
Changer la location des fichiers lock :
/bin/sed -i <br/>
-e "s/<br/>(define('LOCK_DIRECTORY', <br/>).*/<br/>1'<br/>/var<br/>/run<br/>/tt-rss');/" <br/>
/srv/www/tinytinyrss/config.php
Puis créer le dossier qui sera utilisé pour sauver ces fichiers lock :
/bin/mkdir /var/run/tt-rss
Télécharger le fichier de configuration du script init.d pour TinytinyRSS :
/usr/bin/wget http://howto.landure.fr/gnu-linux/debian-4-0-etch/installer-tiny-tiny-rss-sur-debian-4-0-etch/tt-rss-default <br/>
--output-document=/etc/default/tt-rss
Télécharger le script init.d pour TinytinyRSS :
/usr/bin/wget http://howto.landure.fr/gnu-linux/debian-4-0-etch/installer-tiny-tiny-rss-sur-debian-4-0-etch/tt-rss-initd <br/>
--output-document=/etc/init.d/tt-rss
Rendez le exécutable :
/bin/chmod +x /etc/init.d/tt-rss
Vous pouvez désormais lancer le script de mise à jour via la commande :
/etc/init.d/tt-rss start
NdT : il semblerait que l’auteur ait omis le fait qu’il faille modifier le fichier /etc/default/tt-rss afin d’y donner le chemin correct de votre installation de TinytinyRSS. Ceci donne ainsi quelque chose comme :
TTRSS_PATH="/srv/www/rss"
Mais également l’arrêter via :
/etc/init.d/tt-rss stop
Si vous voulez que le script de mise à jour soit lancé au démarrage de la machine, utilisez la ligne de commande suivante :
/usr/sbin/update-rc.d tt-rss defaults
Avant la version 1.2.20, le démon de mise à jour n’est pas très stable. Il est recommandé d’utiliser un script cron pour le relancer régulièrement :
/bin/echo '#!/bin/sh
# Start tt-rss udpate daemon if necessary :
if [ -x /etc/init.d/tt-rss ]; then
/etc/init.d/tt-rss start
fi' | /usr/bin/tee /etc/cron.hourly/tt-rss
/bin/chmod +x /etc/cron.hourly/tt-rss
Le démon est seulement lancé s’il n’est pas démarré, chose possible grâce à la présence des fichiers lock. Cette tâche cron ne pose aucunement problème.
NB : Je n’ai pas réussi à faire fonctionner le script tel quel. Il m’a fallu activer la variable FORKING=1 dans le fichier /etc/default/tt-rss pour utiliser update_daemon2.php au lieu du démon de base.