Skip to content
No description, website, or topics provided.
Python
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bring2lite
.gitignore
README.md
__init__.py
setup.py

README.md

bring2lite

About

The tool was developed to process SQLite databases in respect of deleted records. Therefore, bring2lite is able to analyse the structures within the main database, WAL and journal files.

Requirements

  • Python3

Licence

  • CC-BY-NC

Installation

  1. Clone the repository
  2. cd into the repository
  3. python3 setup.py install
  4. pip3 install pyqt5

Usage

  • Process a single database main file:
main.py --filename /path/to/file --out /path/to/output/folder
  • Process a single journal file:
main.py --journal /path/to/journal/file --out /path/to/output/folder
  • Process a single WAL file:
main.py --wal /path/to/wal/file --out /path/to/output/folder
  • Process a single database main file:
main.py --filename /path/to/database/file --out /path/to/output/folder
  • Process all files within a single folder and all sub-folders:
main.py --folder /path/to/folder --out /path/to/output/folder
  • Process a single database main file with GUI (EXPERIMENTAL):
main.py --filename /path/to/database/file --out /path/to/output/folder --gui 1

Used libraries

  • tqdm - a library which can be used to created progress bars
  • sqlparse - this library allows to easily process SQLite statements
  • pyqt5 and tkinter - libraries which allow to display the processed results within a GUI

Changelog

  • 14-03-2019 - publication of version 0.1

Tasklist

  • Better error handling
  • Display all processed informations in a interactive GUI
  • Fix a bug that sometimes do not add the SQLite schema to the top of a outputfile
  • Fix a bug which adds a line of # after each outputline
  • Optimize parsing algorithm to process multiple freeblocks in a row
  • The name of a created file is off by one
You can’t perform that action at this time.