.
diff --git a/README.md b/README.md
new file mode 100755
index 000000000..94b4c9408
--- /dev/null
+++ b/README.md
@@ -0,0 +1,89 @@
+
+
【 end_4's Hyprland dotfiles 】
+
+
+
+
+
+
+
+[](https://github.com/end-4/hyprland)
+
+
+
+
+
+# ✨ Cool stuff
+
+ Notable features
+
+ - **Overview widget** that shows open apps. Conveniently packed with app search/calculator/command runner
+ - **ChatGPT widget** (illogical-impulse branch)
+ - **Autogenerated colors** based on your wallpaper using [Material colors](https://m3.material.io/styles/color/the-color-system/key-colors-tones)
+ - **Animations**, a lot
+
+
+ Bragging
+
+ - summer-themed `hybrid` branch (note: now actually in `archive` branch): winner of Hyprland ricing competition Summer 2023, now shown in the [Hyprland repo](https://github.com/hyprwm/hyprland#gallery) and [Hyprland Wiki](https://wiki.hyprland.org/Configuring/Example-configurations/)
+ - `windoes` branch (note: also in `archive` branch now): is a "Tasty rice" [on r/unixporn](https://www.reddit.com/r/unixporn/comments/13zdhqd/hyprland_windows_rice_with_too_much_eww_with_blur/)
+
+
+# 👀 Styles & installation
+
+- For **installation instructions**, check the branch readme and the [wiki](https://github.com/end-4/dots-hyprland/wiki).
+
+### [illogical_impulse](https://github.com/end-4/dots-hyprland/tree/illogical-impulse)
+
+
+
+
+
+
+> [!WARNING]
+> - Only the above is maintained
+> - Stuff below:
+> - Currently, they do NOT work (see [#99](https://github.com/end-4/dots-hyprland/issues/99))
+> - The pics are here mainly for your viewing pleasure
+> - The files are still available, feel free to grab them from [`archive`](https://github.com/end-4/dots-hyprland/tree/archive) branch if you're willing to see some spaghetti and troubleshoot
+
+- stuff below have showcase videos. click image to view.
+
+### [m3ww](https://github.com/end-4/dots-hyprland/tree/archive)
+
+
+
+
+### [NovelKnock](https://github.com/end-4/dots-hyprland/tree/archive)
+
+
+
+
+### [Hybrid](https://github.com/end-4/dots-hyprland/tree/archive)
+
+
+
+
+### [Windoes](https://github.com/end-4/dots-hyprland/tree/archive)
+
+
+
+
+- For even older stuff I never wanna touch again, check the releases
+
+---
+
+# 🙏 Attribution
+ - AGS: [Aylur's config](https://github.com/Aylur/dotfiles)
+ - EWW: [fufexan's config](https://github.com/fufexan/dotfiles) (he thanks more people there btw)
+ - AI bots for providing useful examples
+ - Open source contributors for their software and ricers for their insipration (would be a too long list to put here!)
+
+# 🌟 stonks
+- _thank you_
+
+[](https://starchart.cc/end-4/dots-hyprland)
+
+# 💡 Some inspirations
+ - osu!lazer, Windows 11, Material Design 3, AvdanOS (concept)
+
diff --git a/YOU_SHOULD_NOT_USE_THIS_BRANCH.sh b/YOU_SHOULD_NOT_USE_THIS_BRANCH.sh
new file mode 100755
index 000000000..c7863b527
--- /dev/null
+++ b/YOU_SHOULD_NOT_USE_THIS_BRANCH.sh
@@ -0,0 +1,2 @@
+#!/usr/bin/env bash
+echo 'Use another branch, as said in the readme'