How simomat/lowcarb works
lowcarb is a Firefox extension for retaining approved cookies while removing others, optionally on browser startup. Users configure retained domains and cleanup settings in the options page, then trigger cleanup manually or let the startup handler invoke it. Cleanup enumerates cookies, applies whitelist and open-tab protections, removes eligible cookies, optionally clears related site data, and may notify the user. The graph includes the options model and sorting UI as a useful internal layer. Source excerpts support the shown calls; other README capabilities are included where documented.
Main entry points: actions.js Cleanup Actions · browser.js Browser Adapter · index.js Options Page · background.js Background Handler
Components 15
Extension Runtime
- Background Handler
src/background.js
Cookie Cleanup
- Cleanup Actions
src/actions.js - Cookie Access
src/cookies.js - Open Tab Hosts
src/tabs.js - Site Data Removal
src/siteData.js
Options Interface
- Options Page
src/options/index.js - Domain Model
src/options/domainModel.js - Domain List
src/options/domainElementList.js - Domain Element
src/options/domainElement.js - Domain Sorting
src/options/domaincompare.js
Browser Access
- Browser Adapter
src/browser.js - Sync Storage
Other components
- User
- Firefox APIs
- Startup Event
Connections 26
- User → Options Page: configures
src/options/index.js - Options Page → Domain Model: loads domains
src/options/index.js - Domain Model → Browser Adapter: reads whitelist
src/options/domainModel.js - Domain Model → Cookie Access: gets cookies
src/options/domainModel.js - Options Page → Domain List: updates list
src/options/index.js - Domain List → Domain Element: renders entries
src/options/domainElementList.js - Domain List → Domain Sorting: sorts domains
src/options/domainElementList.js - Domain Element → Cleanup Actions: toggles whitelist
src/options/domainElement.js - Options Page → Cleanup Actions: starts cleanup
src/options/index.js - Options Page → Browser Adapter: updates settings
src/options/index.js - Startup Event → Background Handler: triggers handler
src/background.js - Background Handler → Browser Adapter: checks settings
src/background.js - Background Handler → Cleanup Actions: runs cleanup
src/background.js - Background Handler → Options Page: opens on action
- Cleanup Actions → Cookie Access: reads cookies
src/actions.js - Cleanup Actions → Browser Adapter: reads settings
src/actions.js - Cleanup Actions → Browser Adapter: reads whitelist
src/actions.js - Cleanup Actions → Open Tab Hosts: gets open hosts
src/actions.js - Cleanup Actions → Site Data Removal: removes site data
src/actions.js - Cookie Access → Browser Adapter: enumerates cookies
src/cookies.js - Open Tab Hosts → Browser Adapter: queries tabs
src/tabs.js - Site Data Removal → Browser Adapter: requests data removal
src/siteData.js - Browser Adapter → Firefox APIs: calls browser APIs
src/browser.js - Browser Adapter → Sync Storage: reads and writes
src/browser.js - Cleanup Actions → Firefox APIs: removes cookies
src/actions.js - Cleanup Actions → Browser Adapter: sends notification
src/actions.js