Ceci est une page d'instantané bilingue enregistrée par l'utilisateur à 2024-11-26 24:53 pour https://www.tampermonkey.net/faq.php?locale=en#Q500, fournie avec le support bilingue par Traduction Immersive. Apprendre comment sauvegarder ?
Tampermonkey® par Jan Biniok by Jan Biniok

Table des Matières Table of Contents

GÉNÉRAL GENERAL

Q100: Comment installer et désinstaller Tampermonkey?
Q100: How do I install and uninstall Tampermonkey?
Q101: Comment puis-je travailler avec Tampermonkey?
Q101: How do I work with Tampermonkey?
Q102: Comment installer de nouveaux scripts pour Tampermonkey?
Q102: How to install new scripts to Tampermonkey?
Q103: Est-il possible de remplacer ou étendre un scripts comprend et/ou exclut? Comment est-ce de travailler?
Q103: Is it possible to overwrite or extend a scripts includes and/or excludes? How is this working?
Q105: Comment puis-je synchroniser tous les scripts installés à Tampermonkey pour un autre navigateur?
Q105: How can I sync all scripts installed at Tampermonkey to another browser?
Q106: Comment puis-je exporter et importer mes scripts?
Q106: How can I export and import my scripts?

EXTENSION CHROME CHROME EXTENSION

Q200: Est-il possible d'installer des scripts en tant que natif extension Chrome même si Tampermonkey est installé?
Q200: Is it possible to install scripts as native Chrome extension even though Tampermonkey is installed?
Q203: extension Tampermonkey affiche un avertissement. Pourquoi?
Q203: Tampermonkey extension shows a warning. Why?
Q204: Comment puis-je permettre Tampermonkey l'accès aux fichiers locaux Uri?
Q204: How can I allow Tampermonkey access to local file URIs?
Q205: Où est l'extension de données est-elle située?
Q205: Where is the extension data located?
Q206: Tampermonkey me dit que mon profil google Chrome est cassé. Qu'est-ce que cela signifie?
Q206: Tampermonkey tells me that my Chrome profile is broken. What does that mean?
Q207: Mes scripts sont partis et Tampermonkey gémissements que Chrome essuyé l'extension de la base de données. Ce qui se passe ici?
Q207: My scripts are gone and Tampermonkey moans that Chrome wiped the extension database. What's going on here?
Q208: Mes scripts ne seront exécutées qu'après plusieurs recharges, la console affiche "pagejs manquant".
Q208: My scripts are only executed after several reloads, the console prints "pagejs missing".
Q209: le mode Développeur pour exécuter userscripts
Q209: Developer mode to run userscripts

SÉCURITÉ SECURITY

Q300: Tampermonkey peut accéder à chaque page que je visite! Est Tampermonkey mal?
Q300: Tampermonkey can access every page that I visit! Is Tampermonkey evil?
Q301: Chrome, dit "Danger: les logiciels Malveillants à l'Avance!". Est Tampermonkey infecté par des logiciels Malveillants?
Q301: Chrome says "Danger: Malware Ahead!". Is Tampermonkey infected with Malware?
Q302 : Comment puis-je configurer les téléchargements déclenchés par userscript ?Q303 : Tampermonkey dit qu’un de mes scripts est sur liste noire. Pourquoi?Q304 : Quelles sont les autorisations nécessaires pour exécuter Tampermonkey et pourquoi ?Q305 : Je n’arrive pas à désinstaller Tampermonkey sur Chrome. Que dois-je faire ?

AVANCÉ

Q400 : Comment afficher et modifier les valeurs stockées par un userscriptQ401 : Tampermonkey ralentit mon ordinateur. Que puis-je faire ?Q402 : Je souhaite utiliser un éditeur externe pour modifier mes scripts. Comment cela peut-il être fait ?Q403 : Comment puis-je activer la fonctionnalité Javascript expérimentale ?Q404 : Quelle valeur dois-je utiliser ?Q405 : Tampermonkey semble s’exécuter sur toutes les pages au lieu de seulement celles où les scripts sont censés s’exécuter. Pourquoi?Q406 : les Versions officielles de Tampermonkey
Q406 : Versions officielles de Tampermonkey
Q407 : Comment installer Tampermonkey à partir d’un paquetQ408 : Comment continuer à exécuter une version Manifest V2 de Tampermonkey

SOUTENIR LE DÉVELOPPEMENT

Q500 : XYZ est ma langue maternelle. Comment puis-je traduire Tampermonkey en XYZ ?Q501 : Ma langue maternelle est déjà supportée et je n’ai aucune idée de comment écrire des javascripts. Comment puis-je vous accompagner ?

DÉBOGAGE

Q600 : Où peut-on trouver la sortie console de Tampermonkey ?

Généralités

Q100 : Comment installer et désinstaller Tampermonkey ?

A100 Les deux sont assez faciles :
A100 Les deux sont assez faciles :

  • Pour installer Tampermonkey, jetez un coup d’œil à cette vidéo :

  • Si vous souhaitez désinstaller Tampermonkey, veuillez consulter cette vidéo :

Q101 : Comment puis-je travailler avec Tampermonkey ?

A101 Tampermonkey est une extension de navigateur. Une extension de navigateur est un petit logiciel qui étend les fonctionnalités d’un navigateur Web.
Ces extensions sont conçues pour ajouter des caractéristiques ou des fonctionnalités spécifiques au navigateur, telles que le blocage des publicités, la gestion des mots de passe ou, dans ce cas, l’injection de userscript.

  1. Une caractéristique commune des extensions de navigateur est la possibilité d’ajouter une icône à côté de l’URL dans la barre d’adresse du navigateur (Icône Tampermonkey). Dans certains navigateurs, vous devez épingler manuellement l’icône pour la voir tout le temps. En cliquant sur l’icône, vous ouvrez un menu contextuel, qui fournit des informations sur les scripts en cours d’exécution et un lien pour ouvrir les paramètres de l’extension.

  2. La page d’arrière-plan est une autre partie importante d’une extension de navigateur. Il s’agit d’une page Web cachée qui s’exécute en arrière-plan du navigateur, permettant à l’extension d’effectuer des tâches ou des fonctions sans avoir besoin d’interaction avec l’utilisateur.
    Cela inclut des éléments tels que la vérification des mises à jour, la synchronisation des données ou le traitement des informations.

  3. Enfin, la page des options permet de configurer Tampermonkey et de gérer vos userscripts. Le premier onglet affiche tous les scripts installés. Cliquez sur le nom du script pour modifier et configurer vos scripts. ( tutoriel vidéo)

Il y a un deuxième onglet qui vous permet de modifier les paramètres de Tampermonkey. Astuce : ajustez les options « Mode Config » pour voir plus de paramètres. ( tutoriel vidéo)

Le troisième onglet offre des fonctionnalités d’importation et d’exportation de scripts vers des fichiers Zip et des documents JSON.

Q102 : Comment installer de nouveaux scripts sur Tampermonkey ?

A102 Il existe différentes façons d’y parvenir :

  • Rendez-vous sur cette page pour en savoir plus sur les différentes sources de script. Si vous avez trouvé une page, recherchez un script, ouvrez la page du script et cliquez sur le bouton d’installation. ( tutoriel vidéo)

  • Recherchez des scripts utilisateur dans GitHub Gist et Github. Cliquez ensuite dessus sur le lien « view raw ». ( tutoriel vidéo)

  • Vous pouvez également rechercher des scripts dans votre moteur de recherche préféré. Recherchez ensuite un lien qui se retrouve sur « .user.js » et cliquez dessus

  • Si vous avez l’URL d’un script, collez-le simplement dans l’Omnibox de Chrome.

  • Dans le tableau de bord de Tampermonkey, cliquez sur le bouton « Ajouter un nouveau script ». Cela ouvrira une nouvelle fenêtre d’éditeur où vous pourrez écrire ou coller votre userscript. Entrez le code de votre script utilisateur dans la fenêtre de l’éditeur.
    Assurez-vous d’inclure les bonnes métadonnées en haut du script, car elles sont nécessaires pour que Tampermonkey les reconnaisse. Les métadonnées doivent inclure les champs , et qui spécifient le nom du script et le modèle d’URL sur lequel il doit s’exécuter.
    @name@match@description

    Une fois que vous avez entré votre code userscript, cliquez sur le bouton « Enregistrer » pour l’enregistrer. Votre script utilisateur apparaîtra maintenant dans la liste des scripts installés dans le tableau de bord de Tampermonkey. ( tutoriel vidéo)

  • Aller pour les Chromes des extensions de page, activez la "Permettre l'accès à l'Url de fichier" case à cocher à la Tampermonkey élément, créer un fichier avec les extensions de fichier ".user.js" et le glisser-déposer pour Chrome.
    Go to Chromes extensions page, enable the "Allow access to file URLs" checkbox at the Tampermonkey item, create a file with the file extensions ".user.js" and drag-and-drop it to Chrome.

Q103: Est-il possible de remplacer ou étendre un scripts comprend et/ou exclut? Comment est-ce de travailler?
Q103: Is it possible to overwrite or extend a scripts includes and/or excludes? How is this working?

A103 Sûr, il suffit d'aller dans les options de la page et cliquez sur le nom du script que vous souhaitez modifier. Un nouvel onglet s'ouvre et affiche le script du code source.
A103 Sure, just go to the options page and click at the script's name you want to modify. A new tab is opened that shows the script's source code.

includes editor

Cliquez sur le "paramètres" onglet (1) pour obtenir le *cludes éditeur illustré dans l'image ci-dessus.
Click at the "settings" tab (1) to get the *cludes editor shown at the image above.

Maintenant, vous pouvez sélectionner soit une entrée à partir de l' Original"comprend" la section (2) et de les ajouter à exclure en cliquant sur "Ajouter Utilisateur exclut"(3). L'entrée s'affiche maintenant à l' utilisateur"exclut" de la section (5) et le script ne fonctionnera pas sur cette page plus.
Now you can select i.e. a entry from the "Original includes" section (2) and add them as exclude by clicking at "Add as User excludes" (3). The entry now appears at the "user excludes" section (5) and the script will not run at this page anymore.

Si vous souhaitez faire un script de s'exécuter à une page à l'origine, il ne devrait pas vous devez utiliser le "Original exclut" de la section (4). Sélectionnez à nouveau une entrée, cliquez sur le bouton ci-dessous l'article et l'entrée apparaîtra à l'Utilisateur "comprend".
If you want to make a script run at a page it originally shouldn't you have to use the "Original excludes" section (4). Again select a entry, click a the button bellow the section and the entry will appear at "User includes".

Vous pouvez également ajouter, modifier ou supprimer des entrées qui sont ajoutés manuellement en utilisant les boutons (6) ci-dessous selon la section de l'Utilisateur ("Utilisateur", "Utilisateur correspond à l'" et "Utilisateur exclut").
You can also add, edit or remove entries that are manually added by using the buttons (6) below the according User section ("User includes", "User matches" and "User excludes").

Si vous souhaitez remplacer l'original comprend complètement, il suffit de décocher la case (7) en face de l'en-tête. Par exemple, vous devez décocher "Original comprend" si vous souhaitez désactiver la directive .htt*://*facebook.com/*
If you want to override the orginal includes completely just uncheck the checkbox (7) in front of the according heading. For example you have to uncheck "Original includes" if you want to disable the directive .htt*://*facebook.com/*

Q105: Comment puis-je synchroniser tous les scripts installés à Tampermonkey pour un autre navigateur?
Q105: How can I sync all scripts installed at Tampermonkey to another browser?

A105 Il est très facile de synchroniser vos scripts. Veuillez suivre cette procédure pour activer la fonction de synchronisation:
A105 It is very easy to sync your scripts. Please follow this procedure to enable the sync feature:

  1. Aller à Tampermonkey du tableau de bord et sélectionnez "Paramètres", onglet
    Go to Tampermonkey's Dashboard and select the "Settings" tab
  2. maintenant régler le "Mode Config" soit de "Débutant" ou "Avancé"
    now set the "Config Mode" to either "Beginner" or "Advanced"
  3. recherche pour le Script"Sync" de la section et
    search for the "Script Sync" section and
  4. Choisissez votre favori du service de synchronisation (voir ci-dessous)
    Choose your favorite sync service (see below)
  5. Enfin, vous devez "Activer le Script de Synchronisation" et appuyez sur "Save" bouton
    Finally you need to "Enable Script Sync" and press the "Save" button

Tampermonkey prend en charge les services de synchronisation:
Tampermonkey supports the following sync services:

  • Google Drive Vous avez besoin d'un Compte Google pour utiliser ce service. Une fois activé Google demande si Tampermonkey est autorisé à stocker des données à un dossier spécial qui contient seulement les données de l'application.
    Google Drive You need a Google Account in order to use this service. Once enabled Google asks whether Tampermonkey is allowed to store data at a special folder which solely contains app data.
  • Dropbox d'Un compte Dropbox est nécessaire pour cela. Une fois activé Dropbox demande si Tampermonkey est autorisé à stocker des données sur votre Dropbox. Remarque: si ce service est activé Tampermonkey ne sera pas exécuter des scripts à plusieurs Dropbox liées à des URLs plus!
    Dropbox A Dropbox account is needed for this. Once enabled Dropbox asks whether Tampermonkey is allowed to store data to your Dropbox. Note: if this service is enabled Tampermonkey will not run scripts at several Dropbox related URLs anymore!
  • WebDAV , Vous pouvez utiliser n'importe quel serveur WebDAV, mais vous pouvez avoir besoin de saisir de passe pour y accéder. Jetez aussi un œil à TamperDAV. Il contient quelques fonctions exclusives qui accélèrent le processus et permet l'édition du scénario avec votre propre éditeur externe. Remarque: Tampermonkey ne sera pas exécuter des scripts sur le serveur de l'Url plus!
    WebDAV You can use any WebDAV server, but you may need to enter credentials to access it. Please also have a look at TamperDAV. It contains some proprietary features which speed up the process and allows script editing with your own external editor. Note: Tampermonkey will not run scripts at the server's URLs anymore!
  • C'est pourquoi Tampermonkey besoin d'un @downloadURLhttphttps
    La Synchronisation de navigateur S'il est disponible pour votre navigateur, puis il utilise votre navigateur interne du service de transfert de l'information entre tous les Tampermonkey instances. Veuillez noter que vous devez être connecté à votre navigateur et que la quantité de données qui peuvent être synchronisés est très limitée.
    Browser Sync If it's available for your browser, then it uses your browser's internal service to transfer information between all Tampermonkey instances. Please note that you have to be signed in to your browser and that the amount of data that can be synced is very limited.
    That's why Tampermonkey needs a publicly accessible URL to sync your scripts. To be clear on that: only scripts that are downloaded from a web server or that contain a valid tag are processed. For that purpose both, the and protocol can be used.
    @downloadURLhttphttps

Q106: Comment puis-je exporter et importer mes scripts?
Q106: How can I export and import my scripts?

A106 Importation et l'exportation de scripts est assez simple. Il suffit d'aller à TM tableau de bord/Options de la page. Si vous voyez un "Utilitaires" puis allez-y, sinon réglez le "Mode Config" pour "Débutants" ou "Avancé" pour les voir.
A106 Import and export of scripts is pretty simple. Just go to TM's Dashboard/Options page. If you see a 'Utilities' tab then go there, otherwise set the 'Config Mode' to either 'Beginner' or 'Advanced' in order to see it.
Dans cet onglet, il y a différentes sections en fonction de votre Tampermonkey version et la prise en charge du navigateur:
At this tab there are different sections depending on your Tampermonkey version and browser support:

  • Cloud: Vous pouvez importer et exporter des fichiers zip via un service de cloud. Veuillez vérifier Q105 pour le service de cloud de la liste.
    Cloud: You can import and export zip files via cloud service. Please check Q105 for the cloud service list.
  • Zip: Vous pouvez importer et exporter des fichiers zip à partir de et vers votre disque dur. Veuillez cliquez sur "Exporter" pour enregistrer un fichier zip ou "Choisir un Fichier" pour sélectionner une archive pour l'importation.
    Zip: You can import and export zip files from and to your harddisk. Please click 'Export' to save a zip file or 'Choose File' to select an archive for import.
  • Fichier: Vous pouvez importer et exporter JSON texte des fichiers depuis et vers votre disque dur. Veuillez cliquez sur "Exporter" pour enregistrer un fichier ou "Choisir un Fichier" pour sélectionner un fichier à importer.
    File: You can import and export JSON text files from and to your harddisk. Please click 'Export' to save such a file or 'Choose File' to select a file for import.
  • Textarea: Vous pouvez importer et exporter des fichiers zip de et à une zone de texte de l'élément d'entrée. Veuillez cliquez sur "Exporter" pour remplir la zone de texte et copier sa valeur ou "Importer" après avoir collé un document JSON.
    Textarea: You can import and export zip files from and to a text area input element. Please click 'Export' to fill the textarea and copy its value or 'Import' after you've pasted a JSON document.
  • URL: En cas Tampermonkey est incapable de détecter (en raison d'un défaut de l'URL du script de détection ou parce qu'il est désactivé) un script, vous pouvez forcer Tampermonkey pour importer à partir de cette URL ici.
    URL: In case Tampermonkey is unable to detect (due to a failing script URL detection or because it's disabled) a userscript, then you can force Tampermonkey to import it from this URL here.

Extension Chrome Chrome Extension

Q200: Est-il possible d'installer des scripts en tant que natif extension Chrome même si Tampermonkey est installé?
Q200: Is it possible to install scripts as native Chrome extension even though Tampermonkey is installed?

  A200 Yes it is. If you want to install a script just click at the install link. Tampermonkey now asks you whether to install the script in Tampermonkey or native in Chrome.

install dialog;

  Q203: Tampermonkey extension shows a warning. Why?

  A203 Tampermonkey checks whether HTTP headers like "user-agent" or "referer" can be modified by userscripts. If now another extension like a user agent spoofer or an script blocker like ScriptNo modifies this request too the warning is displayed. This should not occur that often when the option "Allow HTTP headers to be modified by scripts" is set to "Yes" (Default) or even never if it is set to "No".

failed to modify

  Q204: How can I allow Tampermonkey access to local file URIs?

  A204 File access for Tampermonkey is only available at Chrome and derivates. In order to enable it open Google Chrome and click on the "More" icon (the three dots) in the top-right corner of the window. From the menu, select "More tools" and then click on "Extensions".

  This will open the browser extensions page ( or ), which shows a list of all the extensions that are installed in your browser. Find Tampermonkey and click on the "Details" link to the right of its name.chrome://settings/edge://extensions

  On the extension's details page, scroll down to the "Permissions" section. Here, you will see a list of all the permissions that the extension has been granted. To enable file access, you will need to check the box next to the "Allow access to file URLs" permission. ( video tutorial)

  Q205: Where is the extension data located?

  A205 The location where a Google Chrome extension's data is stored varies depending on the operating system. On Windows, the data is stored in the following location:

C:\Users\[USERNAME]\AppData\Local\Google\Chrome\User Data\Default\Extensions\[EXTENSION_ID]

  Replace with the name of the user who is logged in to the computer, and with the unique ID of the extension. This ID can be found in the extension's details page in Chrome, under the "ID" section.[USERNAME][EXTENSION_ID]

  On Linux, the data is stored in the following location:

/home/[USERNAME]/.config/google-chrome/Default/Extensions/[EXTENSION_ID]

  Again, replace with the name of the user who is logged in, and with the extension's ID.[USERNAME][EXTENSION_ID]

  On MacOS, the data is stored in the following location:

/Users/[USERNAME]/Library/Application Support/Google/Chrome/Default/Extensions/[EXTENSION_ID]

  Here, should be replaced with the current user's name, and should be replaced with the extension's ID.[USERNAME][EXTENSION_ID]

  Please note that the exact location of the data may vary depending on the specific version of the operating system and the Chrome browser that you are using. For example or might also be , or another string depending on you browser. If you are unable to find the data at the above locations, you may need to search for the Extensions folder manually on your system.google-chromeGoogle\ChromechromiumOpera Next

  You can learn more about the concrete extension's ID here.

  Q206: Tampermonkey tells me that my Chrome profile is broken. What does that mean?

  A206 If your Chrome browser profile has a corrupted extension storage, you can try the following steps to repair it:

  •   First, back up your browser profile folder. Q205 explains how to access it.
  •   Then open Google Chrome and click on the "More" icon (the three dots) in the top-right corner of the window. From the menu, select "More tools" and then click on "Extensions".
  •   On the Extensions page, click on the "Remove" button next to the name of each extension that you want to remove. This will remove the extension and its data from your browser.
  •   Once you have removed all the extensions that you want to delete, close the Chrome browser and restart your computer.
  •   After restarting your computer, open the Chrome browser again and go to the Extensions page. Re-install any extensions that you removed in step 2.
  •   If the problem persists, you can try creating a new Chrome profile. To do this, click on the "More" icon in the top-right corner of the window and select "Settings". On the Settings page, scroll down to the bottom and click on "Advanced".
  •   In the "Advanced" section, click on the "People" section and then click on "Add person". Follow the prompts to create a new user profile in Chrome.
  •   Once the new profile has been created, you can install your extensions and try using them again. This should fix any problems with corrupted extension storage in your original profile.

  Q207: My scripts are gone and Tampermonkey moans that Chrome wiped the extension database. What's going on here?

  A207 In order to solve the issue described above at Q206 Chrome now tries to automatically correct any corruption by removing corrupted parts. Depending on the severity of the corruption it might restore some data, otherwise the database is just empty. Since this can also affect Tampermonkey's data it tries to detect this process and notify you of the possible loss of all or some settings and scripts.

  Q208: My scripts are only executed after several reloads, the console prints "pagejs missing".

  A208 This is caused by a bug in Chromium that causes Tampermonkey's content scripts to run in the wrong order. Unfortunately the order matters and due to timing constraints it is not possible to wait longer for the other content script than already done. This bug "only" happens when the extension is updated from a previous stable version lower than 4.18. To fix the issue simply:

  •   Disable Tampermonkey extension
  •   Restart browser (make sure that all browser processes are gone, better restart the computer)
  •   Enable Tampermonkey extension
  •   Restart browser

  Disabling the extension seems to cleanup things and the content scripts are executed in the right order again.

  If it still doesn't work, then please

  •   export your settings and scripts (you can try importing them into the BETA version first to be on the safe side) and
  •   re-install Tampermonkey and
  •   import the backup again.

  Q209: Developer mode to run userscripts

  A209 For users of the Tampermonkey extension in a Chrome-based browser, enabling Developer Mode is a requirement introduced with Manifest V3 updates.

  Why Enable Developer Mode?

  Developer Mode is necessary due to the two-step user authorization for userscripts: the permission and the Developer Mode option. The permission, on its own, does not trigger a user warning upon installation. So this additional step likely reflects Google's intention to ensure that users are making an informed decision to run extensions that use Userscripts.userScriptsuserScripts

  Steps to Enable Developer Mode

  To enable Developer Mode in Chrome and derivates:

  •   In Desktop Browsers:

    • Open the menu, select "Extensions" and "Manage extensions", or type or in a new browser tab to navigate to the extensions page. chrome://extensionsedge://extensions 

      chrome://extensions  Click the image to view it in full size

    •   Find and click the "Developer Mode" toggle at the top right to enable it.

      developer mode  Click at the image to view full size

  •   In Microsoft Edge Android

    •   Follow these steps

      Enable developer mode sequence  Click the image to view it in full size

  This action enables the use of the API through Tampermonkey.userScripts

  Security

  Q300: Tampermonkey can access every page that I visit! Is Tampermonkey evil?

  A300 ...like any other chrome extension that has https and http access! 
This includes extensions like AdBlock, ScriptSafe, Avast Online Security and due to the fact that it is not displayed explicitly when they are downloaded, any userscript that is installed as native Chrome extension.

  If you're interested in this, you can find the access information a the right column of every extension at the Chrome store by searching for "This extension can access". 
Tampermonkey needs to be able to run at every page, because it doesn't know at what pages your userscripts will run and therefore needs to be able to inject them into every page.

  But you're right, userscripts and extensions can harm your privacy and your computer. Nevertheless I think more evil is that Chrome does not display at what pages a userscript wants to run on when install it is installed as native extension. 
From this point of view Tampermonkey even can bring you some security back, at least if you believe me, that I'm not interested in any of your data. If not, you can open the console (Ctrl-Shift-J) and choose the network tab to investigate what network communication is done. :)

  Q301: Chrome says "Danger: Malware Ahead!". Is Tampermonkey infected with Malware?

  A301 No, Tampermonkey is not infected. Chrome shows this message because the options page tries to load a favicon from a page that Google suspects to be evil. So this just means that you have script installed that has such an malicious page in its s and Tampermonkey loads the favicons from there to give you an overview where your scripts will run.@include

Danger  Click at the image to view full size

  In order to fix this issue please configure another "Favicon Service" like "Google" or "DuckDuckGo";

  Q302: How do I setup userscript-triggered downloads?

  A302 First, please notice that downloading files to your harddisk may be security relevant! Malware might have an easy job once it is downloaded. So please make sure that you only allow the download of non-executable files.

  There are a few steps necessary to enable the download feature: ( video tutorial)

  •   Go to the options page
  •   Scroll down to the "Downloads" section
  •   Double-check the "Whitelisted File Extensions" setting to not contain file extensions of executable files
  •   Select "Browser API" at the "Download Mode" option
  •   A notification may come up, you need to click at it and to click "confirm" at the permission grant dialog

  Note: Even though GM_download is a powerful function, it's finally more or less just convenience for the userscript autors.

  Q303: Tampermonkey says one of my scripts is blacklisted. Why?

  A303 This happens cause you either added the source URL to the "Manual Userscript and @require Blacklist" or it was added to the list maintained by me. You can find the list including the reason for blackisting at the GitHub repo.

  If you still want the script to run then you can either increase the "Severity Level" or disable the remote list this way:

  •   Go to the options page
  •   Make sure "Config Mode" is set to Beginner or higher
  •   Scroll down to the "BlackCheck" section
  •   Modify the "Blacklist Source" or "Severity Level"

  Note: If you're a script author and think I made a mistake, then just send me an email or open an issue at GitHub.

  Q304: What permissions are necessary to run Tampermonkey and why?

  A304 Tampermonkey requires the following permissions. Some of them might be optional at some browsers and need to be granted only when used.

  •   "notifications" for , Tampermonkey related notificationsGM_notification
  •   "tabs" to find the active tab and navigate, create and close tabs in general
  •   "idle" to not show update notifications if your playing a game
  •   "webNavigation" install userscripts, check URLs for matching scripts
  •   "webRequest webRequestBlocking" install userscripts, check URLs for matching scripts, modify request details for GM_xmlhttpRequest
  •   "storage" to store your userscripts
  •   "unlimitedStorage" to store many of your userscripts 🤓
  •   "contextMenus" for context-menu@run-at
  •   "chrome://favicon/" to easily get the favicons of pages
  •   "clipboardWrite" for GM_setClipboard
  •   "cookies" , GM_xmlhttpRequestGM_cookies
  •   "<all_urls>" to run your userscripts at every page and to allow them to modify the page
  •   "downloads" , storing Tampermonkey backupsGM_downloads

  In Chrome these permissions translate to:

  •   Read your browsing history
  •   Display notifications
  •   Modify data you copy and paste

  Especially the first one looks a little bit strange. In fact it's not possible for Tampermonkey to get access to your browser history when it is installed. In theory Tampermonkey could access the history of all currently open tabs and store "new" history once installed, but this is neither needed nor done. However, because of this fact the Chrome team maybe thought that printing a too broad warning is better than a too flat one. There also is a bug report for this.

  In Firefox this translates to

  •   Access your data for all websites
  •   Input data to the clipboard
  •   Download files and read and modify the browser’s download history
  •   Display notifications to you
  •   Access browser tabs
  •   Store unlimited amount of client-side data
  •   Access browser activity during navigation

  Q305: I can't uninstall Tampermonkey on Chrome. What should I do?

  A305 Chrome has a "feature" that allows third-party software (that has nothing to do with Tampermonkey) to install extensions in the Chrome browser. There are legitimate use cases such as a desktop software that needs an extension to be installed, but malware can also make use of this.

  Therefore, please check the settings file and/or the Windows registry keys and remove any unwanted entries.

  If Tampermonkey appears again, the problematic software is still on your PC!

  Windows users, please open the registry editor and check these two registry keys:

  32-Bit Windows HKEY_LOCAL_MACHINE\Software\Google\Chrome\Extensions
  64-Bit Windows HKEY_LOCAL_MACHINE\Software\Wow6432Node\Google\Chrome\Extensions

  The ID of Tampermonkey is , further official IDs can be found here.dhdgffkkebhmkfjojejmpbldmpobfkfo

  Important: You should check your system for malware and viruses.

  Advanced

  Q400: How to I view and edit values stored by a userscript

  A400 Open Tampermonkey's Dashboard and click at the script's name. Click at the "Storage" if present and check or modify the stored data as needed. If there is no "Storage" tab, then the script has no data stored (yet).

  Q401: Tampermonkey slows down my computer. What can I do?

  A401 This is a known issue caused by the iframe support of Tampermonkey (and by the way Greasemonkey too ;)). In order to avoid Tampermonkey to check and most probably run scripts at unwished iframes you can do a lot of different things:

  •   Avoid No global includes Try not to use scripts that all pages ( and ) cause these scripts will run at every tab, every frame and every advertisement. Note: Tampermonkey outlines such scripts by this icon <i class= *"fa fa-globe fa-lg"* aria-hidden="true"> at their sites column.@includehttp://*https://*

  •   Make Tampermonkey not run at social buttons Open TM's options page, make sure the "Config mode" is at least set to "Beginner", go to "Settings" and extend the "Blacklisted Pages" text area like this

    *://apis.google.com/_/+1/*button*
    *://www.facebook.com/plugins/*
    *://platform.twitter.com/widgets/*
    
  •   Exclude advertisements You can try your own excludes based on this:

    *://*.doubleclick.*/*
    *://*advertising*
    *://*banner*
    

  Q402: I want to use an external editor to edit my scripts. How can this be done?

  A402 There are multiple possible ways:

  • Chrome (and derivates users) can export and the local copy@require 
    •   Open Tampermonkey's dashboard, open the script and copy its content.
    •   Create a local file and paste the content
    •   Remove all content from the script inside Tampermonkey except the "UserScript" header
    • Add a tag with the path to the local file that you want to include in the script. For example, if the file is located at , you would add the following line to the script:@requireC:\Users\[USERNAME]\Documents\myscript.js 
      // @require       file://C:/Users/[USERNAME]/Documents/myscript.js
      
    •   Finally enable local file access.
  •   You can try TamperDAV
  •   You can try the Tampermonkey Editors extension to edit the script at vscode.dev

  Q403: How do I enable the experimental Javascript feature?

  A403

  This is pretty simple. Just go to chrome://flags.

unsafeWindow_flags

  Now a page with all experimental Chrome featues is shown - search for 'Javascript'.

unsafeWindow_experimental

  Click 'Enable' and 'Relaunch now' at the bottom of the page.

unsafeWindow_relaunch

  Q404: What value should I use?@sandbox

  A404 supports the following values: "raw", "JavaScript" and "DOM"@sandbox

  •   "raw" access means that a script for compatibility reasons always needs to run in page context. At the moment this mode is the default if is omitted.@sandbox
  •   "JavaScript" access mode means that this script needs unsafeWindow access. At Firefox a special context is created which should also bypass all remaining CSP issues. Execution in page context is used as fallback at other browsers.
  •   "DOM" access mode means that the script only needs DOM and no direct unsafeWindow access. If enabled these scripts are executed inside the extension context or at any other enabled context otherwise.

  There is also an option to configure the available sandbox modes which can be used by userscripts. Attention: any option that enables "DOM" mode is potentially unsecure. Userscripts that run in extension context have almost full extension permissions and can even modify and install new userscripts.

  Q405: Tampermonkey seems to run at every page instead of only those where scripts are supposed to run. Why?

  A405 Unfortunately Chrome does not allow code injection into frames at the right time. That's why Tampermonkey needs to be injected into every page, because only pre-defined content scripts will be executed at for sure. After the injection, it asks the main application whether to run a script at this URL, and if not, it unloads itself to free all resources. You can help to improve this and tell the Chrome developers how important this feature is for you by starring this and this issue at Chrome's bug tracker.document-start

  Just login with you Google Account and click at the star in front of the issue heading. Thanks.

  Q406: Official Tampermonkey versions

  A406 Tampermonkey supports several browsers and therefore there are different versions of Tampermonkey. The following versions exist:

  Name   ID   Browsers   Sources   Notes
  Tampermonkey   dhdgffkkebhmkfjojejmpbldmpobfkfo   Google Chrome  
Opera  
Microsoft Edge
  Chrome Web Store
  crx
  MV3
  Tampermonkey BETA   gcalenpjmijncebpfijmoaglllgpjagf   Google Chrome  
Opera  
Microsoft Edge
  Chrome Web Store
  crx
  MV3
  Tampermonkey   iikmkjmpaadaobahmlepeloendndfphd Microsoft Edge  
  Microsoft Edge
  Microsoft Edge Add-ons   MV2
  Tampermonkey BETA   fcmfnpggmnlmfebfghbfnillijihnkoh Microsoft Edge  
  Edge Canary
  Microsoft Edge Add-ons   MV3
  Tampermonkey firefox@tampermonkey.net Firefox  
  Firefox Android
  Firefox Add-ons   MV2
  Tampermonkey BETA firefoxbeta@tampermonkey.net Firefox  
  Firefox Android
  xpi   MV2
  Tampermonkey   mfdhdgbonjidekjkjmjaneanmdmpmidf   Opera   Opera Add-ons   MV2
  Tampermonkey Legacy   lcmhijbkigalmkeommnijlpobloojgfn Google Chrome  
Opera  
Microsoft Edge  
  Kiwi
  Chrome Web Store
  crx
  MV2
  Tampermonkey Legacy   bnimknkampfeeemccidiigealnpoheap**   Google Chrome  
Opera  
Microsoft Edge
  crx   MV2
  Tampermonkey   net.tampermonkey.SafariWebExt   Safari  
Safari iOS
  App Store
  Tampermonkey   net.tampermonkey.SafariApp   Safari   Mac App Store

  Note: downloaded files need manual installation

  Mobile users can simply:

   
  Scan this QR code to get Tampermonkey for iOS...
   
  or scan this QR code to install Microsoft Edge including Tampermonkey on their Android devices...
   
  ... or scan this QR code to install Firefox Android and scan it again to install Tampermonkey.

  Q407: How to install Tampermonkey from a package

  A407 There a different packages available for Tampermonkey. Please check Q406 for more information on where to get them.

Chrome

  • Télécharger le fichier CRX (par exemple à partir des liens montré ici)
    Download the CRX file (e.g. from the links shown here)
  • Ouvrez la page "extensions" (chrome://extensions) dans votre navigateur.
    Open the extensions page (chrome://extensions) in your browser.
  • Activer le "mode Développeur" interrupteur en haut à droite.
    Enable the "Developer mode" switch at the top right.
  • Faites glisser et déposez le fichier téléchargé fichier CRX dans la page "extensions".
    Drag and drop the downloaded CRX file into the extensions page.

Microsoft Bord Microsoft Edge

  • Télécharger le fichier CRX (par exemple à partir des liens montré ici)
    Download the CRX file (e.g. from the links shown here)
  • Ouvrez la page "extensions" (edge://extensions) dans votre navigateur.
    Open the extensions page (edge://extensions) in your browser.
  • Activer le "mode Développeur" basculer dans le côté gauche de la page.
    Enable the "Developer mode" switch in the left side of the page.
  • Faites glisser et déposez le fichier téléchargé fichier CRX dans la page "extensions".
    Drag and drop the downloaded CRX file into the extensions page.

Opéra Opera

  • Télécharger le fichier CRX (par exemple à partir des liens montré ici)
    Download the CRX file (e.g. from the links shown here)
  • Ouvrez la page "extensions" (opéra://extensions) dans votre navigateur.
    Open the extensions page (opera://extensions) in your browser.
  • Activer le "mode Développeur" interrupteur en haut à droite.
    Enable the "Developer mode" switch at the top right.
  • Faites glisser et déposez le fichier téléchargé fichier CRX dans la page "extensions".
    Drag and drop the downloaded CRX file into the extensions page.
  • Trouver le dans la liste et cliquez sur le bouton "Installer" et suivez les instructions d'installation.
    Find the extension in the list and click on the "Install" button and follow the installation instructions.

Firefox

  • Télécharger le fichier XPI (par exemple à partir des liens montré ici)
    Download the XPI file (e.g. from the links shown here)
  • Ouvrir les add-ons de la page dans votre navigateur.
    Open the add-ons page in your browser.
  • Faites glisser et déposez le fichier XPI téléchargé dans les add-ons de la page.
    Drag and drop the downloaded XPI file into the add-ons page.
  • L'accent Firefox si ce n'est déjà concentré et suivez les instructions d'installation.
    Focus Firefox if it is not already focused and follow the installation instructions.

Q408: Comment continuer à exécuter le Manifeste de la version V2 de Tampermonkey
Q408: How to continue running a Manifest V2 version of Tampermonkey

A408 Il y a plusieurs raisons pour lesquelles vous pourriez vouloir continuer à exécuter le Manifeste de la version V2 de Tampermonkey. Par exemple, vous pourriez avoir un script qui n'est pas compatible avec la dernière version de Tampermonkey ou votre navigateur ne prend pas en charge la version la plus récente de Tampermonkey.
A408 There a many reasons why you might want to continue running a Manifest V2 version of Tampermonkey. For example, you might have a userscript that is not compatible with the newest version of Tampermonkey or your browser might not support the newest version of Tampermonkey.
Voici les étapes pour continuer à exécuter le Manifeste de la version V2 de Tampermonkey:
Here are the steps to continue running a Manifest V2 version of Tampermonkey:

Télécharger un paquet Download a package

Nom Name ID Les navigateurs Browsers Lien Link
Tampermonkey dhdgffkkebhmkfjojejmpbldmpobfkfo Google Chrome, Opera, MS Bord
Google Chrome, Opera, MS Edge
crx
Tampermonkey Héritage Tampermonkey Legacy lcmhijbkigalmkeommnijlpobloojgfn Google Chrome, Opera, MS Bord
Google Chrome, Opera, MS Edge
Chrome Web Store | crx
Chrome Web Store | crx
Tampermonkey Héritage Tampermonkey Legacy   bnimknkampfeeemccidiigealnpoheap*   Google Chrome, Opera, MS Edge   crx

  * not signed by the official store

  Please note that if you install Tampermonkey version ID on a Chrome browser version 120 or higher, you will need to disable the automatic updates somehow (link, link). Otherwise, Tampermonkey will automatically update to the newest Manifest V3 version.dhdg

  Installation

  If you are using a Tampermonkey version that is not signed by the official store, you will need to enable the "Developer mode" switch at the top right of the extensions page in your browser. 
Then you can drag and drop the downloaded CRX file into the extensions page as explaind in Q407.

  ExtensionManifestV2Availability

  Furthermore, if using a Chrome browser version 120 or higher, you will need to enable ExtensionManifestV2Availability

  •   Windows

      Either make a shortcut to Chrome and add to the target field or run the following command in the command prompt:--enable-features=ExtensionManifestV2Availability

    chrome.exe --enable-features=ExtensionManifestV2Availability
    

      or add the following registry keys:

    Windows Registry Editor Version 5.00
    
    [HKEY_LOCAL_MACHINE\SOFTWARE\Policies\BraveSoftware\Brave]
    "ExtensionManifestV2Availability"=dword:00000002
    
    [HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Chromium]
    "ExtensionManifestV2Availability"=dword:00000002
    
    [HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome]
    "ExtensionManifestV2Availability"=dword:00000002
    
    [HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge]
    "ExtensionManifestV2Availability"=dword:00000002
    
    [HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Vivaldi]
    "ExtensionManifestV2Availability"=dword:00000002
    
    [HKEY_LOCAL_MACHINE\SOFTWARE\Policies\YandexBrowser]
    "ExtensionManifestV2Availability"=dword:00000002
    
  •   macOS

      Run the following command in the terminal:

    open -a "Google Chrome" --args --enable-features=ExtensionManifestV2Availability
    

      or check this link for an alternative solution.

  •   Linux

      Run the following command in the terminal:

    google-chrome --enable-features=ExtensionManifestV2Availability
    

      or add policy file named to the following directory and add the following content to the:ExtensionManifestV2Availability.json

    {
        "ExtensionManifestV2Availability"true
    }
    

      ici:

    •   Chrome: /etc/opt/chrome/policies/managed/
    •   Bord: /etc/opt/edge/policies/managed/
    •   Chrome + Vivaldi : /etc/chromium/policies/managed/

  Développement du soutien

Q500 : XYZ est ma langue maternelle. Comment puis-je traduire Tampermonkey en XYZ ?

  A500 Merci! :) C’est assez facile.

Il suffit de cloner ou de dupliquer le dépôt i18n à partir de Github, d’appliquer vos modifications et de m’envoyer le fichier ou de créer une demande de tirage.

Pour plus d’informations sur le fonctionnement de l’internationalisation des extensions, consultez la documentation de Google sur le développement d’extensions.

Astuce : vous pouvez joindre un fichier supplémentaire appelé qui sera livré à partir de maintenant avec l’extension.about.txt

Q501 : Ma langue maternelle est déjà supportée et je n’ai aucune idée de comment écrire des javascripts. Comment puis-je vous accompagner ?

A501 Vous pouvez utiliser Tampermonkey et signaler les bogues si vous en avez trouvé un, faire une petite contribution ou donner à Tampermonkey une note de 5 étoiles ici.

  Merci. 😅

  Débogage

Q600 : Où peut-on trouver la sortie console de Tampermonkey ?

A600 Avant d’obtenir la sortie, vous devez activer la sortie de débogage. Il suffit de cliquer sur l’icône Tampermonkey, de choisir « Tableau de bord », de sélectionner l’onglet « Paramètres » et de régler « Niveau de journalisation » sur « Déboguer ». ( tutoriel vidéo)

Il existe 3 consoles différentes sur lesquelles Tampermonkey peut écrire des messages de journal.

  • Tout d’abord, la console de la page d’arrière-plan qui peut être accessible de cette manière :

    Dans Google Chrome, rendez-vous sur la page des extensions en cliquant sur l’icône « Plus » (les trois points) dans le coin supérieur droit de la fenêtre, en sélectionnant « Plus d’outils », puis en cliquant sur « Extensions ». Sur la page des extensions, recherchez l’extension pour laquelle vous souhaitez accéder à la console de la page d’arrière-plan et cliquez sur le lien « Détails » à droite de son nom. Sur la page de détails de l’extension, cliquez sur le lien « page d’arrière-plan » sous la section « Inspecter les vues ». Cela ouvrira la page d’arrière-plan dans une nouvelle fenêtre ou un nouvel onglet. ( tutoriel vidéo)

    Dans Firefox, allez sur la page des extensions en cliquant sur l’icône « Plus » (les trois inconvénients) dans le coin supérieur droit de la fenêtre, en sélectionnant « Modules complémentaires et thèmes ». Cliquez sur l’icône d’engrenage dans le coin supérieur droit et choisissez « Debug Add-ons ». Sur la page de débogage, recherchez l’entrée Tampermonkey et cliquez sur « Inspecter ». Enfin, sélectionnez l’onglet « Console ».

  •   Le second est la console de page d’options.

    Vous pouvez l’ouvrir de cette façon : faites un clic droit sur l’icône Tampermonkey et choisissez « Tableau de bord ». Dans le nouvel onglet, appuyez sur « Ctrl-Maj-J » ou « F12 » et sélectionnez l’onglet « Console ».

  •   Enfin, chaque page Web dispose d’une console.

    Celui-ci peut être ouvert par « Ctrl-Shift-J » lors de l’affichage de la page. ( tutoriel vidéo)