Skip to main content

​
System Requirements

Before installing BloodCat, ensure your system meets the following requirements:
  • Python: Version 3.6 or higher
  • Operating System: Linux (Ubuntu/Debian recommended), macOS, or Windows with WSL
  • FFmpeg: Required for the camera viewer functionality
  • Internet Connection: Required for FOFA API integration

​
Installation Steps

1

Install System Dependencies

BloodCat requires FFmpeg for streaming and viewing camera feeds. Install it using your package manager:
sudo apt update && sudo apt install ffmpeg
FFmpeg includes both ffmpeg (for encoding/decoding) and ffplay (for viewing streams). BloodCat’s viewer (play.sh) uses ffplay to display camera feeds.
2

Install Python Dependencies

BloodCat requires two Python packages: tqdm for progress bars and requests for API communication.Install them using pip:
pip install tqdm requests
Or if you’re using Python 3 explicitly:
pip3 install tqdm requests
Package Details:
  • tqdm: Provides smart progress bars for credential brute-force operations
  • requests: Handles HTTP requests for FOFA API queries
3

Clone the Repository

Download BloodCat from the official GitHub repository:
git clone https://github.com/MartinxMax/BloodCat.git
cd BloodCat
4

Verify Installation

Verify that BloodCat is installed correctly by running the help command:
python3 bloodcat.py -h
You should see the BloodCat ASCII art logo and the help menu with available options:
Blood Cat - RTSP Camera Weak Credential Scanner

options:
  -h, --help         show this help message and exit
  --country COUNTRY  Country
  --city CITY        City
  --region REGION    Area
  --key KEY          Fofa API key
  --ip IP            IP:PORT
5

Verify Viewer (Optional)

If you plan to view discovered camera streams, verify that the viewer script is executable:
chmod +x play.sh
./play.sh
The viewer script (play.sh) will fail if no cameras have been discovered yet. This is expected behavior. After running a successful scan, camera URLs will be saved to ./data/ipcam.info and can be viewed with this script.

​
Troubleshooting

​
FFmpeg Not Found

If you encounter an error about ffplay not being found when running play.sh, ensure FFmpeg is properly installed: 
which ffplay
If this returns nothing, reinstall FFmpeg using the commands in Step 1.

​
Python Module Not Found

If you see ModuleNotFoundError for tqdm or requests, ensure you installed the dependencies: 
python3 -m pip list | grep -E "tqdm|requests"
If they’re not listed, reinstall them: 
pip3 install tqdm requests

​
Permission Denied

If you encounter permission issues when running scripts: 
chmod +x bloodcat.py play.sh

​
Next Steps

Command Reference

Learn all available command-line options

Examples

See real-world usage examples

Build docs developers (and LLMs) love

Get started for freeTalk to us