1 files changed, 64 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..435057a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,64 @@
+```markdown
+> [!CAUTION]
+> This blocklist includes all Tor exit nodes
+```
+
+### 🟧 Description:
+
+This is an encompassing Blocklist, regarding my philosophical principles.
+
+### 🟧 Installation:
+
+```shell
+git clone git.marlonivo.xyz/hosts
+cd hosts
+make
+```
+
+### 🟦 Lists:
+
+In your `/etc/hosts` are the following lists that you can individually search for:
+
+1. **Personal List**: Your stuff
+2. **Luke Smith's List**: https://github.com/LukeSmithxyz/etc/blob/master/ips
+3. **4skinskywalker's List:** https://github.com/4skinSkywalker/Anti-Porn-HOSTS-File
+4. **columndeeply's List**: https://github.com/columndeeply/hosts
+5. **dan.me.uk's List**: https://www.dan.me.uk/torlist/?full
+
+### 🟩 Functions:
+
+```shell
+sulist merge list.com                   <-- merge another list at the end of the file
+sulist remove list.com                  <-- remove a list from the file 
+```
+
+### 🟩 Info:
+
+If you do not want the software and just want to use the blocklistgo ahead with:
+
+#### Linux:
+
+```bash
+sudo cat hosts >> /etc/hosts
+```
+
+#### Windows:
+
+Place the domains in `C:\Windows\System32\drivers\etc\hosts`.
+
+#### Android:
+1. Activate `USB debugging` and `Rooted debugging` on your phone
+2. Install `adb` on your computer:
+
+   ```
+   sudo pacman -S adb
+   ```
+3. Plug phone into computer.
+4. Run these commands:
+   ```
+   adb root
+   adb remount
+   adb push /etc/hosts /system/etc
+   ```
+
+### 🟦 License: MIT