-
-# How to contribute to Sherlock
-
-We would love to have you help us with the development of Sherlock. Each and every contribution is greatly valued!
-
-Here are some things we would appreciate your help on:
-1. [Adding targets](#adding-targets)
-1. [Cleaning up existing targets](#removing-targets)
-1. [Restoring previously removed targets](#restoring-targets)
-
-## Adding targets
-
-Please look at the Wiki entry on [adding new sites][wiki_new_sites] to understand the issues.
-
-All new sites that are added to Sherlock need to have an existing (already claimed) username included in their definition. The linked Wiki page describes this in more detail. This inclusion allows us to run unit tests and prevent regression.
-
-Contributors are *required* to test any new sites for both false positives and false negatives. Contributors are *encouraged* to run unit tests as well.
-
-Contributors do not have to run the [site_list.py](/site_list.py) script, as it's ran automagically on master after each manifest change.
-
-## Removing targets
-
-If there are performance problems with a site (e.g. slow to respond, unreliable uptime, ...), then
-the site may be removed from the list. The [removed_sites.md][file_removed_md] file contains sites that were included at one time in Sherlock, but had to be removed for one reason or another.
-
-If a site has *occasional* performance problems, but is otherwise accurate, it may be preferable to add a test to weed out false positives rather than removing it.
-
-## Restoring targets
-
-Likely our biggest backlog. If you can propose a functional query that complies with [#Adding targets](#adding-targets) that would shrink our [removed sites list][file_removed_md], that would be greatly appreciated.
-
-## Adding New Functionality
-
-Contributors that would like to add a feature to Sherlock should open an new [issue][issues_new], proposing their idea. Indicate that you would like to make a Pull Request for said feature.
-
-Creating an Issue prior to opening a PR helps with tracking, discussions, and avoids hurt feelings if for whatever reason we don't feel that a feature is compatible with the project.
-
-Please ensure that the content on your branch passes all tests before submitting a pull request.
-
-# Coverage and Unit Tests
-
-Thank you for contributing to Sherlock!
-
-Before creating a pull request with new development, please run the tests
-to ensure that everything is working great. It would also be a good idea to run the tests
-before starting development to distinguish problems between your
-environment and the Sherlock software.
-
-The following is an example of the command line to run all the tests for
-Sherlock. This invocation hides the progress text that Sherlock normally
-outputs, and instead shows the verbose output of the tests.
-
-```console
-# Assumes current working directory is respository root
-$ python3 -m unittest tests.all --verbose
-```
-
-Unfortunately, some of the sites that Sherlock checks are not always reliable, so it is common
-to get response problems. Any problems in connection will show up as warnings in the tests instead of true errors.
-
-If some sites are failing due to connection problems (site is down, in maintenance, etc) you can exclude them from tests by creating a `tests/.excluded_sites` file with a list of sites to ignore (one site name per line).
-
-## Coverage for new features
-
-Contributors that add new features are *encouraged* make an attempt at creating unit tests for them, as well. Not all contributions are suitable for unit tests, but when it's doable, it helps prevent regression.
-
-
-
-[wiki_new_sites]: https://github.com/sherlock-project/sherlock/wiki/Adding-Sites-To-Sherlock
-[file_removed_md]: /removed_sites.md
-[issues_new]: https://github.com/sherlock-project/sherlock/issues/new/choose
\ No newline at end of file
diff --git a/docs/INSTALL.md b/docs/INSTALL.md
deleted file mode 100644
index 2bab798c9..000000000
--- a/docs/INSTALL.md
+++ /dev/null
@@ -1,115 +0,0 @@
-
-
-```bash
-# pipx is recommended, but pip may suffice if pipx is unavailable
-pipx install sherlock-project
-```
-
-### Build live package from source (useful for contributors)
-
-> [!Note]
-> With the switch to Poetry, Sherlock no longer requires a `requirements.txt` file. Dependencies are now specified within the `pyproject.toml` file.
->
-> If the legacy `requirements.txt` file is still desired, it can be dynamically generated:
-> ```bash
-> # Append `--with dev` or `--only dev` to include dev dependencies
-> poetry export --without-hashes -f requirements.txt --output requirements.txt
-> ```
-
-Building an editable (or live) package links the entry point to your current directory, rather than to the standard install location. This is often useful when working with the code base, as changes are reflected immediately without reinstallation.
-
-Note that the version number will be 0.0.0 for pipx local builds unless manually changed in the pyproject file (it will prompt the user for an update).
-
-```bash
-# Assumes repository cloned, and current working directory is repository root
-pipx install -e .
-```
-
-### Run package from source (without installing)
-
-If you'd rather not install directly to your system, you can import the module at runtime with `-m`.
-
-```bash
-# Assumes repository cloned, and current working directory is repository root
-python3 -m sherlock user123 user789
-```
-
-
-Docker
-
-
-
-> [!NOTE]
-> Sherlock doesn't yet have context detection. It's recommended that Docker containers be ran with option `-o /opt/sherlock/results/{user123}.txt` (replace {user123}) when an output file is desired at the mounted volume (as seen in the compose).
->
-> This has no effect on stdout, which functions as expected out of the box.
-
-```bash
-# One-off searches
-docker run --rm -t sherlock/sherlock user123
-
-# If you need to save the output file... (modify as needed)
-# Output file will land in ${pwd}/results
-docker run --rm -t -v "$PWD/results:/opt/sherlock/results" sherlock/sherlock -o /opt/sherlock/results/text.txt user123
-```
-
-```bash
-# At any time, you may update the image via this command
-docker pull sherlock/sherlock
-```
-
-### Using compose
-
-```yml
-version: "3"
-services:
- sherlock:
- container_name: sherlock
- image: sherlock/sherlock
- volumes:
- - ./sherlock/:/opt/sherlock/results/
-```
-
-```bash
-docker compose run sherlock user123
-```
-
-### Build image from source (useful for contributors)
-
-```bash
-# Assumes ${pwd} is repository root
-docker build -t sherlock .
-docker run --rm -t sherlock user123
-```
diff --git a/docs/README.md b/docs/README.md
index 27b12b3d3..8cf352be1 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -2,18 +2,16 @@
- Hunt down social media accounts by username across 400+ social networks
+ Hunt down social media accounts by username across 400+ social networks
@@ -24,8 +22,6 @@
## Installation
-[![PyPI - Version](https://img.shields.io/pypi/v/sherlock-project?logo=PyPi&label=PyPI&color=darkgreen)][ext_pypi] [![Docker Image Version](https://img.shields.io/docker/v/sherlock/sherlock?sort=semver&logo=docker&label=Docker&color=darkgreen)][docs_docker] [![homebrew version](https://img.shields.io/homebrew/v/sherlock?logo=Homebrew&color=darkgreen)][ext_brew]
-
| | Command | Notes |
| - | - | - |
@@ -35,17 +31,21 @@
| BlackArch | `pacman -S sherlock` | |
| Homebrew | `brew install sherlock` | |
-PyPI and DockerHub images are mainaintenced by the Sherlock Project. Others are community supported.
-
-### Alternative guides and methods
+See all alternative installation methods [here](https://sherlockproject.xyz/installation)
-- [See all alternative guides][docs_install]
-- [Python package][docs_py]
-- [Docker container][docs_docker]
+## Usage
+To search for only one user:
+```bash
+sherlock user123
+```
+To search for more than one user:
+```bash
+sherlock user1 user2 user3
+```
-## Usage
+Accounts found will be stored in an individual text file with the corresponding username (e.g ```user123.txt```).
```console
$ sherlock --help
@@ -96,31 +96,13 @@ optional arguments:
--nsfw Include checking of NSFW sites from default list.
```
-To search for only one user:
-```bash
-sherlock user123
-```
-
-To search for more than one user:
-```bash
-sherlock user1 user2 user3
-```
+## Credits
-Accounts found will be stored in an individual text file with the corresponding username (e.g ```user123.txt```).
-
-
-## How to contribute to Sherlock
-
-We would love to have you help us with the development of Sherlock. Each and every contribution is greatly valued!
+Thank you to everyone who has contributed to Sherlock! ❤️
-Here are some things we would appreciate your help on:
-- [Adding targets][docs_contrib_adding_targets]
-- [Cleaning up existing targets][docs_contrib_removing_targets]
-- [Restoring previously removed targets][docs_contrib_restoring_targets]
-
-Head over to our __[Contributing][docs_contrib]__ page for additional info.
-
-## Star History
+
+
+
@@ -135,12 +117,5 @@ Original Creator - [Siddharth Dushantha](https://github.com/sdushantha)
-[docs_install]: /docs/INSTALL.md
-[docs_docker]: /docs/INSTALL.md#docker
-[docs_py]: /docs/INSTALL.md#python
-[docs_contrib]: /docs/CONTRIBUTING.md
-[docs_contrib_adding_targets]: /docs/CONTRIBUTING.md#adding-targets
-[docs_contrib_removing_targets]: /docs/CONTRIBUTING.md#removing-targets
-[docs_contrib_restoring_targets]: /docs/CONTRIBUTING.md#restoring-targets
[ext_pypi]: https://pypi.org/project/sherlock-project/
[ext_brew]: https://formulae.brew.sh/formula/sherlock
diff --git a/docs/images/preview.png b/docs/images/preview.png
index 4df7c25e4e8cb6b603232ff596b839dec4f6e2b4..8aacea8f79ba760a3b37a2d1c22006cee6f24f01 100644
GIT binary patch
literal 450930
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