diff --git a/docs/scripts/getXfox.md b/docs/scripts/getXfox.md new file mode 100644 index 0000000..e8a3c7c --- /dev/null +++ b/docs/scripts/getXfox.md @@ -0,0 +1,323 @@ +# getXfox + +> c'est un script bash qui télécharge les dernières versions officielles de Tor Browser (version stable) + ou Waterfox +> les mises à jour de Waterfox et Tor Browser sont par défaut autorisées et gérées par ceux-ci. +> le script se mettra éventuellement à jour, sans influence sur les programmes installés. +> le script peut charger des fichiers de personnalisation et les mettra à jour périodiquement +> le script peut désinstaller les programmes + +* les installations/désinstallations doivent être faites avec les privilèges **root** +* les opérations sur l'utilisateur, ou sur la mise à jour du script, peuvent être faites en utilisateur. + +> le programme Firefox est pris en charge par [getFirefox](https://kyodev.frama.io/kyopages/scripts/getFirefox/) + + +## installation rapide du script + +* privilèges **root** requis + +```shell +wget -nv -O getXfox https://framagit.org/kyodev/kyopages/raw/master/scripts/getXfox +chmod +x getXfox && ./getXfox +``` +```text + _ __ __ __ + __ _ ___| |_\ \/ // _| _____ __ + / _' |/ _ \ __|\ /| |_ / _ \ \/ / +| (_| | __/ |_ / \| _| (_) > < + \__, |\___|\__/_/\_\_| \___/_/\_\ + |___/ Tor Browser WaterFox + version 4.2.1 - 24/12/2017 + + getXfox 4.2.1 installé dans le système. + maintenant, appel du script par: getXfox (sans ./) + +``` + +* le script est maintenant dans le système et tout utilisateur peut s'en servir. +* **Aucun programme n'est encore installé** + + +## installation de Tor Browser + +```shell +getXfox i-tor +``` + +* privilèges **root** requis +* la dernière version officielle stable de Tor Browser est installée, en étant directement chargée sur le + site [torproject](https://www.torproject.org/projects/torbrowser.html.en) +* un lanceur est placé dans les menus (Applications/Internet) +* chaque installation est refaite en **totalité**, **le profil est écrasée** étant donné les caractéristiques + d'application portable de Tor Browser. +* Tor Browser peut être lancé en console: `tor-browser` +* Tor Browser est inscrit dans les update-alternatives (si disponible), mais pas configurer comme prioritaire +* une option permet de configurer manuellement, Tor Browser comme prioritaire +* Tor Browser se mettra à jour de lui-même, le script permet cet automatisme +* cette mise à jour se fait en tâche de fond et est disponible au prochain redémarrage +* la mise à jour éventuelle peut être déclenchée manuellement avec le menu `Aide/A propos de Tor Browser` + + +## installation de Waterfox + + +```shell +getXfox i-wfx +``` +* privilèges **root** requis +* la dernière version officielle stable de Tor est installée, en étant directement chargée sur le + site [Waterfox](https://www.torproject.org/projects/torbrowser.html.en) +* un lanceur est placé dans les menus (Applications/Internet) +* chaque installation est refaite en **totalité**, mais **le profil n'est pas écrasé** +* Waterfox peut être lancé en console: `waterfox` +* Waterfox est inscrit dans les update-alternatives (si disponible) et configuré comme prioritaire +* Waterfox se mettra à jour de lui-même, le script permet cet automatisme +* cette mise à jour se fait en tâche de fond et est disponible au prochain redémarrage +* la mise à jour éventuelle peut être déclenchée manuellement avec le menu `Aide/A propos de Waterfox` + + +### présentation rapide + + +* Code Firefox, compilé avec des options différentes de Mozilla +* 64bits uniquement +* extensions Media encryptés désactivées (EME) +* Web runtime désactivé +* Pocket enlevé +* Télémétrie et autres profilages enlevés +* plugins NPAPI 64Bits autorisés +* Extensions non signées permises +* pas de liens sponsorisés sur la _Nouvelle Page_ +* Option: dupliquer l'onglet +* sélecteur de locale dans les préférences générales + + + +## help + +```shell +getXfox -h +``` +```text + _ __ __ __ + __ _ ___| |_\ \/ // _| _____ __ + / _' |/ _ \ __|\ /| |_ / _ \ \/ / +| (_| | __/ |_ / \| _| (_) > < + \__, |\___|\__/_/\_\_| \___/_/\_\ + |___/ Tor Browser WaterFox + version 4.2.1 - 24/12/2017 + + ---------------------------------------------------------------------- + softs possibles: tor, wfx (Tor Browser, Waterfox) + + exemple, installation Tor Browser: getXfox i-tor + installation Waterfox: getXfox i-wfx + + getXfox i-soft : installation de (root) + + getXfox m-soft : installation de à partir d'une archive téléchargée manuellement (root) + getXfox r-soft : désinstallation (remove) de (root) + getXfox s-soft : soft comme défaut du système (update-alternatives) (root) + getXfox u-soft : ajouter un profil pour l'utilisateur en cours + + getXfox p-soft : personnalisation sur de user.js & userChrome.css + getXfox pr-soft : suppression des personnalisations (remove) sur + getXfox pu : mise à jour des personnalisations (update) installées + + getXfox version : versions installées et en ligne + ---------------------------------------------------------------------- + + ./getXfox (ou ./getXfox -i) : installation du script dans le système (root) + getXfox -h, --help : affichage aide + getXfox -r, --remove : désinstallation du script du système (root) + getXfox -u, --upgrade : mise à jour du script + getXfox -v, --version : versions du script + + plus d'infos: https://kyodev.frama.io/kyopages/scripts/getXfox/ +``` + + +## version + +```shell +getXfox version +``` +```text + _ __ __ __ + __ _ ___| |_\ \/ // _| _____ __ + / _' |/ _ \ __|\ /| |_ / _ \ \/ / +| (_| | __/ |_ / \| _| (_) > < + \__, |\___|\__/_/\_\_| \___/_/\_\ + |___/ Tor Browser WaterFox + version 4.2.1 - 24/12/2017 + + script en place: 4.2.1 + script en ligne: 4.2.1 + + Tor browser en place: 7.0.11 -- December 09 2017 + Tor browser en ligne: 7.0.11 + + perso. Tor browser en place: 0.2 + perso. Tor browser en ligne: 0.2 + + Waterfox en place: 56.0.1 + Waterfox en ligne: 56.0.1 + + perso. Waterfox en place: 0.6 + perso. Waterfox en ligne: 0.6 + +``` + + +## nouvel utilisateur ou reconfiguration profil + +```shell +getXfox u-wfx +``` + +* seul Waterfox permet cette option +* ajoute un profil pour l'utilisateur en cours +* évite de télécharger inutilement une nouvelle fois pour un nouvel utilisateur: +* ajout pour un autre utilisateur, titi pas exemple: `USER_INSTALL=titi getXfox u-wfx` + + +## personnalisation (installation) + +```shell +getXfox p-soft +``` + +* _user.js_ est ajouté dans le profil +* _userChrome.css_ est ajouté dans le profil, sous-répertoire _chrome/_ +* la version indiquée dans user.js fait référence, la version de userChrome.css est indicative +* les personnalisations sont périodiquement mise à jour, comme le script (7jours) +* l'url de base peut être changée aisément, les fichiers modifiés et hébergés ailleurs pour mise à jour + automatique (sur une plateforme git ou un gist par exemple) +* pour chaque programme concerné, la configuration se trouve trouve dans le fichier: + `/home//.waterfox/waterfox/personnalisation` ou + `/opt/usr/share/tor-browser/Browser/TorBrowser/Data/Browser/profile.default/personnalisation` + * l'url (première ligne) peut y être modifiée + * la version est indiquée en seconde ligne +* pour figer des fichiers de personnalisations et ne pas les mettre à jour, il suffit d'effacer les fichiers + `personnalisation` + +* contenu de [user.js](https://framagit.org/kyodev/kyopages/blob/master/scripts/user.js) +* contenu de [userChrome.css](https://framagit.org/kyodev/kyopages/blob/master/scripts/userChrome.css) + +pour Tor Browser + +* contenu de [user.js](https://framagit.org/kyodev/kyopages/blob/master/scripts/userTor.js) +* contenu de [userChrome.css](https://framagit.org/kyodev/kyopages/blob/master/scripts/userChromeTor.css) + + + +## personnalisation (upgrade) + +```shell +getXfox pu +``` + +* les personnalisations, si présentes, de Waterfox **et** Tor Browser sont mise à jour +* cette tâche est exécutée périodiquement par cron/anachron et n'a pas vraiment vocation à être lancée + manuellement + + +## personnalisation (suppression) + +```shell +getXfox pr-soft +``` + + + +## désinstallation d'un programme + +```shell +getXfox r-soft +``` + +* privilèges **root** requis +* le profil pour Waterfox **n'est pas supprimé**, il sera donc utilisable en cas de réinstallation +* le profil de Tor Browser est effacé, comme il est placé dans le répertoire du programme +* si les programmes sont ouverts, ils seront fermés +* update-alternatives, si supportée, sera supprimée +* les lanceurs desktop et console seront supprimés + + +## installation manuelle d'une archive + +```shell +getXfox m-soft archive.tar.xxx +``` + +* privilèges **root** requis +* installe une archive téléchargée manuellement + + +## profil Waterfox + +* les caractéristiques sont les mêmes que celles de Firefox +* opération à faire manuellement, mais sauf si l"écart de version était trop grand, une copie du profil Firefox + pourrait être placée dans le profil Waterfox +* emplacement profil: `/home//.waterfox/waterfox` + + + +## mise à jour script & personnalisation + +```shell +getXfox -u +``` + +* test toutes les **semaines** +* mise à jour du **script** si une nouvelle version est disponible en ligne. cela n'influe pas sur les + programmes installés. +* cette tâche est exécutée périodiquement par cron/anachron et n'a pas vraiment vocation à être lancée manuellement +* _anacron_ est utilisé, c'est à dire que la mise à jour sera testée, même après l'arrêt du Pc +* si une **personnalisation** est mise en place, une mise à jour possible sera elle aussi testée, pour tous les + programmes concernés + + +## logs + +tous les évènements importants sont consignées dans le fichier _/var/log/sdeb_getXfox.log_ +consulter son contenu: +```shell +pager /var/log/sdeb_getXfox.log +``` + + +## supprimer le script + +```shell +getXfox -r +``` + +* privilèges **root** requis +* effacement du script dans le système (_/opt/bin_) +* effacement de l'inscription dans crontab/anacron utilisateur +* cela ne **supprime pas** les éventuels programmes installés + + +## sources + +sur [framagit](https://framagit.org/kyodev/kyopages/blob/master/scripts/getXfox) + + +## changelog + +sur [framagit](https://framagit.org/kyodev/kyopages/blob/master/scripts/getXfox_changelog.md) + + +## contact + +pour tout problème ou suggestion concernant ce script, n'hésitez pas à ouvrir une issue +[Framagit](https://framagit.org/kyodev/kyopages/issues) + +IRC freenode: ##sdeb + + +## license + +[LPRAB/WTFPL](https://framagit.org/kyodev/kyopages/blob/master/scripts/LICENSE.md)