Metadata-Version: 2.4
Name: icq-parser
Version: 1.3.0
Summary: ICQ Parser
Author-email: "Corey Forman (digitalsleuth)" <github@digitalsleuth.ca>
Maintainer-email: "Corey Forman (digitalsleuth)" <github@digitalsleuth.ca>
Project-URL: Homepage, https://github.com/digitalsleuth/icq-parser
Keywords: digital forensics,dfir,icq,ios,parse
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: flask
Requires-Dist: playwright>=1.45.0
Requires-Dist: beautifulsoup4
Requires-Dist: pypdf
Requires-Dist: requests
Requires-Dist: pywebcopy
Requires-Dist: selenium
Requires-Dist: six
Requires-Dist: Pillow
Requires-Dist: python-magic-bin; sys_platform == "win32" or sys_platform == "darwin"
Requires-Dist: python-magic; sys_platform != "win32" and sys_platform != "darwin"
Dynamic: license-file

# ICQ Parser
This tool is designed to provide a web-based view of the contents of the ICQ chat application.

It also parses the contents into JSON files which can be ingested into other tool-sets.

## Usage

### Install
```bash
python3 -m pip install icq-parser
```

Then:

```bash
playwright install chromium
```

This will install the chromium headless version for the desired system. It is only required once, before initial run, and thus  
internet connectivity is required for this one time only.


### Process

```bash
usage: icq-parser process [-h] {ios,desktop} ...

options:
  -h, --help     show this help message and exit

Device Type:
  {ios,desktop}
    ios          process iOS artifacts
    desktop      process desktop artifacts
```

```bash
usage: icq-parser process ios [-h] -s <PATH> -d <PATH> [--log]

options:
  -h, --help            show this help message and exit
  -s <PATH>, --source <PATH>
                        source path for the iOS ICQ artifacts
  -d <PATH>, --dest <PATH>
                        destination path to save the processing output
  --log                 generates a log file
```

```bash
usage: icq-parser process desktop [-h] -s <PATH> -d <PATH> [--log]

options:
  -h, --help            show this help message and exit
  -s <PATH>, --source <PATH>
                        source path for the ICQ Desktop artifacts
  -d <PATH>, --dest <PATH>
                        destination path to save the processing output
  --log                 generates a log file
```

### Load

```bash
usage: icq-parser load [-h] {ios,desktop} ...

options:
  -h, --help     show this help message and exit

Device Type:
  {ios,desktop}
    ios          load iOS artifacts
    desktop      load desktop artifacts
```

```bash
usage: icq-parser load ios [-h] [-i <IP>] [-l] [-p <PATH>] [-m] -s <PATH>
                              [--debug] [--log]

options:
  -h, --help            show this help message and exit
  -i <IP>, --ip <IP>    IPv4 address to use for the web interface
  -l, --links           Enable clickable links.
  -p <PATH>, --print <PATH>
                        Path to store the PDF-printed webpages.
  -m, --merge           Merge PDFs into a single PDF, requires -p/--print
  -s <PATH>, --source <PATH>
                        Path to the source JSON files to display in the web
                        interface
  --debug               Rapid relaunch of script for debugging without
                        indexing
  --log                 generates a log file
```

```bash
usage: icq-parser load desktop [-h] [-i <IP>] [-l] [-p <PATH>] [-m] -s
                                  <PATH> [--debug] [--log]

options:
  -h, --help            show this help message and exit
  -i <IP>, --ip <IP>    IPv4 address to use for the web interface
  -l, --links           Enable clickable links.
  -p <PATH>, --print <PATH>
                        Path to store the PDF-printed webpages.
  -m, --merge           Merge PDFs into a single PDF, requires -p/--print
  -s <PATH>, --source <PATH>
                        Path to the source JSON files to display in the web
                        interface
  --debug               Rapid relaunch of script for debugging without
                        indexing
  --log                 generates a log file
```

### Save

```bash
usage: icq-parser save [-h] {ios,desktop} ...

options:
  -h, --help     show this help message and exit

Device Type:
  {ios,desktop}
    ios          save iOS webpage
    desktop      save desktop webpage
```

```bash
usage: icq-parser save ios [-h] [-i <IP>] [-l] -s <PATH> -d <PATH> [--log]

options:
  -h, --help            show this help message and exit
  -i <IP>, --ip <IP>    IPv4 address to use for the web interface
  -l, --links           Enable clickable links.
  -s <PATH>, --source <PATH>
                        Path to the source JSON files to display in the web
                        interface
  -d <PATH>, --dest <PATH>
                        Location to save the downloaded webpage
  --log                 generates a log file
```

```bash
usage: icq-parser save desktop [-h] [-i <IP>] [-l] -s <PATH> -d <PATH>
                                  [--log]

options:
  -h, --help            show this help message and exit
  -i <IP>, --ip <IP>    IPv4 address to use for the web interface
  -l, --links           Enable clickable links.
  -s <PATH>, --source <PATH>
                        Path to the source JSON files to display in the web
                        interface
  -d <PATH>, --dest <PATH>
                        Location to save the downloaded webpage
  --log                 generates a log file
```
