▄▄▄   ▄▄▄              ▄▄▄▄▄▄▄ ▄▄▄▄▄ ▄▄▄    ▄▄▄ ▄▄▄▄▄▄▄▄▄  
███   ███             █████▀▀▀  ███  ████▄  ███ ▀▀▀███▀▀▀  
▀███▄███▀ ▄███▄ ██ ██  ▀████▄   ███  ███▀██▄███    ███     
  ▀███▀   ██ ██ ██ ██    ▀████  ███  ███  ▀████    ███     
    ███    ▀███▀ ▀██▀█ ███████▀ ▄███▄ ███    ███    ███      

YouTube OSINT Intelligence Extractor | v1.0.0
Author: Omar Izquierdo | Repo: https://github.com/OmarIzquierdo/YouSINT 

YouSINT is a Python CLI tool that leverages Google Gemini AI to automate OSINT extraction from YouTube. It analyzes video content to generate structured reports on locations, technologies, associates, and other critical data points.

Disclaimer

⚠️ LEGAL NOTICE This software is provided for educational and authorized security research purposes only. By using YouSINT, you acknowledge and agree that: You will not use this tool for stalking, harassment, or any illegal activities You are solely responsible for ensuring compliance with all applicable laws You will respect YouTube's Terms of Service and privacy regulations The author assumes no liability for any misuse or damages caused by this tool AI-generated results may contain inaccuracies and should be verified independently The author (Omar Izquierdo) expressly disclaims all responsibility for unauthorized or malicious use.

Installation

Prerequisites: Python 3.10+ and a Gemini API Key

# Clone the repository
git clone https://github.com/OmarIzquierdo/YouSINT

# Navigate to directory
cd YouSINT

# Install dependencies
pip install -r requirements.txt

Demo

YouSINT-DEMO.mp4

Usage

python main.py analyze -t "GEMINI_API_KEY" -yi "VIDEO_ID"

Quick Examples

# Analyze single video
python main.py analyze -t "AIzaSy..." -yi "dQw4w9WgXcQ"

# Analyze multiple videos in Spanish
python main.py analyze -t "AIzaSy..." -yi "VIDEO1,VIDEO2,VIDEO3" -l es

# Load IDs from file and export to JSON
python main.py analyze -t "AIzaSy..." -yf targets.txt -o report.json -f json

# Use cookies for age-restricted content
python main.py analyze -t "AIzaSy..." -yi "VIDEO_ID" --cookies cookies.txt

# Using environment variable
export GEMINI_API_KEY="AIzaSy..."
python main.py analyze -yi "VIDEO_ID"

Parameters

Parameter	Short	Default	Description
--gemini-api-token	-t	—	Gemini API key (or GEMINI_API_KEY env)
--youtube-ids	-yi	—	Comma-separated YouTube video IDs
--youtube-file-ids	-yf	—	Path to file containing video IDs
--language	-l	en	Subtitle language code
--output-file	-o	—	Output file path
--output-format	-f	json	Export format: json · md · txt
--cookies	—	—	Netscape cookies file for authentication

Supported Languages

Code	Language	Code	Language	Code	Language	Code	Language
en	English	es	Spanish	fr	French	de	German
pt	Portuguese	it	Italian	ru	Russian	ja	Japanese
ko	Korean	zh	Chinese	ar	Arabic	hi	Hindi

Output

YouSINT extracts and categorizes intelligence data into the following categories:

Category	Description
Technologies	Software, hardware, programming languages, tools
Locations	Cities, countries, places, timezones with confidence level
Medical	Health conditions, treatments, physical attributes
Devices	Phones, computers, vehicles, equipment
Environment	Home layout, workspace, background details
Associates	Friends, colleagues, pets, connections
Family	Parents, siblings, partners, children
Other	Schedules, habits, events, dates

Export Formats

Format	Extension	Description
JSON	.json	Structured data for programmatic use
Markdown	.md	Formatted report with tables
Plain Text	.txt	Simple text output