Skip to content

Latest commit

 

History

History
101 lines (69 loc) · 6.81 KB

README.md

File metadata and controls

101 lines (69 loc) · 6.81 KB

FlagCookies

A cookie, and browser storage manager with cow powers. Gives the ability to flag and set rules explicitly for cookies, also third-party cookies, cross origin, and secure cookies aswell as browser storage management and clearing.

Domain.net and subdomain.Domain.net can have individual rights. Providing several modes to set rules on cookies and keeping a cookie profile, while being logged in in a website or service.

Important privacy notice

  • No cookie information besides the name and domain name are stored inside FlagCookies to work, no values, no direct details.
  • No session data or details are stored or processed
  • No history of visited domains or websies or any other tracking is used.

Before you use this addon

This add-on is mainly aimed at power users, this might sound harsh, but it is realy not!

To get the most out of FlagCookies, you define cookie rules for websites or make use of Global Flag, or Auto flag, Profile modes. In case you use payment services/providers, disable the "Global flag" feature temporarily. For example when using Paypal or other shopping/payment services or providers.

Long story made short - Basic usage

  1. Use Global mode if you are surfing, this will remove all kind of cookies while browsing the web if not protected by profile mode.
  2. Use Auto flag which will remove all cookies for one website/domain - this can be useful if you only want to automatically remove these page cookies every time you browse this website.
  3. Use Profile mode either globally for a website, protecting all cookies of that domain if no cookies are picked as profile cookies. Or protect single cookies even when Global flag or Auto flag modes are active.
  4. Click / Flag and set rules for each cookie individually, works together with the other modes.

Requirements

A recent version of possibly any Chrome browser, Firefox, Opera, Edge or Brave browser(s). Please note, there is no mobile version of FlagCookies.

Some features

FlagCookies distinguishes between http(s)://domain.net and http(s)://subdomain.domain.net for the following features:

  • Detects and displays stored browser cookies, storage data, and be able to manage (flag) and delete those while browsing, either automatically through global or auto flag mode or by explicit decision
  • Flag cookies either to be explicitly deleted even without global or auto flag mode or set them to be permitted or protected from removal by global or auto flag modes
  • Profile mode for a domain or cookies - to switch between logged into a website/service and not logged in modes in order to remove or keep cookies on demand
  • Auto flag mode only affecting this particular (sub)domain, removing every domain cookie which is not permitted or used as profile cookie, this also includes third-party and cross origin cookies.
  • Support for Firefox Multi-Account-Containers
  • Preferences allowing to import and export settings to a ZIP file. Import does not work in private windows!
  • Preferences allows to manage logged in profile cookies, delete all domain settings and add-on settings
  • An Action log avaible in Preferences which provides output of what FlagCookies is doing. The Action log is disabled by default due to performance improvements and RAM usage - even so the log is cleared mostly on reload
  • Displays count of deleted cookies in the browser toolbar icon and in addition a breakdown summary of the action log when hovering the toolbar icon if the action log is enabled
  • Optional notifications
  • Support for firstPartyIsolate/firstPartyDomain cookies
  • Support for container tabs/contextual identities

Installation

Firefox

Use addons.mozilla.org: Flag Cookies on Add-ons Mozilla.org

Opera

Use addons.opera.com: Flag Cookies on Add-ons Opera.com

Chrome

Use the Chrome web store: Flag Cookies on the web store @ chrome.google.com

Edge

Use Edge addon store: Flag Cookies @ Microsoft for Edge

Help, documentation and usage

Please read along here: https://github.com/jrie/flagCookies/wiki/FlagCookies-help-and-documentation

Support the cause

If you like this or other pieces of software I do, you can give me a tip!

You can use PayPal.me/dwroxnet or if you prefer, Ko-fi.

See the details here: ko-fi

JDownloader2

Note: It is possible to export detected cookies into a json file or into the clipboard, used by JDownloader2, from the Settings tab inside of FlagCookies. More information also can be found here: JDownloader2 Knowledgebase with cookie import instructions

Translations

As of version 3.0.27 translations can be done of Flag Cookies.

FlagCookies is also now translateable on Transifex at the flagCookies project page.

For direct translation

All translations are located inside _locales/ folder - and the folders en for general English, as well as de for German language. Inside every folder is a messages.json located. This file holds all translations for the interface. To create a new language, for example French, use fr as code. So it ends up to everything French language related inside _locales/fr/messages.json. To add another layer of help copy the help.html from the en directory to fr/help.html - when everything is done, the changes will be visible when reloading the addon.

More information can also be found here: https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Internationalization

Providing feedback/feature wishes/ideas

Please file an issue on the issues page. I gladly try to respond to feedback and to improve FlagCookies. If you think a feature is missing or at worst, not working as expected, please also open an issue.

There is also a discussion on Mozillas Discourse where you can provide feedback: Flag Cookies on Mozilla Discourse

Thanks and notes

To all who helped so far through critic, general feedback and ideas. Keeps me going! And of course for everyone supporting the project in this or the other way.

German speaking thread @ ngb.to about FlagCookies

Flag Cookies on german bulletin board ngb.to