mirror of https://framagit.org/kyodev/kyopages.git
new getXfox
This commit is contained in:
parent
3800f40f0a
commit
66a0e24f46
|
@ -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 <soft> (root)
|
||||
|
||||
getXfox m-soft : installation de <soft> à partir d'une archive téléchargée manuellement (root)
|
||||
getXfox r-soft : désinstallation (remove) de <soft> (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 <soft> de user.js & userChrome.css
|
||||
getXfox pr-soft : suppression des personnalisations (remove) sur <soft>
|
||||
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/<user>/.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/<user>/.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)
|
Loading…
Reference in New Issue