JBrowser Source Docs
You are reading the documentation for JBrowser 1.5.0. The newest release is 1.5.4. Go to the latest documentation

Data files and locations

Generated from the source code of JBrowser 1.5.0.

Where JBrowser keeps its data, generated from AppPaths in jbrowser/paths.py.

Folder Normally With --profile-dir PATH
<data> %APPDATA%\JBrowser PATH
<cache> %LOCALAPPDATA%\JBrowser\Cache PATH\Cache

Files and folders#

AppPaths attribute Location Contents
profiles <data>\Profiles One Chromium profile folder per space: cookies, storage, permissions.
profile_cache <cache>\Profiles Each space's HTTP cache.
favicons <cache>\Favicons The favicon cache (never written for incognito spaces).
logs <data>\Logs jbrowser.log, rotated at 2 MB, three old copies kept.
settings_file <data>\settings.json Every preference (core/settings.py), written 0.4 s after the last change.
session_file <data>\session.json Spaces, cards, layout and each card's back/forward history (services/session.py).
history_db <data>\history.sqlite3 Browsing history, SQLite in WAL mode (services/history.py).
bookmarks_file <data>\bookmarks.json Bookmarks and the bookmarks bar (services/bookmarks.py).
vault_file <data>\vault.bin The encrypted password vault (services/vault.py).
downloads_file <data>\downloads.json The downloads list (services/downloads.py).
userscripts_file <data>\userscripts.json User scripts and styles (services/userscripts.py).
blocklist_file <data>\blocklist.txt Tracker and ad domains from the downloaded lists (services/privacy.py).
threatlist_file <data>\threats.txt Phishing and malware hosts (services/threats.py).
reset_marker <data>\.factory-reset Present when a factory reset is pending; the next start erases everything.
archive_file <data>\archive.json The Archive: cards closed in the last 48 hours (services/archive.py).
favourites_file <data>\favourites.json Sidebar favourites (services/favourites.py).

Other files JBrowser owns in <data> (AppPaths.OWNED, removed by a factory reset): history.sqlite3-wal, history.sqlite3-shm, history.sqlite3-journal, filters.txt.

Other locations#

What Where
The installed program %LOCALAPPDATA%\Programs\JBrowser\ (or Program Files with /ALLUSERS)
Downloaded updates (temporary) %TEMP%\JBrowser-Update\
Build output dist\ and build\ in the repository, or %LOCALAPPDATA%\JBrowser-build\ for a repository inside OneDrive

How these files are written and deleted is explained in persistence.