ARGOS — Beta

WARNING: BETA VERSION This script has been updated for Ubuntu 24.04 LTS and Ubuntu Budgie 24.04 LTS. It is under active testing. Always run it on a clean VM before using it in production. Report any problems by opening an issue.

Argos automatically configures an open-source OSINT workstation from a clean Ubuntu 24.04 LTS virtual machine.

Best practice recommends using a dedicated VM for each OSINT investigation. This script follows the methods described by Michael Bazzell in Open Source Intelligence Techniques.

Requirements
Tools
Installation
Installation Log
To Do
Resources
Credits
Licences
Version History
OSINT Analysis Guidelines
FAQ

Requirements

Ubuntu 24.04 LTS or Ubuntu Budgie 24.04 LTS (VM or workstation)
Any Linux username (the previous requirement to use osint has been removed)
System language: English
Active internet connection during installation
VirtualBox Guest Additions already installed — the script does not install them. Install Guest Additions before running setup.sh to enable clipboard sharing, drag-and-drop, and fullscreen support.

The script is optimised for VirtualBox. Code for VMware Tools is available in the comments.

Tested on:

Ubuntu Budgie 24.04 LTS (VM)
Ubuntu 24.04 LTS (VM)

No longer supported:

Ubuntu 22.04 LTS (some dependencies are incompatible)
Ubuntu 20.04 LTS

Tools

OSINT

Tool	Status	Notes
Amass	Active	Subdomain enumeration
Instaloader	Active	Instagram OSINT
Toutatis	Limited	Requires Instagram session ID
HTTrack	Active	Web crawling and mirroring
MediaInfo	Active	Media metadata analysis
ExifTool	Active	Metadata from documents and images
EyeWitness	Active	Website screenshots
The Harvester	Active	Email and domain recon
Metagoofil	Active	Metadata from public documents
recon-ng	Active	Modular OSINT framework
Sherlock	Active	Username search
SpiderFoot	Active	OSINT automation
blackbird	Active	Advanced username search
holehe	Active	Email OSINT
maigret	Active	Username search (advanced Sherlock fork)
Maltego	Active	Link analysis (requires account)
yt-dlp	Active	Video downloader (replaces youtube-dl)

Removed tools (abandoned or discontinued):

~~Instalooter~~: use Instaloader
~~Sublist3r~~: use Amass
~~Photon~~: use Katana or GoSpider
~~youtube-dl~~: replaced by yt-dlp
~~Moriarty-Project~~: use PhoneInfoga
~~Elasticsearch-Crawler~~: use Shodan CLI
~~Atom Editor~~ (discontinued December 2022): replaced by VSCodium

General Tools

Tool	Status
VLC	Active
Google Earth Pro	Active
VSCodium	Active (replaces Atom)
CherryTree	Active
KeePassXC	Active
Kazam	Active
Audacity	Active
Tor Browser	Active
OpenShot	Active
Obsidian	Active (latest version fetched dynamically)
Ripgrep	Active
Threat Intelligence Resources	Active

Installation

Open a terminal.
Install Git if it is not already present:
```
sudo apt install -y git
```

Clone the repository into the Downloads directory:

git clone https://github.com/SOsintOps/Argos ~/Downloads/Argos

Make the script executable:
```
chmod +x ~/Downloads/Argos/setup.sh
```
Run the script:
```
~/Downloads/Argos/setup.sh
```
Firefox does not need to be closed or opened manually. The script initialises the Firefox profile automatically if it has not been created yet.

Installation Log

The script automatically generates a log file in the Downloads directory:

~/Downloads/argos_install_YYYYMMDD_HHMMSS.log

The log contains the full installation output with timestamps. If an error occurs, the exact line number is recorded in the log.

To Do

Add PhoneInfoga as a replacement for Moriarty-Project
Add Katana or GoSpider as a replacement for Photon
Update LibreOffice report templates for OSINT investigations
Complete end-to-end testing on Ubuntu Budgie 24.04 LTS VM
Add shortcuts for holehe, maigret standalone, and blackbird standalone

Argos

ARGOS — Beta

Contents