Cups2freefax¶

Description¶

Ce projet open-source permet aux Freenautes sous Linux d'envoyer des faxs sans avoir a ouvrir son navigateur sur le site de Free via au choix :
- une imprimante virtuelle CUPS.
- le menu contextuel de KDE ou Gnome
- en CLI pure ( ligne de commande ) via le sous projet fax4free
Pour les 2 premiers items, les interactions avec l'utilisateur de l'imprimante se passe via des boites de dialogues graphiques, voir captures ci-dessous.

Captures d'écran¶

Exemple graphique avec les boites de dialogues à partir du menu d'impression de Cups :

Menu contextuel sous KDE ( clic droit sur un fichier pdf, txt, odt... ) :

Menu contextuel sous Gnome ( clic droit sur un fichier pdf, txt, odt... ) :
A noter que ce menu n'apparait qu'après avoir lancé cups2freefax au moins une fois via cups.

Apres le choix du menu contextuel ou de Cups :

Envoi effectif du fax :

Features¶

Voici les principales features gérées :
- gestion des faxs en CLI ou GUI ( ligne de commande ou en graphique )
- les identifiants de login sont conservés dés la première utilisation
- implémentation de toutes les options de la console fax Free ( cacher le destinataire, option de confirmation par mail ) et plus :
récupération des faxs tels que reçus par le destinataire avec durée paramétrable de 0 à l'infini
- envoi par menu contextuel pour KDE et/ou Gnome
- répertoire téléphonique des numéros de faxs
- vérifications optionnelle des nouvelles version de cups2freefax
- gestion de l'impression en réseau via export DISPLAY ( nécessite de configurer le serveur X pour cela )
- interactions web en HTTPS pour plus de sécurité

Ce projet a été testé avec succès sous Linux ( différentes distributions ).

Prérequis pacquages système¶

Les pré requis sont cups, zenity, gcc et les module Perl WWW::Mechanize et Net::SSLeay.

Pour tout installer sous Debian et dérivés ( ubuntu, knoppix, kanotix, linspire, mepis, xandros...) en console :
on peux aussi utiliser synaptic pour les réfractaires à la ligne de commande

sudo aptitude update; sudo aptitude install cups zenity gcc libwww-mechanize-perl libnet-ssleay-perl

Archlinux :

pacman -Sy cups zenity gcc perl-www-mechanize perl-net-ssleay

Mandriva :

urpmi cups zenity urpmi perl-HTML-Tree perl-WWW-Mechanize perl-Net-SSLeay

RedHat, Centos :

yum install cups zenity gcc perl-HTML-Tree perl-WWW-Mechanize perl-Net-SSLeay

OpenSuse :

zypper install cups zenity gcc perl-HTML-Tree perl-WWW-Mechanize perl-Net-SSLeay

Gentoo :

emerge net-print/cups gnome-extra/zenity sys-devel/gcc dev-perl/WWW-Mechanize dev-perl/Net-SSLeay

Install¶

Ouvrir une console en tant que user simple ( xterm, konsole, gnome-terminal... ) dans une session X ( Xorg ).

cd /tmp
wget http://www.sputnick-area.net/scripts/cups2freefax/cups2freefax_current.run
chmod +x cups2freefax_current.run
sudo /tmp/cups2freefax_current.run

Si vous n'utilisez pas sudo concernant cette dernière ligne d'instructions, tapez :

su    # taper son mot de passe "en aveugle" 
/tmp/cups2freefax_current.run

Usage avancé¶

L'installeur gère quelques options :

# bash /tmp/cups2freefax_201004262125.run -- -h
Verifying archive integrity... All good.
Uncompressing  installation de cups2freefax ....................

Aide des options de cups2freefax :
./cups2freefax_xxx.run
./cups2freefax_xxx.run -f         installer uniquement le script fax4free utilisable seulement en CLI
./cups2freefax_xxx.run -u         désinstallation de cups2freefax et fax4free
./cups2freefax_xxx.run -d :N     N est le numéro du DISPLAY, :0 pour l'installation si non renseigné.
./cups2freefax_xxx.run -h        la présente aide

Message final du package d'install¶

La sortie comportant le tutoriel en utilisation basique ( se laisser guider... )

Configuration personnelle ( ce n'est normalement utile que pour faire des corrections )¶

On gère cela via le fichier ~/.cups2freefax/cups2freefaxrc :

On y peux paramétrer les mêmes options que dans la console web FAX de http://free.fr,

# Fichier d'environnement de cups2freefax sourcé par cups2freefax.bash

# Login et password de l'interface free
login=xxxxxxxxx
password=xxxxxxxx

# Masquer le numéro appelant : ( yes ou no. defaut = no )
cups2freefax_hide_fax_number=no

# Recevoir un rapport de transmission par e-mail : ( yes ou no. defaut =  no )
cups2freefax_email_confirmation=no

# Durée en jours de rétention de la copie des faxs envoyés.
# Pour ne rien récuperer, mettre cups2freefax_faxs_store=0
cups2freefax_faxs_store=365

# Support de l'export DISPLAY en réseau
#cups2freefax_export_display=true

Édition manuelle du répertoire des numéros de fax ( ce n'est normalement utile que pour faire des corrections )¶

$ editor ~/.cups2freefax/repertoire_tel_fax

Utiliser cette syntaxe :

0148765442 Pierre
0954661277 Alex

Sources¶

Pour voir les sources :

cd /tmp
wget http://www.sputnick-area.net/scripts/cups2freefax/cups2freefax_current.run
chmod +x cups2freefax_current.run
mkdir /tmp/sources-cups2freefax
cd !$
/tmp/cups2freefax_current.run --tar xf
ls -l

Troubleshooting¶

Si un problème survient, surveiller ~/.cups2freefax/log/cups2freefax.log, /var/log/cups/cups2freefax_log et /var/log/cups/error_log

Vous pouvez aussi faire un bug report, une feature request ou une demande de support sur :
https://redmine.sputnick-area.net/projects/cups2freefax/issues/new

Enjoy ;)

++,sputnick

Also available in: HTML TXT

cups2freefax

Wiki