Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

firefox-forensics

Static Badge Static Badge GitHub License GitHub last commit

This is a simple forensic tool written in Python. Use this tool to fetch the content (id, url, date of last visit) from the places.sqlite database file of the Firefox browser on macOS.

Background

Firefox stores a variety of data in a directory called "Profiles." This directory also contains the places.sqlite database, which holds the browsing history. This program copies the places.sqlite database to the Desktop. Then it opens the database and reads the moz_places table. Three entries are displayed in the Terminal: the ID, the visited website, and the date.

Requirements

  • Python 3.13+ (It will probably work with other versions too, but I haven't tested it.)
  • macOS

Install

pip3 install firefox-forensics

Usage

To display the ID, the visited website, and the date in the terminal, execute the following command:

firefox-forensics -w

If this data should also be saved in a text file on the desktop, the option -o must be added:

firefox-forensics -o

This program does not read the original database (places.sqlite), but first creates a copy on the desktop. The data is then read from this copied database.

Changelog

see Changelog.md

Metadata

Release files for firefox-forensics 1.0.1b0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for firefox-forensics 1.0.1b0
File Size Uploaded Provenance
firefox_forensics-1.0.1b0.tar.gz 8.9 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for firefox-forensics 1.0.1b0
File Interpreter ABI Platform
firefox_forensics-1.0.1b0-py2.py3-none-any.whl Python 3, Python 2 none any Details

Total release size: 18.4 kB

Release files / firefox_forensics-1.0.1b0.tar.gz

Download URL firefox_forensics-1.0.1b0.tar.gz
Size 8.9 kB
Tags Source
SHA-256 checksum
How to use checksums
39709fc184aac96bb0e7cc88d21b40485979b614837cc67e351b2b7bfd60c49c
BLAKE2b-256 checksum
How to use checksums
aabe2566384b7f695a837122179c4c6596022b8ebf1e38c3fa2524523a39b33b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Release files / firefox_forensics-1.0.1b0-py2.py3-none-any.whl

Download URL firefox_forensics-1.0.1b0-py2.py3-none-any.whl
Size 9.5 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
ea4c9feb410e0f696fadaf013ecf3a75655e7fd0a6de2ca17851abcb3bb2b095
BLAKE2b-256 checksum
How to use checksums
309dc3f6d9670b812c8c089a6b2a63d0dc42c564114f5790e9ab5f555998d11e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Security for firefox-forensics 1.0.1b0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page