Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updated Project Description & Added Common Installation Issues #2304

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 28 additions & 1 deletion docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<br>
<a href="https://sherlock-project.github.io/" target="_blank"><img src="images/sherlock-logo.png"/></a>
<br>
<span>Hunt down social media accounts by username across <a href="https://sherlockproject.xyz/sites">400+ social networks</a></span>
<span>Sherlock hunts down social media accounts by username across <a href="https://sherlockproject.xyz/sites">400+ social networks.</a> By entering a username, Sherlock searches across popular websites and returns any accounts with matching usernames. It's an essential tool for situations such as personal investigations, security checks, or ensuring your brand’s unique identity across various platforms.</span>
<br>
</p>

Expand Down Expand Up @@ -33,6 +33,33 @@

See all alternative installation methods [here](https://sherlockproject.xyz/installation)

### Common Installation Issues
1. **'pip' command not found**
- **Solution**: Make sure that `pip` is installed with Python. You can install `pip` by following these instructions:
- **On Linux/macOS**:
```bash
sudo apt-get install python3-pip
```
- **On Windows**: Download and install `pip` from the official [pip website](https://pip.pypa.io/en/stable/installation/).

2. **Permission Denied on Linux/macOS**
- **Solution**: You may need to run the installation commands with `sudo` to give administrative privileges. Use the following command:
```bash
sudo pip install sherlock-project
```
3. **Outdated `pip` Version**
- **Solution**: Upgrade `pip` to the latest version using the following command:
```bash
pip install --upgrade pip
```
4. **Outdated Python Version**
- **Solution**: Update Python version using the following command:
```bash
sudo apt-get install python3
```
5. **Firewall or Antivirus Blocking Access**
- **Solution**: Ensure that your firewall or antivirus settings allow Docker and Python installations to proceed without interruption.

## Usage

To search for only one user:
Expand Down