profile-cleaner(1)

📦
version 2.46 · 2 versions
, in ubuntu resolute, ubuntu stonking

💖 profile-cleaner(1) 💖

okay bestie, welcome to the manual for profile-cleaner — the little shell script that makes your browser profiles ✨skinnier✨. it's a section-1 manual page, it's iconic, and you're gonna love it.

🌸 NAME 🌸

profile-cleaner — shrink your browser (and a few email app) profiles by organizing their sqlite databases with sqlite3's vacuum and reindex functions. and yeah, "browser" is used loosely here because profile-cleaner is happy to work on some email clients too. it's giving versatile 💅

🦋 SYNOPSIS 🦋

profile-cleaner [option]

✨ DESCRIPTION ✨

so like, profile-cleaner is a very simple shell script that calls up sqlite3 to vacuum and reindex the databases belonging to supported browsers and email clients. no cap, that's the whole vibe.

it's compatible with profile-sync-daemon, so you do not have to stop psd before you call profile-cleaner. and honestly? profiles clean way faster when they're synced to tmpfs via psd. main character energy fr fr 🔥

⚠️ the one thing you MUST do: make sure your target browsers or email clients are not running when you invoke profile-cleaner. if you don't, the open files will NOT get cleaned and reindexed. like, at all. zero. it's giving wasted effort 😭 so close them first, bestie.

💅 OPTIONS 💅

one option per run, and each one is a lil vibe:

  • b — clean brave's profile
  • c — clean chromium's profile
  • ck — clean conkeror's profile(s)*
  • e — clean edge's profile
  • f — clean firefox's profile(s)*
  • fa — clean falkon's profile
  • gc — clean google-chrome's profile
  • h — clean heftig aurora's profile(s)*
  • i — clean icecat's profile(s)*
  • id — clean icedove's profile
  • ix — clean Inox's profile
  • l — clean Librewolf's profile
  • m — clean midori's profile
  • o — clean opera's profile
  • t — clean thunderbird's profile(s)*
  • to — clean tor-browser's profile
  • s — clean seamonkey's profile(s)*
  • pm — clean palemoon's profile(s)*
  • p — clean the defined paths
  • v — clean vivaldi's profile

* for the starred ones, profile-cleaner will parse the respective profiles.ini file and clean all profiles defined in there. all of them. every single one 🫶

🎀 CONFIG FILE 🎀

the very first time you invoke profile-cleaner, it creates $HOME/.config/profile-cleaner.conf for you. cute, right?

inside, you can define a color scheme based on your terminal's background color. the default is a dark scheme for dark colored terminals. the file is commented and self-explanatory, so you won't be lost. iykyk ✨

🌈 EXAMPLES 🌈

clean all firefox profiles:

$ profile-cleaner f

clean the chromium profile:

$ profile-cleaner c

clean a user-defined profile:

$ profile-cleaner p /path/to/profile

👑 SUPPORTED BROWSERS AND EMAIL CLIENTS 👑

currently, the following are supported:

🍓 SAMPLE OUTPUT 🍓

here's what it looks like when you invoke the firefox option (your mileage will vary, bestie):

$ profile-cleaner f
/home/facade/.mozilla/firefox/zee52krz.default/cookies.sqlite reduced by .87 Mbytes
/home/facade/.mozilla/firefox/zee52krz.default/signons.sqlite reduced by .41 Mbytes
/home/facade/.mozilla/firefox/zee52krz.default/downloads.sqlite reduced by .56 Mbytes
/home/facade/.mozilla/firefox/zee52krz.default/chromeappsstore.sqlite reduced by .03 Mbytes
/home/facade/.mozilla/firefox/zee52krz.default/urlclassifier3.sqlite reduced by 43.10 Mbytes
/home/facade/.mozilla/firefox/zee52krz.default/formhistory.sqlite reduced by .11 Mbytes
/home/facade/.mozilla/firefox/zee52krz.default/addons.sqlite reduced by 0 Mbytes
/home/facade/.mozilla/firefox/zee52krz.default/permissions.sqlite reduced by 0 Mbytes
/home/facade/.mozilla/firefox/zee52krz.default/content-prefs.sqlite reduced by 0 Mbytes
/home/facade/.mozilla/firefox/zee52krz.default/extensions.sqlite reduced by 0 Mbytes
/home/facade/.mozilla/firefox/zee52krz.default/webappsstore.sqlite reduced by 0 Mbytes
/home/facade/.mozilla/firefox/zee52krz.default/OfflineCache/index.sqlite reduced by 0 Mbytes
/home/facade/.mozilla/firefox/zee52krz.default/search.sqlite reduced by 0 Mbytes
/home/facade/.mozilla/firefox/zee52krz.default/places.sqlite reduced by 9.98 Mbytes

firefox profile reduced by 55.06 Mbytes

🧚 CONTRIBUTE 🧚

wanna contribute to this code? slay. please fork and send a pull request. the source is freely available on github:

https://github.com/graysky2/profile-cleaner

💀 BUGS 💀

none known. periodt.

💜 AUTHOR 💜

graysky (graysky AT archlinux DOT us)

⭐ SEE ALSO ⭐

profile-sync-deamon (1)

🌸 and that's the whole page, bestie! this lil manual is from the source/version line that says profile-cleaner(1), dated 14 February 2026. go forth and vacuum those databases 💖✨🎀
📦 where this page comes from