{"id":29570004,"url":"https://github.com/eliastik/page-shadow","last_synced_at":"2025-07-19T02:07:49.494Z","repository":{"id":41467396,"uuid":"93434772","full_name":"Eliastik/page-shadow","owner":"Eliastik","description":"A Chrome, Firefox, Opera and Edge extension to increase contrast, decrase brightness and invert color of websites","archived":false,"fork":false,"pushed_at":"2025-07-11T20:43:11.000Z","size":7806,"stargazers_count":19,"open_issues_count":1,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-07-11T22:22:24.419Z","etag":null,"topics":["chrome","chrome-extension","contrast","edge-extension","firefox","firefox-extension","opera","opera-extension","page-contrast","page-shadow","webextension"],"latest_commit_sha":null,"homepage":"http://www.eliastiksofts.com/page-shadow/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Eliastik.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-06-05T18:31:43.000Z","updated_at":"2025-07-01T09:56:09.000Z","dependencies_parsed_at":"2023-12-21T00:29:53.908Z","dependency_job_id":"4ef15bdb-941c-4990-aaa6-a7058f9d3e17","html_url":"https://github.com/Eliastik/page-shadow","commit_stats":null,"previous_names":[],"tags_count":34,"template":false,"template_full_name":null,"purl":"pkg:github/Eliastik/page-shadow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Eliastik%2Fpage-shadow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Eliastik%2Fpage-shadow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Eliastik%2Fpage-shadow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Eliastik%2Fpage-shadow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Eliastik","download_url":"https://codeload.github.com/Eliastik/page-shadow/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Eliastik%2Fpage-shadow/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265872833,"owners_count":23842254,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chrome","chrome-extension","contrast","edge-extension","firefox","firefox-extension","opera","opera-extension","page-contrast","page-shadow","webextension"],"created_at":"2025-07-19T02:07:48.952Z","updated_at":"2025-07-19T02:07:49.486Z","avatar_url":"https://github.com/Eliastik.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Page Shadow :\n## English :\n\n\u003cimg src=\"https://raw.githubusercontent.com/Eliastik/page-shadow/master/screen.png\" width=\"300\" alt=\"Page Shadow\" /\u003e \u003cimg src=\"https://raw.githubusercontent.com/Eliastik/page-shadow/master/screen_2.png\" width=\"300\" alt=\"Page Shadow\" /\u003e\n\nAn extension by Eliastik (eliastiksofts.com) - Contact : http://www.eliastiksofts.com/contact/\n* Latest version: 2.11.4 (6/23/2025)\n* Official website: http://eliastiksofts.com/page-shadow\n* Github repository: https://github.com/Eliastik/page-shadow\n\nThis is the source code for the extension Page Shadow, compatible with Chrome/Chromium, Firefox, Opera and Microsoft Edge. This extension uses the WebExtensions technology via the Browser API (more infos : https://developer.mozilla.org/fr/Add-ons/WebExtensions ).\n\nPage Shadow is a dark mode extension. It includes a series of tools to improve the reading of web pages in a dark environment.\n\nIt allows you:\n\n- To increase the contrast of the pages, that is to say to reinforce the dark tones of the pages: the extension transforms the design of any site into a \"dark mode\" theme;\n- To decrease the brightness of the pages;\n- To invert the colors of images or entire pages;\n- To attenuate the colors of images;\n- To enable a night mode (applies an orange filter on the pages to reduce the blue light emitted by the screen).\n\nPage Shadow has many settings to personalize your extension: settings adapted to each site, automatic enable/disable, etc.\n\n### Installation:\n\nPage Shadow is avalaible to download and install at the following addresses:\n\n* Chrome : https://chrome.google.com/webstore/detail/eimaelgbclmdoeimifebaagealdkjmki/\n* Firefox : https://addons.mozilla.org/fr/firefox/addon/page-shadow/\n* Opera : https://addons.opera.com/fr/extensions/details/page-shadow/?display=fr\n* Edge : https://microsoftedge.microsoft.com/addons/detail/ofcbmommmmaoekccnfojdpjgopgcbgbd\n\nFor the other compatibles browser, you can install this extension from the official website: http://eliastiksofts.com/page-shadow\nOr you can compile it yourself (see Compilation section).\n\n### Compilation :\n\nYou can compile yourself the extension with only one command line. To do this, you have to install npm.\n\nTo install npm for your OS, read this page: https://docs.npmjs.com/getting-started/installing-node\n\nGit clone the repository and cd to the project directory (or download it directly from Github):\n````\ngit clone https://github.com/Eliastik/page-shadow.git\ncd page-shadow\n````\n\nTo install the depedencies, run the following command:\n````\nnpm install\n````\nThen to compile:\n\n* Dev mode (no compression): `npx gulp` or `npx gulp build-dev` or `npx gulp build-directory-dev` (only compile as folders)\n* Prod mode (with compression): `npx gulp build-prod` or `npx gulp build-directory-prod` (only compile as folders)\n* Watch mode (real-time compilation): `npx gulp watch` (uses dev mode compilation)\n\nIf you encounter the following error message when compiling:\n\n````\nerror:25066067:DSO support routines:dlfcn_load:could not load the shared library\n````\n\nTry to launch the following command: `export OPENSSL_CONF=/dev/null`\n\nThe extension files compiled will be created in the sub-directory \"build\".\n\n(Note: The key directory contains a key needed to compile the Chrome extension).\n\nTo install the extension in Firefox, you need to install Firefox Developer Edition then modify the following value in about:config to \"false\": xpinstall.signatures.required\nThen launch the installation with the .xpi file.\n\nFor Chromium, slide the .crx file into the extension page (chrome://extensions).\n\nThen if you want to clean the build directory, run the command `npx gulp clean-build`\n\n### Manifest V2 and Manifest V3 Versions\n\nThe Manifest V2 and Manifest V3 versions of the extension offer exactly the same features and share the same codebase, except for a few implementation differences due to API changes between the two formats.\n\nThere is, however, a subtle difference: the timer used for certain features (such as enabling/disabling the extension based on the time of day, or automatically updating filters) behaves differently depending on the version:\n\n- Manifest V3: relies on the alarms API, which is limited to a minimum interval of one minute.\n- Manifest V2: uses setInterval, allowing the timer to run every second.\n\nAs a result, in the Manifest V3 version, some scheduled actions (like time-based activation) may experience a slight delay compared to the Manifest V2 version.\n\n### License:\n\nPage Shadow is distributed under GPL-3.0 license (see LICENCE.txt file)\n\n#### License notice\n\nCopyright (C) 2015-2025 Eliastik (eliastiksofts.com)\n\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with this program.  If not, see \u003chttp://www.gnu.org/licenses/\u003e.\n\n### Credits :\n\n- Source Sans Pro (version 2.020), SIL Open Font License version 1.1 ( http://scripts.sil.org/OFL ) : https://github.com/adobe-fonts/source-sans-pro/blob/master/LICENSE.txt\n- Bootstrap (CSS and Javascript), MIT license ( https://github.com/twbs/bootstrap/blob/v4-dev/LICENSE ) ;\n    - Theme: Paper by Bootswatch (modified) - https://bootswatch.com/paper/\n- This extension uses a picture from this site: http://littlevisuals.co , Public domain ( https://creativecommons.org/publicdomain/zero/1.0/ ).\n- See package.json dependencies\n\n## Français :\n\n\u003cimg src=\"https://raw.githubusercontent.com/Eliastik/page-shadow/master/screen_fr.png\" width=\"300\" alt=\"Page Shadow\" /\u003e \u003cimg src=\"https://raw.githubusercontent.com/Eliastik/page-shadow/master/screen_fr_2.png\" width=\"300\" alt=\"Page Shadow\" /\u003e\n\nUne extension by Eliastik (eliastiksofts.com) - Contact : http://www.eliastiksofts.com/contact/\n* Version actuelle : 2.11.4 (23/06/2025)\n* Site officiel : http://eliastiksofts.com/page-shadow\n* Dépôt Github : https://github.com/Eliastik/page-shadow\n\nCeci est le code source de l'extension Page Shadow, compatible avec Chrome/Chromium, Firefox, Opera et Microsoft Edge. Cette extension utilise la technologie WebExtensions via l'API Browser (plus d'infos : https://developer.mozilla.org/fr/Add-ons/WebExtensions ).\n\nPage Shadow est une extension de mode sombre (dark mode). Elle comprend une série d'outils pour améliorer la lecture de pages web dans une pièce mal éclairée ou dans un environnement sombre.\n\nElle vous permet :\n\n- D'augmenter le contraste des pages, c'est à-dire de renforcer les tons sombres des pages : l'extension transforme le design de n'importe quel site en \"mode sombre\" ;\n- De baisser la luminosité des pages ;\n- D'inverser les couleurs des images ou des pages entières ;\n- D'atténuer les couleurs des images ;\n- D'activer un mode nuit (applique un filtre orangé sur les pages pour réduire la lumière bleue émise par l'écran).\n\nPage Shadow dispose de nombreux paramètres pour personnaliser votre expérience de l'extension : réglages adaptés à chaque site, activation/désactivation automatique, etc.\n\n### Installation :\n\nPage Shadow est disponible au téléchargement et à l'installation aux adresses suivantes :\n\n* Chrome : https://chrome.google.com/webstore/detail/eimaelgbclmdoeimifebaagealdkjmki/\n* Firefox : https://addons.mozilla.org/fr/firefox/addon/page-shadow/\n* Opera : https://addons.opera.com/fr/extensions/details/page-shadow/?display=fr\n* Edge : https://microsoftedge.microsoft.com/addons/detail/ofcbmommmmaoekccnfojdpjgopgcbgbd\n\nPour les autres navigateurs compatibles, vous pouvez soit l'installer depuis le site officiel : http://eliastiksofts.com/page-shadow\nSoit la compiler vous-même (voir section \"Compilation\").\n\n### Compilation :\n\nVous pouvez compiler vous-même l'extension en une ligne de commande. Pour cela, vous devez avoir installé npm.\n\nPour installer npm sur votre système, plus d'infos ici : https://docs.npmjs.com/getting-started/installing-node\n\nFaites un Git clone du dépôt et faites un cd vers le dossier du projet (ou bien téléchargez le directement depuis Github) :\n````\ngit clone https://github.com/Eliastik/page-shadow.git\ncd page-shadow\n````\n\nPour installer les dépendances, lancez la commande suivante :\n````\nnpm install\n````\nPuis pour compiler :\n\n* Mode dev (pas de compression) : `npx gulp` ou `npx gulp build-dev` ou `npx gulp build-directory-dev` (pour ne builder que sous forme de dossiers)\n* Mode prod (compression) : `npx gulp build-prod` ou `npx gulp build-directory-prod` (pour ne builder que sous forme de dossiers)\n* Mode watch (compilation en temps réel) : `npx gulp watch` (utilise la compilation du mode dev)\n\nSi vous rencontrez l'erreur suivante lors de la compilation :\n\n````\nerror:25066067:DSO support routines:dlfcn_load:could not load the shared library\n````\n\nEssayez de lancer la commande suivante : `export OPENSSL_CONF=/dev/null`\n\nLes fichiers d'extension compilés seront créés dans le dossier \"build\".\n\n(Note : le répertoire key contient une clé nécessaire à la création d'une extension Chrome).\n\nPour installer l'extension dans Firefox, vous devez installer Firefox Developer Edition et modifier la valeur suivante dans about:config en \"false\" : xpinstall.signatures.required\nPuis lancez l'installation avec le fichier .xpi\n\nPour Chromium, faites glisser le fichier .crx dans la fenêtre des extensions (chrome://extensions).\n\nPuis si vous souhaitez nettoyer le répertoire de build, lancez la commande `npx gulp clean-build`\n\n### Versions Manifestv2 et Manifestv3\n\nLes versions Manifest V2 et Manifest V3 offrent exactement les mêmes fonctionnalités et partagent une base de code commune, à l’exception de quelques différences liées aux API spécifiques à chaque version.\n\nIl existe toutefois une différence subtile : le minuteur utilisé pour certaines fonctionnalités de l’extension (comme l’activation/désactivation automatique selon l’heure, ou la mise à jour automatique des filtres) fonctionne différemment selon la version :\n\n- Manifest V3 : le minuteur repose sur l’API alarms, limitée à une fréquence minimale d’une minute.\n- Manifest V2 : un setInterval permet un déclenchement toutes les secondes.\n\nPar conséquent, sur la version Manifest V3, certaines actions programmées (comme l’activation horaire) peuvent être légèrement décalées par rapport à la version Manifest V2.\n\n### Licence :\n\nPage Shadow est distribué sous licence GNU GPL-3.0 (voir le fichier LICENCE.txt)\n\n#### Avis de licence\n\nCopyright (C) 2015-2025 Eliastik (eliastiksofts.com)\n\nCe programme est un logiciel libre ; vous pouvez le redistribuer ou le\nmodifier suivant les termes de la GNU General Public License telle que\npubliée par la Free Software Foundation ; soit la version 3 de la\nlicence, soit (à votre gré) toute version ultérieure.\n\nCe programme est distribué dans l'espoir qu'il sera utile,\nmais SANS AUCUNE GARANTIE ; sans même la garantie tacite de\nQUALITÉ MARCHANDE ou d'ADÉQUATION à UN BUT PARTICULIER.\nConsultez la GNU General Public License pour plus de détails.\n\nVous devez avoir reçu une copie de la GNU General Public License en même temps\nque ce programme ; si ce n'est pas le cas, consultez \u003chttp://www.gnu.org/licenses\u003e.\n\n### Credits :\n\n- Source Sans Pro (version 2.020), SIL Open Font License version 1.1 ( http://scripts.sil.org/OFL ) : https://github.com/adobe-fonts/source-sans-pro/blob/master/LICENSE.txt\n- Bootstrap (CSS et Javascript), MIT license ( https://github.com/twbs/bootstrap/blob/v4-dev/LICENSE ) ;\n    - Thème : Paper par Bootswatch (modifié) - https://bootswatch.com/paper/\n- Cette extension utilise une photo venant de ce site : http://littlevisuals.co , domaine public ( https://creativecommons.org/publicdomain/zero/1.0/ ).\n- Voir les dépendances dans le fichier package.json","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feliastik%2Fpage-shadow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feliastik%2Fpage-shadow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feliastik%2Fpage-shadow/lists"}