Love Birds

Disclaimer

Warning: This project is developed strictly for educational purposes only. The author does not endorse or support any illegal activities related to the use of this project. Please ensure you have the necessary permissions before using this software to access data.

Overview

"Love Birds" is a Python-based project using FastAPI that allows you to grab the target's location, target device info and take a picture using their front camera just by sending them a link. It serves as a learning tool for understanding web APIs, Python, and networking, cyber awareness.

Features

• Provide information about target device.
• Location of target device.
• Provides continual views of target through font camera.

Getting Started

Prerequisites

Ensure that Python is installed on your system. You can download it from python.org.

Setting Up a Virtual Environment

It is highly recommended to use a virtual environment to manage dependencies. Below are the steps to create and activate a virtual environment for different platforms:

Windows

1. Open Command Prompt or PowerShell.
2. Navigate to your project directory.
3. Run the following commands:

  python -m venv venv
 .\venv\Scripts\activate

Linux and macOS

1. Open your terminal.

2. Navigate to your project directory.

3. Run the following commands:

python3 -m venv venv
source venv/bin/activate

Install Dependencies

Windows

1. After Activateing Virtualenv run the following command

pip install -r requirements.txt

Linux and macOS

1. After Activateing Virtualenv run the following command

pip3 install -r requirements.txt

Start the Application

• To run in localhost (127.0.0.1)

uvicorn main:app 

• To run on your ip to use it in your local network

uvicorn main:app --host 0.0.0.0 --port 8000 

Port Forwarding

Linux

1. Download Cloudflare Tunnel using wget:

wget https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64

2. Grant execution permissions:

chmod +x cloudflared-linux-amd64

3. Run the Cloudflare Tunnel from the Command Prompt:

 ./cloudflared-linux-amd64 tunnel --url http://127.0.0.1:8000

Windows

1. Download the Cloudflare Tunnel executable from the link:
2. Run the Cloudflare Tunnel from the Command Prompt:

cloudflared-windows-amd64.exe tunnel --url http://127.0.0.1:8000

macOS

1. Download Cloudflare Tunnel using curl:

curl -LO https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-darwin-amd64.tgz

2. Extract the tar file::

tar -xvzf cloudflared-darwin-amd64.tgz

3. Move the executable to /usr/local/bin:

sudo mv cloudflared /usr/local/bin

4. Run the Cloudflare Tunnel:

cloudflared tunnel --url http://127.0.0.1:8000

Shareing Link

1. After Executing the command for port Forwarding, you will able to see something like the following image.

2. This field will provide us with a shareable link.

3. After successfully attack all infomation will be stored in a json file call 'data.json'

The Fontend Design is inspried from https://codepen.io/rahul-sahni/pen/eYQbJGG ,Big thanks to Developer Rahul