JBrowser Source Docs

Data files and locations

Generated from the source code of JBrowser 1.5.3.

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.