GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — GitHub - SOsintOps/Argos: Turns a clean Ubuntu Budgie 24.04 or 26.04 VM into an OSINT workstation: 20+ tools, one menu entry per task, case folders with logged commands and SHA-256 hashes.

BranchesTags
Open more actions menu

Latest commit

 

History

347 Commits
347 Commits

Folders and files

NameName
Last commit message
Last commit date
.github/workflows
.github/workflows
 
 
config
config
 
 
desktop
desktop
 
 
docs
docs
 
 
launchers
launchers
 
 
multimedia
multimedia
 
 
templates
templates
 
 
tests
tests
 
 
.gitattributes
.gitattributes
 
 
.gitignore
.gitignore
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
setup.sh
setup.sh
 
 

Repository files navigation

ARGOS

Argos mascot

Checks License: MIT Ubuntu Budgie 24.04 | 26.04 LTS

Argos turns a clean Ubuntu Budgie 24.04 or 26.04 LTS virtual machine into an OSINT workstation: it installs the tools, adds a menu entry for each task, and saves every result in a case folder with the command used, the full output and SHA-256 hashes.

3.3.1-beta. Version 3 is a complete rewrite. The full installation of 3.0.0-beta has been tested on virtual machines with Ubuntu Budgie 24.04.5 and 26.04.1 LTS, and the launchers are covered by automated tests, real dialogs included. 3.1.0-beta added two case graphs, Quaesitor and Flowsint, still to be tested on a virtual machine. 3.1.2-beta aligned the analysis guidelines and the report templates with the Intelligence Field Notes (UNODC 4 x 4 source grading, one ICD 203 likelihood row); 3.1.3-beta adds key judgements, gaps and annexes to the report templates, separate from the findings. 3.2.0-beta adds ONLYOFFICE Desktop Editors to open and fill the .docx report templates; 3.2.1-beta revises the Firefox extensions and 3.2.2-beta fixes the Firefox privacy policy; 3.2.3-beta adds Consensus, one search over the lookup catalogues of 19 username and email projects, and 3.2.4-beta saves its scan as JSON with the HTML report derived from it, with an optional Tor route. 3.3.0-beta adds EditSimple, a video editor that turns footage into evidence (tracking, zoom, pixelation, slides); 3.3.1-beta installs it from a fork with the Linux fixes, tested on Ubuntu 24.04 in a virtual machine. Field testing on Ubuntu Budgie 24.04 and 26.04 LTS desktops continues before the stable release: please report problems in the issues.


Contents

  • What Argos does
  • Requirements
  • Installation
  • Working with cases
  • Launchers
  • Other tools installed
  • Privacy and OPSEC
  • Report templates
  • Development and tests
  • Resources · Credits · Licence
  • Architecture · FAQ · Analysis guidelines · Writing the report · Intelligence Field Notes · Version history

What Argos does

  • One menu entry per investigative task: usernames and emails, Instagram, domains and URLs, web screenshots, public documents and metadata, video download and analysis, Shodan, SpiderFoot, phone numbers, recon-ng, website copies and crawls, two case graphs in the browser (Quaesitor and Flowsint) and a video editor to present what a video shows (EditSimple).
  • Cases: choose a case once, and every result lands in ~/Documents/Argos/cases/<case>/.
  • Evidence you can defend: each run folder holds command.txt (exact command, tool version, UTC start/end, exit code), output.log (everything the tool printed) and SHA256SUMS (hash of every file produced).
  • Up-to-date tools: Amass v5, theHarvester 5, subfinder, katana, gau, current Maigret with PDF reports, yt-dlp with deno for YouTube, SpiderFoot from source, Shodan CLI that actually starts, binaries downloaded from the official releases with their checksums verified.
  • Same result on 24.04 and 26.04: the Python tools run in environments managed by uv on a fixed, tested Python version, whatever Python the system ships.
  • Works on the desktop and in a terminal: dialogs on the desktop, plain prompts over SSH; a running tool can be cancelled from its progress window.

Requirements

  • Ubuntu Budgie 24.04 LTS or 26.04 LTS, preferably a dedicated virtual machine for each investigation.
  • A user with sudo rights (do not run the installer as root).
  • System language: English. Argos uses the standard English folder names (~/Documents, ~/Downloads, ~/Pictures, ~/Templates).
  • Internet access during the installation.
  • VirtualBox users: install the Guest Additions first; Argos does not.

Installation

sudo apt install -y git
git clone https://github.com/SOsintOps/Argos.git
cd Argos
./setup.sh

The installer can be run from any folder. It logs everything to ~/Downloads/argos_install_<date>.log, carries on when a single tool fails, and lists all problems in a summary at the end. Reboot when it finishes.

The menu entries are under Internet in the application menu; you can also search them by name (for example "Argos Case" or "Usernames"). Open Argos Check first: it starts every tool and reports anything that is missing or broken.

Each launcher can also be started from a terminal, where it asks its questions as text:

~/.local/share/argos/launchers/usernames.sh

Run only some steps, for example to update the launchers after a git pull:

./setup.sh --list          # show the steps
./setup.sh launchers       # reinstall launchers, icons and menu entries
./setup.sh python-tools amass theharvester   # update those tools

Working with cases

  1. Open Argos Case and create a case (for example 2026-017-fraud). The case folder starts with notes/ (research log and CherryTree notebook), reports/, manual-captures/ and deliverables/.
  2. Use any launcher: results go to ~/Documents/Argos/cases/2026-017-fraud/<tool>/<UTC time>_<target>/.
  3. Quote the run folder and the SHA-256 in your report's source table.

Without a case, results go to the case unsorted.

Launchers

Menu entry Tools What it adds
Argos Case — create, switch and open cases
Usernames & Emails Sherlock, Maigret, Blackbird, User Scanner, Linkook, Socialscan, Consensus report formats, scope, email search, start from a profile URL, all tools in one go
Instagram Instaloader, Toutatis posts, reels, tagged posts; stories, highlights, comments and geotags with your Firefox session
Domains theHarvester 5, subfinder, Amass v5, gau free sources by default; passive subdomains without keys; brute force, altered names, optional active checks; known URLs from Wayback Machine, Common Crawl, OTX, urlscan
Web Screenshots EyeWitness one URL, a URL list, or the web services of an Nmap/Nessus XML report
Documents & Metadata metagoofil, ExifTool document types, metadata CSV, names and software found in the documents; also for a folder you already have
Video Download yt-dlp (with deno) video, audio or metadata only; description, thumbnail, subtitles, comments, playlists; your Firefox session when a site asks to sign in
Video Tools ffmpeg, ffprobe, ExifTool technical report, MP4 conversion, frames, motion-only summary, audio, rotation, clip cut, contact sheet
Shodan Shodan CLI search saved as JSON and CSV, host history, domain records, free result counts
SpiderFoot SpiderFoot web interface, or a passive/footprint/investigate scan saved in the case
Phone Numbers libphonenumber, PhoneInfoga, Telegram phone number checker offline analysis (country, original carrier, line type, time zones), PhoneInfoga scan, Telegram account check with your own Telegram account
recon-ng recon-ng console with a workspace named after the case
Website Mirror HTTrack, katana offline copy of a site, or a crawl that lists its pages, links and files
Quaesitor Quaesitor the case as a graph in the browser: people, phones, emails, profiles, vehicles, places, documents; CSV/Excel import, document sources with OCR; archive kept in ~/Documents/Argos/quaesitor, nothing leaves the computer
EditSimple EditSimple video editor to explain a fact or show evidence: cuts, freeze frames, fast or slow motion with a clock, text, boxes and arrows that follow a subject, zoom box, pixelation of faces and plates that follows them, slides, audio tracks, logo; export to MP4 with ffmpeg. Installed from the SOsintOps fork with the Linux fixes: audio preview through pw-cat or aplay, mouse wheel, system fonts, folder buttons
Flowsint Flowsint graph-based investigation platform with enrichers, in Docker containers on this computer; start, open and stop from the launcher
Exploratores Exploratores browser-based OSINT toolkit, also Firefox's home page
X (Twitter) — opens x.com
Argos Check — checks that every tool starts

Tool status

How actively each tool is maintained by its authors (checked October 2026). Every tool works with Argos today; "low" and "unmaintained" tools may break when the services they query change.

Tool Licence Status
Sherlock MIT active
Maigret MIT active
Blackbird not stated low (last change July 2025)
User Scanner MIT active
Linkook MIT active
Socialscan MPL-2.0 low (last release 2023)
Consensus GPL-3.0-or-later active (repository created October 2026)
Instaloader MIT active
Toutatis GPL-3.0 unmaintained (last change 2024)
theHarvester GPL-2.0 active
subfinder MIT active
Amass Apache-2.0 active
gau MIT active
EyeWitness GPL-3.0 low (last change January 2026)
metagoofil GPL-3.0 active
ExifTool Perl/GPL active
yt-dlp Unlicense active
Shodan CLI MIT unmaintained (last change 2024, needs a fix to start)
SpiderFoot MIT low (last release 2022)
libphonenumber Apache-2.0 active
PhoneInfoga GPL-3.0 unmaintained (declared by the author)
Telegram phone number checker MIT active
recon-ng GPL-3.0 active
HTTrack GPL-3.0 active
katana MIT active
Quaesitor (fork of OSInt Graph) GPL-3.0 with attribution terms active
EditSimple GPL-3.0 with attribution terms active (repository created October 2026)
Flowsint Apache-2.0 active

EditSimple is installed from the SOsintOps fork (branch linux, with the Linux fixes proposed to its author) in ~/.local/share/argos/tools/editsimple, where it also keeps its settings (config.json) and its tools/ folder. The installer downloads there the VitTrack tracking model (opencv_zoo, Apache-2.0, checked against its SHA-256) and, when the system ffmpeg is older than 7 (Ubuntu 24.04 ships 6.1), a release build of ffmpeg from BtbN/FFmpeg-Builds, as EditSimple asks for ffmpeg 7 or later.

Flowsint runs in Docker: the installer adds your user to the docker group, active after the reboot, and keeps the generated passwords in ~/.config/argos/flowsint.env (never delete that file: the databases are initialised with them). Its containers mount the Docker socket, as its own docker-compose.prod.yml requires.

Other tools installed

Audacity, CherryTree, Google Earth Pro, Kazam, KeePassXC, MediaInfo, Obsidian (with OSINT templates), ONLYOFFICE Desktop Editors (opens the .docx report templates), OpenShot, ripgrep, Tesseract OCR (with the Italian, Chinese, Russian and Arabic language packs, used by Quaesitor for scanned documents), Docker (for Flowsint), Tor Browser, proxychains, VLC, VSCodium, 7-Zip, and the threat intelligence and intelligence writing reading lists and the Intelligence Field Notes in ~/Documents/Resources. Firefox gets enterprise policies for privacy, OSINT bookmarks and 17 extensions: uBlock Origin, CanvasBlocker, ClearURLs, Multi-Account Containers, Exify, Wayback Machine, Web Archives, Resurrect Pages, Search by Image, Link Gopher, Mitaka, Sputnik, Wappalyzer, IP Address and Domain Information (DNSlytics), Hunter, User-Agent Switcher and Manager and SingleFile. Hunter needs an account and sends the visited domains to its service; Wappalyzer is closed source. Full-page screenshots use the one built into Firefox (Ctrl+Shift+S). The same policy locks strict tracking protection and fingerprinting protection, disables WebRTC, geolocation, telemetry and Safe Browsing and clears the browsing data on shutdown; the FAQ lists every setting and how to change it.

Maltego is not installed (it needs an account); install it manually if you use it.

Privacy and OPSEC

  • Options that send your target to a third-party service (Blackbird AI, Hudson Rock breach lookups, the Telegram check) are off by default and ask for confirmation each time, naming the service.
  • Options that can alert the target (User Scanner "loud" checks, Amass active checks) show a warning first.
  • API keys and session IDs are never written to command.txt; the Telegram login session is kept in ~/.config/argos/telegram, outside the cases.
  • Instaloader uses the session of your Firefox research account: Argos never asks for, or stores, an Instagram password.

Report templates

~/Templates receives report templates written for Argos: full report, executive summary, subject profile, event assessment, threat notice, case cover sheet with chain of custody, online investigations policy, a plain Markdown report, a research log (CSV), scratch notes and a CherryTree case notebook. Their source table links each finding to an Argos run folder and its SHA-256 and grades it on the UNODC 4 x 4 scale; findings state facts only, while the key judgements carry a confidence level or one of the ICD 203 likelihood terms. Which template to use, and how to fill it, is in Writing the report. The .docx files are generated by templates/src/build_templates.py; ONLYOFFICE Desktop Editors, installed by setup.sh, opens them.

Development and tests

shellcheck -x -P launchers -P SCRIPTDIR/../.. setup.sh launchers/*.sh launchers/lib/argos.sh tests/gui/smoke.sh
bats tests/
tests/gui/smoke.sh      # real zenity dialogs on a virtual display

The tests run the launchers in terminal mode against test doubles of every tool: no network, a few seconds. tests/gui/smoke.sh drives the real zenity dialogs on a virtual display (needs xvfb xdotool x11-utils). See docs/ARCHITECTURE.md.

Resources

  • OSINT Ops website
  • The Argos Project: an OSINT-ready VM in minutes
  • Argos is back, and it's not alone!
  • OSINT Daily News
  • Intelligence Field Notes: analytic standards, OSINT method, source evaluation and report writing for all the SOsintOps tools
  • OSINT Techniques (11th edition) by Michael Bazzell and Jason Edison
  • Deep Dive: Exploring the Real-world Value of Open Source Intelligence by Rae L. Baker

Credits

  • Argos started from Skykn0t's OSINT_VM_Setup script and the workstation approach described by Michael Bazzell. Version 3 is a new implementation: its code, launchers, icons and templates were written from scratch.
  • oh6hay for the name.
  • The authors of every tool Argos installs: their licences apply to their tools.
  • Media credits: multimedia/CREDITS.md.

Licence

Argos is released under the MIT licence. Versions up to 2.1.1-beta were distributed under CC BY-NC-SA 4.0 and remain available under that licence in the repository history.

About

Turns a clean Ubuntu Budgie 24.04 or 26.04 VM into an OSINT workstation: 20+ tools, one menu entry per task, case folders with logged commands and SHA-256 hashes.

osintops.com/

Topics

bashfootprintinginfosecintelligence-gatheringinvestigationosintosint-toolsosint-workstationreconnaissancethreatintelubuntuubuntu-budgievirtual-machine

Resources

Readme
MIT license

Security policy

Security policy
Activity

Stars

175 stars

Watchers

3 watching

Forks

26 forks
Report repository

Releases

Packages

Used by

Contributors

Languages

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.