gdscsmit / fsociety

Kickstart your Ethical Hacking Journey with Fsociety by GDSC-SMIT :zap: :star:Star the Repository and Open your First PR :rocket:

Fsociety

Note : This Repository is under Hacktoberfest 2023

STAR⭐ The Repository, Open First PULL REQUEST & Get it Merged! 🎉

🗣 Hacktoberfest encourages participation in the open source community, which grows bigger every year. Complete the challenge and earn a limited edition rewards!🚀

📢 Register here for Hacktoberfest and make four pull requests (PRs) between October 1st-31st to get awesome rewards! 🔥.

Overview

Welcome to fsociety, an all-in-one ethical hacking toolkit. This toolkit is designed to provide a comprehensive suite of tools for ethical hackers, security researchers, and cybersecurity enthusiasts.

As Seen in Mr. Robot

Our toolkit has been inspired by the critically acclaimed TV series, Mr. Robot. The protagonist, Elliot Alderson, a cybersecurity engineer and vigilante hacker, uses a similar tool to bring down the conglomerate, Evil Corp.

By using fsociety, you're following in the footsteps of Elliot, using the same caliber of tools that he used in his crusade against corporate corruption.

Read before proceeding - We strictly forbid the use of this tool for illegal activities. To be used strictly for research purposes.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

• Python 3.x
• Arch or Debian based Linux distro

Installation

Follow these steps to get fsociety running on your machine:

1. Clone the repository:

   git clone https://github.com/username/fsociety.git

2. Navigate to the fsociety directory:

   cd fsociety

3. Install the required Python packages:

   pip install -r requirements.txt

Usage

To run fsociety, use the following command:

python -m fsociety3

This will start the fsociety toolkit and you can begin your ethical hacking journey!

Remember, with great power comes great responsibility. Use fsociety wisely! 😊

Guidelines for Contributions

• Ensure that your component is well-documented and follows best practices.
• Use meaningful names for your components and keep the codebase clean and organized.
• Write clear and concise commit messages.
• Be kind and respectful to other contributors.

For more details read CONTRIBUTING GUIDELINES

Code of Conduct

Please review our CODE OF CONDUCT before contributing.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Thank you for your interest in the GDSC Official Website! If you have any questions or suggestions, feel free to reach out to us. Happy coding! 😄

Let's make Hacktoberfest 2023 amazing together! Happy coding! 🎉

Our Valuable Contributors of Hacktoberfest 2023

fsociety's Issues

Prevent cluttering of the main file

Tasks to be done

• Add a rule in CONTRIBUTING.md to avoid polluting the main file
• Move all the respective features into their own separate functions in the scripts folder

Make the script run in a loop

Tasks to be done

• Run the script in a loop so that it does not terminate after a single feature

Improve the Android Tools

Tasks to be done

• Add new features to the Android section of the script
• Try to incorporate simple ADB based features

Add simple Unix based commands under Miscallaneous section

Tasks to be done

• Create a Miscallaneous section in the script
• Add basic Unix commands like grep, curl, mv, cp (and more)
• Try to create all those features as their respective functions in the scripts directory instead of polluting the main file

Module doesn't run in superuser

Description

If the script is started as superuser, it crashes instantly without moving in to the main menu.

Expected Behavior

Should display the main menu

Steps to reproduce

cd fsociety && sudo python -m fsociety3

Logs attached

traceback (most recent call last):
File "", line 198, in _run_module_as_main
File "", line 88, in _run_code
File "/home/madhurjya/Documents/fsociety/fsociety3/main.py", line 81, in
main()
File "/home/madhurjya/Documents/fsociety/fsociety3/main.py", line 77, in main
import main as fsociety_main
ModuleNotFoundError: No module named 'main'

Create Greetings Workflow Configuration File.

Color format the Fsociety ASCII logo (using colorama)

Tasks to be done

• Colorize the Fsociety logo using colorama (or any other library)
• Randomly keep changing the color scheme

Note - If any other module is used, its name should be mentioned in the requirements.txt file