🅳4🆅1🅳

❓ About

A social-media social-engineering tool. While originally inspired by one of my friends' Instagram activities, starting from version v4, which was actually never fully releaed, the idea was for it to be a sort of swiss army knife for multiple social-media platforms.

After over a year of not working on this project, I've decided to come back to it and start developing v5 - maybe even with some extra help.

For more info on how d4v1d works, how to extend it and how to use it, take a look at the docs.

❗ Note: This project is still in development, which is why it is not impossible for there to be bugs or other unwanted behaviour. If you find any, please report them in the issues section. Of course you can also decide to contribute and start working on your own fix.

👷 Setup

To run the older, but last complete version, v2, checkout the legacy branch of this repository. It has its own README.md with all necessary setup steps.

At the moment, since d4v1d is still under active development, just clone the repo and run the following command ...

pip install .

... this will make d4v1d available as a command in your terminal, if you have ~/.local/bin (at least on Linux) in your path, as this is where pip will put the script per default. In the future, as soon as the first release is available, you will be able to simply install d4v1d from PyPI or from releases.

🎮 Usage

Simply run the main script (d4v1d.py) to enter d4v1d's terminal-like environment:

python3 -m d4v1d

To learn more about the commands and features you can use from here, take a look at USAGE.md.

🏗️ Structure

The idea is to structure d4v1d as flexibly as possible, making it easy to exchange and add new components such as database connections, social-media platforms, etc. More about the structure of platforms can be found in PLATFORMS.md.

🛣️ Roadmap

Below is a list of things that I'm planning on incorporating / hoping to incorporate into this project. It'll probably change & grow over time. Feel free to add more ideas if you feel like it.

Instagram

Completion

- [ ] Data Collection - [x] Profile Overview - [ ] Posts - [x] Media - [ ] Comments - [ ] Followers / Following - [ ] Stories - [ ] DB Controllers - [x] SQLite - [ ] MySQL - [ ] Postgres

TikTok

Completion

- [ ] Data Collection - [ ] Profile Overview - [ ] Posts - [ ] Media - [ ] Comments - [ ] Followers / Following - [ ] DB Controllers - [ ] SQLite - [ ] MySQL - [ ] Postgres