{"id":51173304,"url":"https://github.com/sayfalse/mint","last_synced_at":"2026-06-27T02:03:32.782Z","repository":{"id":367535193,"uuid":"1280641540","full_name":"sayfalse/mint","owner":"sayfalse","description":"MINT is an interactive terminal command center unifying Sherlock, Holehe, SpiderFoot, Toutatis, and a powerful social media downloader.","archived":false,"fork":false,"pushed_at":"2026-06-26T12:13:10.000Z","size":21,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-26T12:17:57.537Z","etag":null,"topics":["command-center","facebook-downloader","holehe","instagram-downloader","media-downloader","osint","sherlock","spiderfoot","tiktok-downloader","toutatis","twitter-downloader"],"latest_commit_sha":null,"homepage":"https://github.com/sayfalse/mint","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sayfalse.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-25T19:43:00.000Z","updated_at":"2026-06-26T12:13:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sayfalse/mint","commit_stats":null,"previous_names":["sayfalse/mint"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/sayfalse/mint","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sayfalse%2Fmint","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sayfalse%2Fmint/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sayfalse%2Fmint/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sayfalse%2Fmint/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sayfalse","download_url":"https://codeload.github.com/sayfalse/mint/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sayfalse%2Fmint/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34839009,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-27T02:00:06.362Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["command-center","facebook-downloader","holehe","instagram-downloader","media-downloader","osint","sherlock","spiderfoot","tiktok-downloader","toutatis","twitter-downloader"],"created_at":"2026-06-27T02:03:31.474Z","updated_at":"2026-06-27T02:03:32.773Z","avatar_url":"https://github.com/sayfalse.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"logo.png\" alt=\"MINT Logo\" width=\"400\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eMINT — The Unified OSINT \u0026 Media Command Center\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://pypi.org/project/mint-osint/\"\u003e\u003cimg src=\"https://img.shields.io/pypi/v/mint-osint?color=7fd88f\u0026logo=pypi\u0026logoColor=white\" alt=\"PyPI Version\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/sayfalse/mint/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/sayfalse/mint?color=7fd88f\" alt=\"License\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux%20%7C%20Android%20(Termux)-7fd88f\" alt=\"Platform\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eMINT\u003c/strong\u003e is an interactive, terminal-based command center that unifies industry-standard OSINT (Open Source Intelligence) tools and a robust media archiver into a single, cohesive interface. Built for researchers, security analysts, and developers, MINT simplifies target intelligence gathering, social media investigation, and media preservation under a clean, keyboard-driven environment.\n\u003c/p\u003e\n\n---\n\n## 📖 Table of Contents\n- [✨ Key Features](#-key-features)\n- [🛠️ Integrated Tools Deep-Dive](#️-integrated-tools-deep-dive)\n- [📦 Installation \u0026 Package Managers](#-installation--package-managers)\n  - [⚡ Quick One-Line Bootstrapper](#-quick-one-line-bootstrapper)\n  - [🗂️ Package Managers](#️-package-managers)\n  - [💻 Manual Installation](#-manual-installation)\n- [💾 Smart Path-Resolution Installer](#-smart-path-resolution-installer)\n- [🍪 Cookie Configuration for Media Downloader](#-cookie-configuration-for-media-downloader)\n- [🚀 How to Run \u0026 Hotkeys](#-how-to-run--hotkeys)\n- [⚙️ Configuration File (`config.json`)](#️-configuration-file-configjson)\n- [🔧 Troubleshooting \u0026 Console Setup](#-troubleshooting--console-setup)\n\n---\n\n## ✨ Key Features\n\n* **Unified Workspace:** No more managing multiple terminal windows or repository paths. Run audits, scans, and downloaders from a single TUI.\n* **Smart Path-Resolution:** Automatically structures your target directory, keeping your system root and drives completely free of clutter.\n* **Auto-Dependency Management:** Checks for system prerequisites, builds virtual environment paths, and handles installation automatically.\n* **Integrated Update Manager:** Updates all sub-tools from their official GitHub repositories with a single click.\n* **Cross-Platform:** Works seamlessly on Windows, macOS, Linux, and Android (via Termux).\n\n---\n\n## 🛠️ Integrated Tools Deep-Dive\n\nMINT aggregates and configures the following industry-standard engines:\n\n| Tool / Engine | Purpose | Capabilities | Source |\n| :--- | :--- | :--- | :--- |\n| **Sherlock** | Username Intelligence | Scans 300+ social platforms simultaneously to locate accounts. | [sherlock-project/sherlock](https://github.com/sherlock-project/sherlock) |\n| **Holehe** | Email Reconnaissance | Checks registration status on 120+ sites via password recovery endpoints without alerting the target. | [megadose/holehe](https://github.com/megadose/holehe) |\n| **SpiderFoot** | OSINT Automation | Launches a local web server for advanced audits, domain recon, and threat intelligence. | [smicallef/spiderfoot](https://github.com/smicallef/spiderfoot) |\n| **Toutatis** | Instagram Metadata | Extracts associated public emails, phone numbers, and profile details. | [megadose/toutatis](https://github.com/megadose/toutatis) |\n| **MINT Social Tool** | Media Archiving | High-speed, interactive backup engine for Instagram, TikTok, Facebook, and X (Twitter). Powered by `gallery-dl` \u0026 `yt-dlp`. | *Built-in* |\n\n---\n\n## 📦 Installation \u0026 Package Managers\n\n### ⚡ Quick One-Line Bootstrapper\nFor **macOS**, **Linux**, and **Android (Termux)**, you can install and configure MINT instantly with a single command:\n```bash\ncurl -fsSL https://raw.githubusercontent.com/sayfalse/mint/main/setup.sh | bash\n```\n\n### 🗂️ Package Managers\nInstall MINT globally on your system using your favorite package manager:\n\n```bash\n# Python Pip (Cross-Platform)\npip install mint-osint\n\n# Scoop (Windows)\nscoop bucket add sayfalse https://github.com/sayfalse/scoop-bucket.git\nscoop install mint\n\n# Homebrew (macOS \u0026 Linux)\nbrew tap sayfalse/tap\nbrew install mint\n\n# Nix (Cross-Platform / Reproducible)\nnix run github:sayfalse/mint\n```\n\n### 💻 Manual Installation\n\n#### Windows\n1. Clone the repository and navigate to it:\n   ```cmd\n   git clone https://github.com/sayfalse/mint.git\n   cd mint\n   ```\n2. Run the interactive batch installer:\n   ```cmd\n   setup.bat\n   ```\n\n#### macOS / Linux / Android (Termux)\n1. Clone the repository and navigate to it:\n   ```bash\n   git clone https://github.com/sayfalse/mint.git\n   cd mint\n   ```\n2. Run the installer script:\n   ```bash\n   python installer.py\n   ```\n\n---\n\n## 💾 Smart Path-Resolution Installer\n\nTo protect your directories, the installer prompts you once for a parent directory (e.g., `E:\\mint` or `~/mint`) and automatically constructs a clean, isolated structure:\n* **`MINT_Tools/`** — Clones and maintains all official external OSINT repositories.\n* **`mint-social/`** — Houses all downloaded media, profile lists, and configuration templates.\n* **`mint-social/cookies/`** — Pre-generates templates for cookie bypass files.\n* **Global Command Wrapper** — Automatically registers `mint` to your system path, allowing global execution.\n\n---\n\n## 🍪 Cookie Configuration for Media Downloader\n\nTo download content from private profiles or bypass rate limits, the media downloader utilizes session cookies. The installer automatically generates 4 empty template cookie files in:\n`\u003cparent_folder\u003e/mint-social/cookies/`\n\n### How to use:\n1. Install a browser extension like **Get cookies.txt LOCALLY** (Chrome/Firefox).\n2. Log into the target social network (e.g., Instagram) in your browser.\n3. Export the cookies in **Netscape format** using the extension.\n4. Paste the contents into the corresponding file (e.g., `instagram.com_cookies.txt`) and save.\n\n---\n\n## 🚀 How to Run \u0026 Hotkeys\n\nOnce the installation is complete, open a **new terminal window** and type:\n```bash\nmint\n```\n\n### Navigation \u0026 Shortcuts\n* **`↑ / ↓` Arrow Keys** — Navigate the main menu.\n* **`Enter`** — Launch the selected tool.\n* **`1 - 5` Keys** — Direct jump to launch a specific tool.\n* **`6` Key** — Launch the One-Click Update Manager.\n* **`7` or `Ctrl+C`** — Exit the command center.\n\n---\n\n## ⚙️ Configuration File (`config.json`)\n\nThe installer generates a `config.json` file in the MINT root directory to map all system paths dynamically. You can edit this file manually if you move directories:\n```json\n{\n    \"tools_dir\": \"E:\\\\mint\\\\MINT_Tools\",\n    \"social_dir\": \"E:\\\\mint\\\\mint-social\",\n    \"mint_dir\": \"E:\\\\mint\",\n    \"mint_py_path\": \"E:\\\\mint\\\\mint.py\",\n    \"sherlock_path\": \"E:\\\\mint\\\\MINT_Tools\\\\sherlock\",\n    \"holehe_path\": \"E:\\\\mint\\\\MINT_Tools\\\\holehe\",\n    \"spiderfoot_path\": \"E:\\\\mint\\\\MINT_Tools\\\\spiderfoot\",\n    \"toutatis_path\": \"E:\\\\mint\\\\MINT_Tools\\\\toutatis\"\n}\n```\n\n---\n\n## 🔧 Troubleshooting \u0026 Console Setup\n\n* **Unicode Display Issues (Windows):** If box-drawing lines appear distorted in your Windows console, MINT automatically forces UTF-8 encoding on startup. If issues persist, run this command in your terminal before launching MINT:\n  ```cmd\n  chcp 65001\n  ```\n* **Git Credential Conflicts:** If the update manager fails to pull updates due to local credential conflicts, MINT automatically falls back to downloading official zip archives, extracting them cleanly without interrupting your session.\n* **Android Termux Issues:** Ensure you run `termux-setup-storage` before starting downloads so that MINT has write permissions to save files to your phone's storage.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsayfalse%2Fmint","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsayfalse%2Fmint","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsayfalse%2Fmint/lists"}